Guia de início rápido: criar uma instância do Cloud Run

Guia de início rápido: criar uma instância do Cloud Run

Prévia : instâncias do Cloud Run

Este recurso está sujeito aos Termos das Soluções Pré-GA na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Nesta página, mostramos como usar o Cloud Run para criar uma instância do Cloud Run em um contêiner de amostra, visualizar os registros e gerenciar o ciclo de vida dela usando a CLI gcloud.

Antes de começar

1. Instale a Google Cloud CLI.

   Observação: se você já tiver instalado a CLI gcloud, execute gcloud components update para verificar se você tem a versão mais recente.

2. Configure a CLI gcloud para usar sua identidade federada.

   Para mais informações, consulte Fazer login na CLI gcloud com sua identidade federada.

3. Para inicializar a CLI gcloud, execute o seguinte comando:

   gcloud init

4. Crie ou selecione um Google Cloud projeto.

   Funções necessárias para selecionar ou criar um projeto

   • Selecionar um projeto: a seleção de um projeto não exige um papel específico do IAM. Você pode selecionar qualquer projeto em que tenha recebido um papel.
   • Criar um projeto: para criar um projeto, você precisa do papel Criador de projetos (roles/resourcemanager.projectCreator), que contém a resourcemanager.projects.create permissão. Saiba como conceder papéis.
   Observação: se você não pretende manter os recursos criados neste procedimento, crie um projeto novo em vez de selecionar um que já existe. Depois de concluir essas etapas, é possível excluir o projeto. Para fazer isso, basta remover todos os recursos associados a ele.

   • Crie um Google Cloud projeto do:

     gcloud projects create PROJECT_ID

     Substitua PROJECT_ID por um nome para o Google Cloud projeto do que você está criando.

   • Selecione o Google Cloud projeto do que você criou:

     gcloud config set project PROJECT_ID

     Substitua PROJECT_ID pelo nome do Google Cloud projeto do.

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

6. Verifique se o faturamento está ativado para o Google Cloud projeto.

7. Ative a API Cloud Run Admin e as APIs Cloud Logging:

   Funções necessárias para ativar APIs

   Para ativar as APIs, é necessário ter a permissão serviceusage.services.enable. Se você criou o projeto, provavelmente já tem essa permissão pelo papel Proprietário (roles/owner). Caso contrário, você pode receber essa permissão pelo papel Administrador de uso do serviço (roles/serviceusage.serviceUsageAdmin). Saiba como conceder papéis.

   gcloud services enable run.googleapis.com logging.googleapis.com

8. Para definir o projeto padrão da instância do Cloud Run:

   gcloud config set project PROJECT_ID

   Substitua PROJECT_ID pelo nome do projeto que você criou para este guia de início rápido.
9. Verifique se o componente gcloud beta está instalado:

   gcloud components install beta

10. Consulte os preços do Cloud Run ou estime os custos com a calculadora de preços.

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:

• Administrador do Cloud Run (roles/run.admin) na instância
• Usuário da conta de serviço (roles/iam.serviceAccountUser) na identidade do serviço
• Leitor de registros (roles/logging.viewer) no projeto

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 com papéis personalizados ou outros papéis predefinidos.

Criar uma instância

Para criar uma instância do Cloud Run em um contêiner de amostra usando a CLI gcloud:

1. Execute este comando:

   gcloud beta run instances create my-instance \
   --image us-docker.pkg.dev/cloudrun/container/hello \
   --region REGION \
   --port 8080 \
   --no-invoker-iam-check

   Substitua REGION por uma região com suporte Google Cloud .

   A flag --no-invoker-iam-check desativa a autenticação do invocador do IAM, tornando o URL da instância acessível sem autenticação do IAM.

2. Aguarde a conclusão da criação da instância. Após a conclusão, o comando mostra uma saída semelhante a esta:

   Creating instance...
   Importing container..............done
   Provisioning resources.......done
   Starting instance.....done
   Done.
   Instance [my-instance] has successfully been created.
   
   URL: https://my-instance-PROJECT-NUMBER.REGION.run.app
   

3. Abra o URL retornado no navegador para interagir com o contêiner em execução.

Ver registros de instância

Para visualizar os registros gerados pela instância do Cloud Run:

1. No Google Cloud console do, acesse o Explorador de registros:

   Acessar o Explorador de registros

2. Filtre os registros da sua instância específica:

   resource.type="cloud_run_instance"
   resource.labels.location="<var>REGION</var>"
   resource.labels.instance_name="my-instance"
   

Limpar

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

Excluir a instância

Para interromper e excluir a instância do Cloud Run:

gcloud beta run instances delete my-instance --region REGION

Excluir o projeto de teste

A exclusão do seu Google Cloud projeto interrompe o faturamento de todos os recursos nesse projeto. Para liberar todos os Google Cloud recursos do projeto, siga estas etapas:

Cuidado: excluir um projeto tem os seguintes efeitos:
• Tudo no projeto é excluído. Se você tiver usado um projeto atual para as tarefas neste documento, a exclusão dele incluirá a exclusão de quaisquer outros trabalhos feitos nele.
• Os IDs do projeto personalizados são perdidos. Ao criar o projeto, você pode ter criado um ID do projeto personalizado para ser usado no futuro. Para preservar os URLs que usam o ID do projeto, como um appspot.com URL, exclua recursos específicos do projeto, em vez de excluir o projeto inteiro.

Excluir um Google Cloud projeto do:

gcloud projects delete PROJECT_ID

A seguir

Para mais informações sobre instâncias do Cloud Run, consulte:

• Criar e gerenciar instâncias do Cloud Run
• Ciclo de vida da instância do Cloud Run