Implantar um app do Cloud Run usando o Cloud Shell

Implantar um app do Cloud Run usando o Cloud Shell

Saiba como configurar e implantar um aplicativo de amostra Hello World no Cloud Run e visualizar o status dos recursos do serviço ativo.

Antes de começar

Faça login na sua conta do Google Cloud . Se você começou a usar o Google Cloud, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.

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

Verify that billing is enabled for your Google Cloud project.

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

Verify that billing is enabled for your Google Cloud project.

Funções exigidas

Para receber as permissões necessárias para implantar um app do Cloud Run, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:

• Administrador do Cloud Run (roles/run.admin)
• Desenvolvedor de origem do Cloud Run (roles/run.sourceDeveloper)
• Usuário da conta de serviço (roles/iam.serviceAccountUser)
• Administrador do Service Usage (roles/serviceusage.serviceUsageAdmin)
• Administrador de projetos do IAM (roles/resourcemanager.projectIamAdmin)
• Visualizador de registros (roles/logging.viewer)

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.

Conceder acesso à conta de serviço do Cloud Build ao seu projeto

Por padrão, o Cloud Build usa a conta de serviço padrão do Compute Engine como a conta de serviço padrão do Cloud Build para criar seu código-fonte e o recurso do Cloud Run, a menos que você substitua esse comportamento.

Para que o Cloud Build crie suas origens, conceda à conta de serviço do Cloud Build o papel Builder do Cloud Run (roles/run.builder) no seu projeto:

gcloud projects add-iam-policy-binding PROJECT_ID \
    --member=serviceAccount:SERVICE_ACCOUNT_EMAIL_ADDRESS \
    --role=roles/run.builder

Substitua PROJECT_ID pelo ID do projeto Google Cloude SERVICE_ACCOUNT_EMAIL_ADDRESS pelo endereço de e-mail da conta de serviço do Cloud Build. Se você estiver usando a conta de serviço padrão do Compute Engine como a conta de serviço do Cloud Build, use o seguinte formato para o endereço de e-mail da conta de serviço:

[e-mail]

Substitua PROJECT_NUMBER pelo número do projeto do Google Cloud.

Para instruções detalhadas sobre como encontrar o ID do projeto e o número do projeto, consulte Criar e gerenciar projetos.

A concessão da função de builder do Cloud Run leva alguns minutos para se propagar.

Criar um aplicativo

1. Inicie o editor do Cloud Shell
2. Na barra de status do Cloud Code, selecione Novo aplicativo.
3. Selecione "Aplicativo do Cloud Run" como seu tipo de aplicativo preferido.

4. Na lista de aplicativos de amostra (Node.js, Python com frameworks Flask e Django, Java, Go), escolha um aplicativo Hello World.

   Por exemplo, escolher Python (Flask): Hello World cria um aplicativo Hello World em Python (Flask).

5. Selecione uma pasta como o local do aplicativo e clique em Criar novo aplicativo.

   O editor do Cloud Shell carrega o aplicativo em um novo espaço de trabalho. Depois que o espaço de trabalho for carregado, o app poderá ser acessado na visualização de explorador.

Implantar no Cloud Run

Para implantar o aplicativo 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. Isso abre a interface do Cloud Run: implantar.
2. Se necessário, autorize o Cloud Code a fazer chamadas de API do Google Cloud .
3. Defina o projeto do Google Cloud .
4. Se solicitado, ative a API Cloud Run clicando em Ativar APIs.
5. Na caixa de diálogo Implantar para o Cloud Run, selecione um serviço atual ou crie um novo.
6. Se você estiver criando um novo serviço, selecione "Cloud Run (totalmente gerenciado)" em "Plataforma de implantação".
7. Escolha uma região para implantar.
8. Em Autenticação, selecione Permitir invocações não autenticadas para tornar este serviço público.

9. Depois de definir suas configurações preferidas, clique em Implantar.

   Em seguida, o Cloud Code cria sua imagem, envia para o registro e implanta o aplicativo no Cloud Run. Seu serviço está ativo!

10. Veja o serviço em execução seguindo o URL exibido na caixa de diálogo "Cloud Run: Implantar".

Editar o serviço

Para editar o aplicativo, siga estas instruções:

1. Com a visualização do Explorer, encontre o arquivo app.py que implementa o comportamento do serviço.
2. Modifique a mensagem "está em execução!" para a mensagem que escolher.
3. Depois de fazer essa alteração, escolha o comando Implantar no Cloud Run usando a paleta de comandos.
4. Verifique se o serviço que você acabou de criar está selecionado em "Configurações do serviço".
5. Clique em Deploy.
6. Depois que o aplicativo terminar de ser criado e implantado, será possível atualizar o serviço para ver a mensagem atualizada.

Como visualizar registros

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

Para ver os registros, siga estas etapas:

1. Clique em Cloud Code e expanda a seção Cloud Run.

2. Clique com o botão direito do mouse no serviço do Cloud Run e clique em Ver registros.

3. Atualize o aplicativo no navegador e veja os novos registros gerados clicando no botão de atualização de registros.

Limpar

Para evitar cobranças na conta do Google Cloud pelos recursos usados nesta página, siga as etapas abaixo.

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.

   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:o Cloud Run não cobra quando um serviço não está em uso, mas ainda é possível ser cobrado pelo armazenamento da imagem do contêiner no Artifact Registry. Para excluir a imagem, abra a página do Artifact Registry, selecione o repositório que contém a imagem, selecione a imagem, clique em Excluir e clique em Excluir.

  Abrir a página do Artifact Registry

• Serviço do Cloud Run:para excluir um serviço do Cloud Run, na página do Cloud Run no consoleGoogle Cloud , selecione o serviço que você quer excluir, clique em Excluir e, em seguida, clique em Excluir.

  Abrir a página "Cloud Run"

A seguir

• Descubra a variedade de recursos que a interface do editor do Cloud Shell tem a oferecer.
• Saiba como configurar o Cloud Shell para personalizar sua experiência.