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

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

Este documento mostra-lhe como começar a usar o Cloud Code.

Vai criar um serviço a partir de uma aplicação de exemplo "Olá, mundo", implementar o seu serviço publicamente com o Cloud Code e ver o estado dos recursos do seu serviço em direto.

Antes de começar

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.

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 role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Se estiver a usar um projeto existente para este guia, verifique se tem as autorizações necessárias para concluir este guia. Se criou um novo projeto, já tem as autorizações necessárias.

Verify that billing is enabled for your Google Cloud project.

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

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 role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Se estiver a usar um projeto existente para este guia, verifique se tem as autorizações necessárias para concluir este guia. Se criou um novo projeto, já tem as autorizações necessárias.

Verify that billing is enabled for your Google Cloud project.

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

1. Instale o Git. O Git é necessário para copiar exemplos para o seu computador.
2. Instale o Docker. O Docker é necessário para criar o código de exemplo. Certifique-se de que a sua conta de utilizador local consegue criar contentores.
3. Instale o plug-in Cloud Code se ainda não o fez.

Funções necessárias

Para receber as autorizações de que precisa para concluir este início rápido, peça ao seu administrador que lhe conceda as seguintes funções de IAM no projeto:

• Administrador do Cloud Run (roles/run.admin)
• Cloud Run Builder (roles/run.builder)
• Visualizador de registos (roles/logging.viewer)
• Utilizador da conta de serviço (roles/iam.serviceAccountUser)

Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

Crie um serviço

Para criar uma aplicação de serviços de exemplo, siga estes passos:

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

   

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

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

4. Na lista de aplicações de exemplo, selecione uma para o seu idioma preferido.

   Por exemplo, escolher Node.js: Cloud Run cria uma aplicação de serviço "Olá, mundo" em Node.js.

5. Confirme a localização do sistema de ficheiros do código fonte do seu serviço (ou modifique-o, se necessário) e clique em Criar nova aplicação.

   É apresentada uma pré-visualização do ficheiro README.md para o 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 serviço em execução, abra o URL apresentado na parte superior da caixa de diálogo Implementar no Cloud Run.

Veja 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.
2. Expanda a secção Cloud Run para ver o seu serviço do Cloud Run.
3. Clique no serviço para ver as respetivas propriedades.

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.
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.

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. Escreva 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á a ser usado, 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?

• Descubra o apoio técnico de depuração específico do idioma que o Cloud Code oferece.
• Personalize a sua experiência do Cloud Code configurando as definições relevantes.
• Experimente criar e executar uma aplicação Kubernetes com o Cloud Code.