Configurar um serviço do Cloud Run

No Application Design Center, é possível configurar um serviço do Cloud Run para executar contêineres sem estado diretamente na infraestrutura escalonável e totalmente gerenciada do Google. É possível personalizar o serviço para suas conexões de componentes e parâmetros de configuração específicos. Os parâmetros de configuração estão listados no módulo do Terraform terraform-google-cloud-run no GitHub.

Conexões de componentes

A tabela a seguir inclui os componentes que podem ser conectados a um serviço do Cloud Run e as atualizações resultantes no aplicativo e no código do Terraform gerado.

Componente conectado Atualizações de aplicativos Informações prévias
Secret Manager
  • O serviço do Cloud Run pode referenciar os dados do secret.
  • O campo Dados do Secret do Secret Manager é referenciado pelo campo env_secret_vars do Cloud Run.
  • O papel roles/secretmanager.secretAccessor é concedido à conta de serviço do Cloud Run.
Configurar secrets para serviços

Conta de serviço

  • O serviço do Cloud Run usa a conta de serviço como uma identidade de serviço.
  • O papel roles/run.invoker é concedido à conta de serviço.
  • O e-mail da conta de serviço e as informações do Identity and Access Management (IAM) são adicionados às variáveis de ambiente do Cloud Run.
Como autenticar entre serviços
AlloyDB para PostgreSQL
  • O serviço do Cloud Run pode se conectar à instância do AlloyDB.
  • Os metadados do recurso do AlloyDB são adicionados às variáveis de ambiente do Cloud Run.
  • O papel roles/alloydb.admin é concedido à conta de serviço do Cloud Run.
Conectar a partir do Cloud Run
BigQuery
  • O serviço do Cloud Run pode interagir com o conjunto de dados do BigQuery.
  • Os metadados do recurso do BigQuery são adicionados às variáveis de ambiente do Cloud Run.
  • O papel roles/bigquery.dataEditor é concedido à conta de serviço do Cloud Run.
Informações gerais do BigQuery

Bigtable

  • O serviço do Cloud Run pode executar funções administrativas na instância do Bigtable.
  • As informações de metadados do recurso do Bigtable são adicionadas às variáveis de ambiente do Cloud Run.
  • O papel roles/bigtable.admin é concedido à conta de serviço do Cloud Run.
Visão geral do Bigtable

Outro serviço do Cloud Run

  • O serviço de origem do Cloud Run pode enviar tráfego para o serviço de destino do Cloud Run.
  • O serviço de origem do Cloud Run contém o URI do serviço de destino do Cloud Run nas variáveis de ambiente.
O que é o Cloud Run

Cloud SQL (MySQL)

  • O serviço do Cloud Run pode ler e gravar dados na instância do Cloud SQL (MySQL).
  • Os metadados de conexão do Cloud SQL são adicionados ao serviço do Cloud Run.
  • Os papéis roles/cloudsql.instanceUser e roles/cloudsql.client são concedidos à conta de serviço do Cloud Run.
  • A conta de serviço do Cloud Run é adicionada como um usuário do IAM à instância do Cloud SQL.
Conectar a partir do Cloud Run

Cloud SQL (PostgreSQL)

  • O serviço do Cloud Run pode ler e gravar dados na instância do Cloud SQL (PostgreSQL).
  • Os metadados de conexão do Cloud SQL são adicionados ao serviço do Cloud Run.
  • Os papéis roles/cloudsql.instanceUser e roles/cloudsql.client são concedidos à conta de serviço do Cloud Run.
  • A conta de serviço do Cloud Run é adicionada como um usuário do IAM à instância do Cloud SQL.
Conectar a partir do Cloud Run

Cloud Storage

  • O serviço do Cloud Run pode gerenciar objetos no bucket do Cloud Storage.
  • As informações do IAM da conta de serviço do Cloud Run são adicionadas ao bucket do Cloud Storage.
  • O papel roles/storage.objectAdmin é concedido à conta de serviço do Cloud Run.
Conectar-se aos serviços do Google Cloud

Back-end global do Cloud Load Balancing

  • O balanceador de carga pode distribuir o tráfego de entrada para o serviço do Cloud Run.
  • O serviço do Cloud Run é adicionado como um endpoint de back-end na configuração de back-ends de NEG sem servidor do Cloud Load Balancing.
Configurar um balanceador de carga de aplicativo externo global com o Cloud Run

Memorystore for Redis

  • O serviço do Cloud Run pode armazenar dados em cache na instância do Memorystore for Redis.
  • As informações de conexão do Memorystore for Redis são adicionadas às variáveis de ambiente do Cloud Run.
  • O papel roles/redis.editor é concedido à conta de serviço do Cloud Run.
Como se conectar a uma instância do Redis a partir de um serviço do Cloud Run

Memorystore for Redis Cluster

  • O serviço do Cloud Run pode armazenar dados em cache na instância do Memorystore for Redis Cluster.
  • As informações de conexão do Memorystore for Redis Cluster são adicionadas às variáveis de ambiente do Cloud Run.
  • O App Design Center concede o papel roles/redis.dbConnectionUser à conta de serviço do Cloud Run.
Conectar-se a uma instância do Memorystore for Redis Cluster

Memorystore for Valkey

  • O serviço do Cloud Run pode armazenar dados em cache na instância do Memorystore for Valkey.
  • O App Design Center adiciona as informações de conexão do Memorystore for Valkey às variáveis de ambiente do Cloud Run.
  • O App Design Center concede o papel roles/memorystore.dbConnectionUser à conta de serviço do Cloud Run.
Conectar-se a uma instância do Memorystore for Valkey

Pub/Sub

  • O serviço do Cloud Run pode receber mensagens ou publicar no tópico do Pub/Sub.
  • O ID do tópico do Pub/Sub é adicionado às variáveis de ambiente do Cloud Run.
  • Os papéis roles/pubsub.publisher e roles/pubsub.subscriber são concedidos à conta de serviço do Cloud Run.
  • O serviço do Cloud Run é adicionado aos campos de assinatura de push e assinatura por pull do Pub/Sub.
Tutorial Usar o Pub/Sub com o Cloud Run

Back-end regional do Cloud Load Balancing

  • O balanceador de carga pode distribuir o tráfego de entrada para o serviço do Cloud Run.
  • O serviço do Cloud Run é adicionado como um endpoint de back-end na configuração de back-ends de NEG sem servidor do Cloud Load Balancing.
Configurar um balanceador de carga de aplicativo externo regional com o Cloud Run

Front-end regional do Cloud Load Balancing

  • Os endereços IP HTTP e HTTPS do balanceador de carga estão disponíveis para o aplicativo em execução no contêiner do Cloud Run.
  • Os metadados de endereço do Cloud Load Balancing são adicionados às variáveis de ambiente do Cloud Run.
Visão geral das regras de encaminhamento

Spanner

  • O serviço do Cloud Run pode gerenciar a instância do Spanner.
  • Os detalhes da conexão do Spanner são adicionados às variáveis de ambiente do Cloud Run.
  • O papel roles/spanner.databaseAdmin é concedido à conta de serviço do Cloud Run.
  • As informações do IAM da conta de serviço do Cloud Run são adicionadas à instância do Spanner.
Conectar-se aos serviços do Google Cloud

Vertex AI

  • O serviço do Cloud Run pode interagir com os serviços da Vertex AI.
  • O papel roles/aiplatform.user é concedido à conta de serviço do Cloud Run.
Hospedar apps e agentes de IA no Cloud Run

Parâmetros de configuração obrigatórios

Se o modelo incluir um componente do Cloud Run, configure os seguintes parâmetros antes de implantar.

Nome do parâmetro Descrição e restrições Informações prévias

ID do projeto

O projeto em que você quer implantar o recurso do Cloud Run.

Configurar componentes

Região

O local de implantação do serviço do Cloud Run.

Locais do Cloud Run

Nome do serviço

name Serviço do Cloud Run

Parâmetros de configuração opcionais

Os parâmetros a seguir são opcionais. Para exibir parâmetros avançados, na área Configuração, selecione Mostrar campos avançados.

Recurso Nome do parâmetro Descrição e informações de restrição Informações prévias
Contêineres

Nome do contêiner

name Como criar contêineres
Contêineres

Imagem do contêiner

imagem Como implantar imagens de contêiner no Cloud Run
Contêineres

Diretório de trabalho

O diretório de trabalho do contêiner. Se não for especificado, o padrão do ambiente de execução do contêiner será usado, o que pode ser configurado na imagem do contêiner.

workingDir
Contêineres

Depende do contêiner

dependsOn[] Configurar ordem de inicialização do contêiner para implantações sidecar
Contêineres

Argumentos do contêiner

args[] Configurar contêineres para serviços
Contêineres

Comando do contêiner

command Configurar contêineres para serviços
Contêineres: variáveis de ambiente

Key

name Variáveis de ambiente para serviços
Contêineres: variáveis de ambiente

Valor

value Variáveis de ambiente para serviços
Contêineres: variáveis de ambiente de secrets

Key

EnvVarSource Tornar um secret acessível ao Cloud Run
Contêineres: variáveis de ambiente de secrets

Secret

secret Tornar um secret acessível ao Cloud Run
Contêineres: variáveis de ambiente de secrets

Versão

version Tornar um secret acessível ao Cloud Run
Contêineres: montagens de volumes

Nome

name Conectar a partir do Cloud Run
Contêineres: montagens de volumes

Caminho de montagem

mountPath Conectar a partir do Cloud Run
Contêineres: portas

Nome

name Usar HTTP/2 para serviços
Contêineres: portas

Porta do contêiner

containerPort Usar HTTP/2 para serviços
Contêineres: recursos

CPU

limites Configurar limites de CPU para serviços
Contêineres: recursos

Memória

limites Configurar limites de memória para serviços
Contêineres: recursos

CPU inativa

Se a CPU é alocada apenas durante as solicitações.

cpuIdle
Contêineres: recursos

Otimização da CPU de inicialização

startupCPUBoost Definir otimização da CPU de inicialização
Contêineres: sondagem de inicialização

Limite de falha

failureThreshold Configurar verificações de integridade do contêiner para serviços
Contêineres: sondagem de inicialização

Segundos de atraso inicial

initialDelaySeconds Configurar sondagens de inicialização
Contêineres: sondagem de inicialização

Segundos de tempo limite

timeoutSeconds Configurar sondagens de inicialização
Contêineres: sondagem de inicialização

Segundos do período

periodSeconds Configurar sondagens de inicialização
Contêineres: sondagem de inicialização

Caminho HTTP Get

path Configurar sondagens de inicialização
Contêineres: sondagem de inicialização

Porta HTTP Get

port Configurar sondagens de inicialização
Contêineres: sondagem de inicialização

Nome dos cabeçalhos HTTP

name Configurar sondagens de inicialização
Contêineres: sondagem de inicialização

Valor dos cabeçalhos HTTP

value Configurar sondagens de inicialização
Contêineres: sondagem de inicialização

Porta do soquete TCP

port A sondagem de inicialização TCP padrão
Contêineres: sondagem de inicialização

Porta GRPC

port Configurar sondagens de inicialização
Contêineres: sondagem de inicialização

Serviço gRPC

serviço Configurar sondagens de inicialização
Contêineres

Sondagem de atividade

livenessProbe Casos de uso

Descrição

description Definir descrições de serviço

Criar uma conta de serviço

Crie uma nova conta de serviço para o serviço do Cloud Run.

Configurar a identidade dos serviços

Papéis do projeto da conta de serviço

Papéis a serem concedidos à conta de serviço recém-criada. Ative Criar conta de serviço e não forneça entrada para Conta de serviço.

Configurar a identidade dos serviços

Entrada

IngressTraffic Restringir a entrada de rede para o Cloud Run

Participantes

Usuários e contas de serviço que podem invocar o serviço. Para acesso público, insira allUsers. Para acesso por usuários do Google conectados, digite allAuthenticatedUsers ou uma lista de usuários e contas de serviço específicos. Para mais informações, consulte membros.

Gerenciar o acesso aos serviços
VPC Access

Conector

connector VPC com conectores
VPC Access Saída egress Controlar o tráfego do serviço de saída
Acesso VPC: interfaces de rede Rede rede Implantar um serviço
Acesso VPC: interfaces de rede Sub-rede subnetwork Implantar um serviço
Acesso VPC: interfaces de rede Tags tags Implantar um serviço

Proteção contra exclusão do Cloud Run

Impede que o Terraform destrua ou recrie jobs e serviços do Cloud Run.

deletion_protection

Ativar o arquivo secundário do Prometheus

Ative o arquivo secundário do Prometheus no serviço do Cloud Run.

Escrever métricas do Prometheus usando o arquivo secundário do Prometheus
Volumes

Nome

name Configurar um volume na memória
Volumes: Secret Secret secret Tornar um secret acessível ao Cloud Run
Volumes: Secret Modo padrão defaultMode Tornar um secret acessível ao Cloud Run
Volumes: Secret Caminho path Tornar um secret acessível ao Cloud Run
Volumes: Secret Versão version Tornar um secret acessível ao Cloud Run
Volumes: Secret Moda mode Tornar um secret acessível ao Cloud Run
Volumes: instância do Cloud SQL Instâncias instances[] Conectar a partir do Cloud Run
Volumes: Empty Dir Meio medium Configurar montagens de volumes na memória para serviços
Volumes: Empty Dir Limite de tamanho sizeLimit Configurar montagens de volumes na memória para serviços
Volumes: GCS Bucket bucket Configurar montagens de volumes do Cloud Storage para serviços
Volumes: GCS Somente leitura readOnly Configurar montagens de volumes do Cloud Storage para serviços
Volumes: NFS Servidor servidor Configurar montagens de volumes NFS para serviços
Volumes: NFS Caminho path Configurar montagens de volumes NFS para serviços
Volumes: NFS Somente leitura readOnly Configurar montagens de volumes NFS para serviços
Escalonamento de serviços

Número mínimo de instâncias

minInstanceCount Definir instâncias mínimas para serviços

Revisão

revisão Revisões de serviço do Cloud Run
Escalonamento de modelos

Número mínimo de instâncias

minInstanceCount Definir instâncias mínimas para serviços
Escalonamento de modelos Contagem máxima de instâncias maxInstanceCount Sobre o número máximo de instâncias

Chave de criptografia

encryptionKey Como usar chaves de criptografia gerenciadas pelo cliente

Simultaneidade máxima de solicitações de instância

maxInstanceRequestConcurrency Máximo de solicitações simultâneas para serviços

Afinidade da sessão

sessionAffinity Definir a afinidade da sessão para serviços

Ambiente de execução

executionEnvironment Sobre os ambientes de execução de serviço
Tráfego

Tipo

type Reversões, lançamentos graduais e migração de tráfego
Tráfego Percent percent Reversões, lançamentos graduais e migração de tráfego
Tráfego Revisão revisão Reversões, lançamentos graduais e migração de tráfego
Tráfego Tag tag Reversões, lançamentos graduais e migração de tráfego
Rótulos de serviço

Key

labels Configurar rótulos para serviços
Rótulos de serviço Valor labels Configurar rótulos para serviços
Anotações de serviço

Key

anotações anotações
Anotações de serviço Valor anotações anotações
Cliente

Nome

Identificador arbitrário do cliente de API.

cliente
Cliente Versão

Identificador arbitrário da versão do cliente de API.

clientVersion

Estágio de lançamento

LaunchStage Etapas de lançamento de produtos

Públicos-alvo personalizados

customAudience Definir públicos-alvo personalizados para serviços
Autorização binária

Justificação da implantação forçada

breakglassJustification Usar a implantação forçada
Autorização binária Usar padrão useDefault Usar autorização binária
Rótulos de modelo

Key

labels Como configurar rótulos para serviços
Rótulos de modelo Valor labels Como configurar rótulos para serviços
Anotações de modelo

Key

anotações anotações
Anotações de modelo Valor anotações anotações

Tempo limite

timeout Definir o tempo limite da solicitação para serviços

Conta de serviço

serviceAccount Configurar a identidade dos serviços