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

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

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

Você vai criar um serviço com base em um aplicativo de amostra "Hello, world", implantar seu serviço publicamente com o Cloud Code e conferir o status dos recursos do serviço ativo.

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 este guia estiver usando um projeto atual, verifique se você tem as permissões necessárias para concluir o guia. Se você criou um projeto, já tem as permissõ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 este guia estiver usando um projeto atual, verifique se você tem as permissões necessárias para concluir o guia. Se você criou um projeto, já tem as permissõ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 amostras na sua máquina.
2. Instale o Docker. O Docker é necessário para criar o exemplo de código. Verifique se a conta de usuário local consegue criar contêineres.
3. Instale o plug-in do Cloud Code se ainda não tiver feito isso.

Funções exigidas

Para conseguir as permissões necessárias a fim de concluir o guia de início rápido, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:

• Administrador do Cloud Run (roles/run.admin)
• Criador do Cloud Run (roles/run.builder)
• Visualizador de registros (roles/logging.viewer)
• Usuário da conta de serviço (roles/iam.serviceAccountUser)

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

Criar um serviço

Para criar um aplicativo de serviço de amostra, siga estas etapas:

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

   

2. No menu de escolha rápida que aparece, selecione Novo aplicativo.

3. Selecione Aplicativo do Cloud Run como o tipo de aplicativo.

4. Na lista de aplicativos de exemplo, selecione um para seu idioma preferido.

   Por exemplo, escolher Node.js: Cloud Run cria um aplicativo de serviço "Hello, world" em Node.js.

5. Confirme o local do sistema de arquivos do código-fonte do seu serviço (ou modifique-o, se necessário) e clique em Criar novo aplicativo.

   Uma prévia do arquivo README.md do serviço selecionado será aberta no VS Code.

Implantar no Cloud Run

Para implantar o serviço no Cloud Run, siga estas etapas:

1. Abra a paleta de comandos (pressione Ctrl/Cmd+Shift+P ou clique em Visualizar > Paleta de comandos) e execute o comando Deploy to Cloud Run.

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

3. Aceite as outras configurações padrão e clique em Implantar.

   Em seguida, o Cloud Code cria sua imagem, envia para o registro e implanta o serviço no Cloud Run.

4. Para visualizar o serviço em execução, abra o URL exibido na parte de cima da caixa de diálogo Implantar no Cloud Run.

Ver o status do recurso

É possível ver o status dos serviços do Cloud Run usando o navegador de serviços do Cloud Run:

1. Clique em Cloud Code na barra de atividades do VS Code.
2. Expanda a seção Cloud Run para ver seu serviço do Cloud Run.
3. Clique no serviço para ver as propriedades dele.

Como visualizar registros

Também é possível ver os registros do serviço implantado com o Visualizador de registros fornecido com o Cloud Code.

Para ver os registros, siga estas etapas:

1. Clique em Cloud Code na barra de atividades do VS Code.
2. Expanda a seção Cloud Run para ver seu serviço do Cloud Run.
3. Clique com o botão direito do mouse no serviço do Cloud Run e clique em Ver registros.

Limpar

Para excluir seu projeto:

1. Acesse a página Projetos no console do Google Cloud :

   Acessar a página "Projetos"

2. Selecione o projeto que você criou para este guia de início rápido e clique em Excluir.

3. Digite o ID do projeto para confirmar e clique em Encerrar.

   Isso encerrará o projeto e programará a remoção dele.

Se você estiver usando um projeto preexistente e quiser excluir os recursos criados para este guia de início rápido:

• Imagem do contêiner:embora o Cloud Run não cobre quando o serviço não está em uso, você pode ser cobrado pelo armazenamento da imagem do contêiner no Artifact Registry. Para saber as etapas de exclusão da sua imagem, consulte Como excluir imagens.

• Serviço do Cloud Run:para excluir um serviço do Cloud Run, acesse o Cloud Run noGoogle Cloud console usando o menu de navegação. Selecione o serviço que você quer excluir e clique em Excluir.

A seguir

• Descubra o suporte de depuração específico do idioma fornecido pelo Cloud Code.
• Personalize sua experiência com o Cloud Code definindo as configurações relevantes.
• Tente criar e executar um aplicativo do Kubernetes com o Cloud Code.