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

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 dela e gerenciar o ciclo de vida usando a CLI gcloud.

Antes de começar

  1. Instale a CLI do Google Cloud.

  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 Cloud de Confiance projeto.

    Papéis necessários para selecionar ou criar um projeto

    • Selecionar um projeto: não é necessário um papel específico do IAM para selecionar um projeto. Você pode escolher qualquer projeto em que tenha recebido um papel.
    • Criar um projeto: para criar um projeto, é necessário ter o papel de Criador de projetos (roles/resourcemanager.projectCreator), que contém a permissão resourcemanager.projects.create. Saiba como conceder papéis.

    • Crie um projeto do Cloud de Confiance :

      gcloud projects create PROJECT_ID

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

    • Selecione o projeto Cloud de Confiance que você criou:

      gcloud config set project PROJECT_ID

      Substitua PROJECT_ID pelo nome do projeto do Cloud de Confiance .

  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 projeto do Cloud de Confiance .

  7. Ative a API Cloud Run Admin e API Cloud Logging, se ainda não estiverem ativadas:

    Funções necessárias para ativar APIs

    Para ativar APIs, você precisa da permissão serviceusage.services.enable. Se você criou o projeto, provavelmente já tem essa permissão pelo papel de proprietário (roles/owner). Caso contrário, é possível conseguir essa permissão pelo papel de administrador do Service Usage (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 faça uma estimativa de 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:

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 uma instância

Para criar uma instância do Cloud Run em um contêiner de exemplo 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 Cloud de Confiance região compatível.

    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 exibe uma saída semelhante a:

    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 ver os registros gerados pela sua instância do Cloud Run:

  1. No console do Cloud de Confiance , acesse a Análise de registros:

    Acessar a Análise 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 Cloud de Confiance by S3NS 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 projeto do Cloud de Confiance interrompe o faturamento de todos os recursos dele. Para liberar todos os recursos do Cloud de Confiance by S3NS no seu projeto, siga estas etapas:

    Excluir um projeto do Cloud de Confiance :

    gcloud projects delete PROJECT_ID

A seguir

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