Implemente um serviço do Cloud Run com o Cloud Code para VS Code

Esta página mostra-lhe como começar rapidamente a usar o Cloud Code.

Vai configurar um serviço Hello World que é executado no Cloud Run através de uma aplicação de exemplo, implementar o seu serviço no Cloud Run e ver o estado dos recursos do seu serviço em direto.

Antes de começar

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Cloud Run API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Cloud Run API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

  8. Instale o Git. O Git é necessário para copiar exemplos para o seu computador.
  9. Instale o plug-in Cloud Code se ainda não o fez.

Criar um serviço

  1. Na barra de estado do Cloud Code, clique no nome do projeto ativo.

    Nome do projeto ativo na barra de estado

  2. No menu de seleção rápida apresentado, selecione Nova aplicação.

  3. Escolha Aplicação do Cloud Run como o tipo de aplicação preferido.

  4. Na lista de aplicações de exemplo (Node.js, Python com frameworks Flask e Django, Java, Go), escolha um serviço Hello World.

    Por exemplo, escolher Node.js: Hello World cria um serviço Hello World do Node.js.

  5. Confirme a localização do serviço no disco (ou modifique-a, se necessário) e clique em Criar nova aplicação.

    É aberta uma pré-visualização do ficheiro README do serviço selecionado no VS Code.

Implemente no Cloud Run

Para implementar o seu serviço no Cloud Run, siga estes passos:

  1. Abra a paleta de comandos (prima Ctrl/Cmd+Shift+P ou clique em Ver > Paleta de comandos) e, de seguida, execute o comando Implementar no Cloud Run.

  2. No painel Implementar no Cloud Run, defina o seu Google Cloud projeto.

  3. Aceite as restantes predefinições e, de seguida, clique em Implementar.

    O Cloud Code cria a sua imagem, envia-a para o registo e implementa o seu serviço no Cloud Run.

  4. Para ver o seu serviço em execução, abra o URL apresentado na parte superior da caixa de diálogo Implementar no Cloud Run.

Ver registos

Também pode ver registos do seu serviço implementado com o visualizador de registos fornecido com o Cloud Code.

Para ver os registos, siga estes passos:

  1. Clique em Cloud Code na barra de atividade do VS Code no lado esquerdo.
  2. Expanda a secção Cloud Run para ver o seu serviço do Cloud Run.
  3. Clique com o botão direito do rato no seu serviço do Cloud Run e, de seguida, clique em Ver registos.

Visualizar o estado do recurso

Pode ver o estado dos seus serviços do Cloud Run através do navegador de serviços do Cloud Run:

  1. Clique em Cloud Code na barra de atividade do VS Code no lado esquerdo.
  2. Expanda a secção Cloud Run para ver o seu serviço do Cloud Run.
  3. Clique no serviço do Cloud Run sobre o qual quer saber mais. As propriedades do serviço são apresentadas na janela abaixo.

Limpar

Para eliminar o projeto:

  1. Aceda à página Projetos na Google Cloud consola:

    Aceda à página Projetos

  2. Selecione o projeto que criou para este início rápido e, de seguida, clique em Eliminar.

  3. Introduza o ID do projeto para confirmar e, de seguida, clique em Encerrar.

    Esta ação encerra o projeto e agenda a sua eliminação.

Se estiver a usar um projeto pré-existente e quiser eliminar os recursos que criou para este início rápido:

  • Imagem do contentor: embora o Cloud Run não cobre quando o serviço não está em utilização, pode ser-lhe cobrado o armazenamento da imagem do contentor no Artifact Registry. Para ver os passos para eliminar a sua imagem, consulte o artigo Eliminar imagens.

  • Serviço do Cloud Run: para eliminar um serviço do Cloud Run, navegue até ao Cloud Run naGoogle Cloud consola através do menu de navegação. Selecione o serviço que quer eliminar e, de seguida, clique em Eliminar.

O que se segue?