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 |
|
Configurar secrets para serviços |
|
Como autenticar entre serviços | |
| AlloyDB para PostgreSQL |
|
Conectar a partir do Cloud Run |
| BigQuery |
|
Informações gerais do BigQuery |
|
Visão geral do Bigtable | |
Outro serviço do Cloud Run |
|
O que é o Cloud Run |
|
Conectar a partir do Cloud Run | |
|
Conectar a partir do Cloud Run | |
|
Conectar-se aos serviços do Google Cloud | |
|
Configurar um balanceador de carga de aplicativo externo global com o Cloud Run | |
|
Como se conectar a uma instância do Redis a partir de um serviço do Cloud Run | |
|
Conectar-se a uma instância do Memorystore for Redis Cluster | |
|
Conectar-se a uma instância do Memorystore for Valkey | |
|
Tutorial Usar o Pub/Sub com o Cloud Run | |
|
Configurar um balanceador de carga de aplicativo externo regional com o Cloud Run | |
|
Visão geral das regras de encaminhamento | |
|
Conectar-se aos serviços do Google Cloud | |
|
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 |
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 |