Opções de implantação para serviços do Cloud Run

Conforme descrito nos tipos de implantação e no modelo de recursos do Cloud Run, o Cloud Run oferece várias opções e métodos de implantação. Esta página oferece uma visão geral dos diferentes tipos de implantação e de algumas das ferramentas e interfaces que podem ser usadas para implantações de serviços do Cloud Run.

Tipos de implantação

Ao implantar em um serviço do Cloud Run, é possível escolher entre as seguintes opções:

Implantar contêineres

Para implantar no Cloud Run usando uma imagem de contêiner, é necessário empacotar o código do aplicativo e as dependências em um registro de contêiner e executar a implantação.

Implantar a partir do código-fonte

É possível implantar o código diretamente de um diretório ou repositório local sem criar imagens de contêiner manualmente.

  • Implantar serviços do código-fonte: Use gcloud run deploy --source para empacotar o código-fonte. É possível implantar com o Cloud Build usando os buildpacks do Google Cloud (padrão) ou ignorar a etapa do Cloud Build para implantar artefatos pré-criados diretamente (visualização) para uma implantação mais rápida.
  • Implantar uma função do Cloud Run: implante snippets de código de propósito único que são acionados em resposta a Google Cloud eventos, como eventos do Eventarc. As funções usam os buildpacks do Google Cloud e o Cloud Build para construir e implantar a imagem de contêiner.
  • Se você precisar empacotar seu código, dependências e bibliotecas do sistema em um contêiner, consulte as páginas a seguir antes de implantar no Cloud Run:

Implantação contínua do git

Para configurar o Cloud Run para criar e implantar novas revisões quando você enviar mudanças para o repositório, consulte Implantar continuamente de um repositório.

É possível conectar seu repositório do GitHub, GitLab ou Bitbucket diretamente no Google Cloud console usando gatilhos do Cloud Build ou o Developer Connect.

Métodos e ferramentas de implantação

É possível usar qualquer um dos seguintes métodos e interfaces principais para implantar um serviço do Cloud Run:

  • Google Cloud console: use a interface gráfica interativa do usuário em no Google Cloud console para implantar imagens e funções de contêiner ou configurar a implantação contínua manualmente. O Google Cloud console fornece dicas de ferramentas, formulários e feedback imediato ao configurar as definições de configuração.
  • Google Cloud CLI: use o comando gcloud run deploy para ativar a criação de scripts e implantações rápidas de imagens de contêiner na linha de comando. Esse método funciona bem para a maioria dos tipos de implantação e é conveniente para criar e implantar o código-fonte local usando um único comando.
  • YAML: use o arquivo YAML do serviço do Cloud Run para manifestar as especificações do serviço em arquivos de configuração declarativa compatíveis com o Knative. Em seguida, aplique as mudanças usando gcloud run services replace service.yaml. Essa abordagem permite um modelo de implantação contínua do GitOps em que a configuração reside no repositório como a fonte da verdade.
  • Terraform: use o recurso do provedor padrão Google Cloud (google_cloud_run_v2_service) para implantar e atualizar a infraestrutura de computação sem servidor de maneira determinística, além de outros recursos de nuvem, como bancos de dados, balanceadores de carga e políticas de segurança.
  • Bibliotecas de cliente: use as bibliotecas de cliente do Cloud para linguagens como Go, Java, Node.js, Python, Ruby, PHP e .NET para configurar e acionar implantações de maneira programática.
  • API REST: invoque diretamente o endpoint de API usando operações HTTP para integrar com sistemas de implantação personalizados.
  • Implantar serviços usando o Compose: Defina a pilha de aplicativos com vários contêineres (como serviços de back-end ou sidecars) usando um arquivo compose.yaml padrão e implante-os juntos no Cloud Run usando o comando gcloud run deploy --compose.
  • Usar o servidor MCP remoto: conecte seus assistentes de IA generativa e agentes de código a um servidor do Protocolo de Contexto de Modelo (MCP, na sigla em inglês) remoto para que eles possam implantar, inspecionar ou gerenciar seus serviços públicos e privados do Cloud Run.
  • Visualizações de implantação: Automatize o processo de implantação usando o Cloud Build.