O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Implantar pools de worker no Cloud Run

Nesta página, mostramos como implantar imagens de contêiner em um novo pool de workers do Cloud Run ou em uma nova revisão de um pool de workers do Cloud Run.

Os pools de workers são um recurso do Cloud Run projetado especificamente para realizar trabalho contínuo em segundo plano. Ao contrário dos serviços do Cloud Run, os pools de workers não possuem um endpoint/URL com balanceamento de carga e não suportam escalonamento automático.

Para conferir um exemplo de instruções de implantação de um novo pool de workers, consulte o Guia de início rápido sobre como implantar um pool de workers de amostra.

Funções exigidas

Para obter as permissões necessárias para implantar pools de workers do Cloud Run, solicite ao seu administrador que lhe conceda as seguintes funções do IAM:

Desenvolvedor Cloud Run (roles/run.developer) no pool de trabalhadores do Cloud Run
Usuário da conta de serviço (roles/iam.serviceAccountUser) na identidade que seus pools de trabalhadores usam para interagir com outros serviços do Google Cloud
Leitor do Artifact Registry (roles/artifactregistry.reader) no repositório do Artifact Registry da imagem do contêiner implantada

Para uma lista de papéis e permissões do IAM associados ao Cloud Run, consulte Papéis do IAM do Cloud Run e Permissões do IAM do Cloud Run. Se o seu pool de trabalhadores do Cloud Run interage com APIsGoogle Cloud , como as Bibliotecas de Cliente do Cloud, consulte o guia de configuração de identidade de serviço . Para mais informações sobre como conceder papéis, consulte permissões de implantação e gerenciar acesso.

Registros e imagens de contêiner compatíveis

É possível usar diretamente imagens de contêiner armazenadas no Artifact Registry ou imagens públicas do Docker Hub ou do GitHub Container Registry. O Google recomenda o uso do Artifact Registry. As imagens públicas do GitHub Container Registry e do Docker Hub são armazenadas em cache por até uma hora.

É possível usar imagens de contêiner de outros registros públicos ou privados (como JFrog Artifactory ou Nexus) ou imagens privadas do GitHub Container Registry configurando um repositório remoto do Artifact Registry.

Considere apenas o Docker Hub para implantar imagens de contêiner conhecidas, como Imagens oficiais do Docker ou Imagens do OSS patrocinadas pelo Docker. Para maior disponibilidade, o Google recomenda implantar essas imagens do Docker Hub ou do GitHub Container Registry usando um repositório remoto do Artifact Registry.

O Cloud Run não suporta camadas de imagem de contêiner maiores que 9,9 GB ao implantar a partir do Docker Hub ou de um repositório remoto do Artifact Registry com um registro externo.

Implantar pools de workers

É possível implantar pools de workers das seguintes maneiras:

Implantar um novo pool de trabalhadores
Atualizar um pool de trabalhadores existente
Implantar imagens de outros Google Cloud projetos
Implantar vários contêineres (arquivos secundários) em um pool de workers

Implantar um novo pool de workers

É possível especificar uma imagem de contêiner com uma tag (por exemplo, us-docker.pkg.dev/my-project/container/my-image:latest) ou com um resumo exato (por exemplo, us-docker.pkg.dev/my-project/container/my-image@sha256:41f34ab970ee...).

A implantação de um pool de trabalhadores pela primeira vez cria sua primeira revisão. Observe que as revisões são imutáveis. Se você implantar a partir de uma tag de imagem de contêiner, ela será resolvida para um resumo, e a revisão sempre exibirá esse resumo específico.

Siga as instruções usando o console Google Cloud , a Google Cloud CLI, o Terraform ou a API REST:

Console

No Google Cloud console, acesse o Cloud Run:

Acessar o Cloud Run
Selecione Pools de workers no menu e clique em Implantar contêiner para mostrar o formulário Criar pool de workers.
1. No formulário, especifique a imagem do contêiner.
2. Insira o nome do pool de worker. Os nomes dos grupos de trabalhadores devem ter no máximo 49 caracteres e devem ser exclusivos para cada região e projeto. Não é possível compartilhar o mesmo nome de um nome de serviço atual do seu projeto. Não é possível alterar o nome de um pool de trabalhadores depois, e ele fica visível publicamente.
3. Selecione a região em que você quer que o worker esteja localizado. O seletor de região indica o nível de preço e destaca regiões com o menor impacto de carbono.
4. Em Escalonamento, especifique o número de instâncias do pool de workers.
Clique em Contêineres, rede e segurança para definir outras configurações opcionais nas guias apropriadas:
- Configuração do contêiner
- Limites de CPU
- Limites de memória
- Variáveis de ambiente
- Contas de serviço
- Conecte-se a uma rede VPC para saída e entrada.
Quando terminar de configurar o pool de workers, clique em Criar para implantar a imagem no Cloud Run e aguarde a conclusão da implantação.

gcloud

No console do Google Cloud , ative o Cloud Shell.

Ativar o Cloud Shell

Na parte de baixo do console Google Cloud , uma sessão do Cloud Shell é iniciada e exibe um prompt de linha de comando. O Cloud Shell é um ambiente shell com a CLI do Google Cloud já instalada e com valores já definidos para o projeto atual. A inicialização da sessão pode levar alguns segundos.
Para implantar uma imagem de contêiner de pool de trabalhadores:
1. Execute este comando:
```
gcloud run worker-pools deploy WORKER_POOL --image IMAGE_URL 
```
  Substitua:
  - WORKER_POOL: o nome do pool de workers em que você quer fazer a implantação. Caso o conjunto de trabalhadores ainda não exista, este comando o cria durante a implantação. É possível omitir esse parâmetro inteiramente, mas será solicitado o nome do pool de workers, se você omiti-lo. Os nomes dos grupos de trabalhadores devem ter 49 caracteres ou menos, usar um nome exclusivo por região e projeto e não devem compartilhar o mesmo nome que um nome de serviço existente do seu projeto.
  - IMAGE_URL: uma referência à imagem do contêiner que contém o pool de workers, como us-docker.pkg.dev/cloudrun/container/worker-pool:latest. Observação: se você não fornecer a flag --image, o comando de implantação tentará implantar a partir do código-fonte.
2. Aguarde a conclusão da implantação. Após a conclusão, o Cloud Run mostra uma mensagem de sucesso com as informações de revisão sobre o pool de trabalhadores implantado.
  
  Para implantar em um local diferente daquele que você definiu com as propriedades run/region gcloud, use:
```
gcloud run worker-pools deploy WORKER_POOL --region REGION
```

YAML

É possível armazenar a especificação do pool de workers em um arquivo YAML e implantá-la usando a CLI gcloud.

Crie um novo arquivo worker-pool.yaml com o seguinte conteúdo:
```
apiVersion: run.googleapis.com/v1
kind: WorkerPool
metadata:
  name: WORKER_POOL
spec:
  template:
    spec:
      containers:
      - image: IMAGE
```
Substitua:
- WORKER_POOL: o nome do seu pool de workers do Cloud Run.
- IMAGE_URL: uma referência à imagem do contêiner que contém o pool de workers, como us-docker.pkg.dev/cloudrun/container/worker-pool:latest.
Também é possível definir outras configurações, como variáveis de ambiente ou limites de memória.
Implante o novo pool de workers usando o seguinte comando:
```
gcloud run worker-pools replace worker-pool.yaml
```
Por padrão, o comando gcloud run worker-pools replace usa o arquivo worker-pool.yaml, se ele estiver presente.

Terraform

Para saber como aplicar ou remover uma configuração do Terraform, consulte Comandos básicos do Terraform.

resource "google_cloud_run_v2_worker_pool" "default" {
  name     = "WORKER_POOL"
  location = "REGION"

  template {
    containers {
      image = "IMAGE_URL"
    }
  }
}

Substitua:

WORKER_POOL: o nome do pool de workers.
REGION: a região Google Cloud , por exemplo, europe-west1.
IMAGE_URL: uma referência à imagem do contêiner que contém o pool de workers, como us-docker.pkg.dev/cloudrun/container/worker-pool:latest.

API REST

Para implantar um novo pool de workers, envie uma solicitação HTTP POST ao endpoint create de pools de workers da API Cloud Run Admin.

Por exemplo, usando curl:

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X POST \
  -d '{template: {containers: [{image: "IMAGE_URL"}]}}' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/workerPools?workerPoolId=WORKER_POOL

Substitua:

ACCESS_TOKEN: um token de acesso válido para uma conta com as permissões do IAM para implantar serviços. Por exemplo, se você fez login no gcloud, é possível recuperar um token de acesso usando gcloud auth print-access-token. Em uma instância de contêiner do Cloud Run, é possível recuperar um token de acesso por meio do servidor de metadados da instância de contêiner.
IMAGE_URL: uma referência à imagem do contêiner que contém o pool de workers, como us-docker.pkg.dev/cloudrun/container/worker-pool:latest.
REGION: a região Google Cloud , por exemplo, europe-west1.
PROJECT_ID: o ID do projeto do Google Cloud .
- WORKER_POOL: o nome do pool de workers.

Locais do Cloud Run

O Cloud Run é regional, o que significa que a infraestrutura que executa seus serviços do Cloud Run está localizada em uma região específica e é gerenciada pelo Google para estar disponível de maneira redundante em todas as zonas da região.

Atender aos seus requisitos de latência, disponibilidade ou durabilidade são os principais fatores para selecionar a região em que seus serviços do Cloud Run são executados. Geralmente, é possível selecionar a região mais próxima de seus usuários, mas considere a localização dos outros Google Cloud produtos usados pelo serviço do Cloud Run. Usando Google Cloud A distribuição conjunta de produtos em vários locais pode afetar a latência e o custo do seu serviço.

O Cloud Run está disponível nas regiões a seguir:

Sujeitas aos preços do nível 1

asia-east1 (Taiwan)
asia-northeast1 (Tóquio)
asia-northeast2 (Osaka)
asia-south1 (Mumbai, Índia)
asia-southeast3 (Bangkok)
europe-north1 (Finlândia) Baixo CO₂
europe-north2 (Estocolmo) Baixo CO₂
europe-southwest1 (Madri) Baixo CO₂
europe-west1 (Bélgica) Baixo CO₂
europe-west4 (Países Baixos) Baixo CO₂
europe-west8 (Milão) Baixo CO₂
europe-west9 (Paris) Baixo CO₂
me-west1 (Tel Aviv)
northamerica-south1 (México)
us-central1 (Iowa) Baixo CO₂
us-east1 (Carolina do Sul)
us-east4 (Norte da Virgínia)
us-east5 (Columbus)
us-south1 (Dallas) Baixo CO₂
us-west1 (Oregon) Baixo CO₂

Sujeitas aos preços do nível 2

africa-south1 (Johannesburgo)
asia-east2 (Hong Kong)
asia-northeast3 (Seul, Coreia do Sul)
asia-southeast1 (Singapura)
asia-southeast2 (Jacarta)
asia-south2 (Déli, Índia)
australia-southeast1 (Sydney)
australia-southeast2 (Melbourne)
europe-central2 (Varsóvia, Polônia) Baixo CO₂
europe-west10 (Berlim)
europe-west12 (Turim) Baixo CO₂
europe-west2 (Londres, Reino Unido) Baixo CO₂
europe-west3 (Frankfurt, Alemanha)
europe-west6 (Zurique, Suíça) Baixo CO₂
me-central1 (Doha)
me-central2 (Damã)
northamerica-northeast1 (Montreal) Baixo CO₂
northamerica-northeast2 (Toronto) Baixo CO₂
southamerica-east1 (São Paulo, Brasil) Baixo CO₂
southamerica-west1 (Santiago, Chile) Baixo CO₂
us-west2 (Los Angeles) Baixo CO₂
us-west3 (Salt Lake City)
us-west4 (Las Vegas)

Se você já criou um serviço do Cloud Run, é possível visualizar a região no painel do Cloud Run no console doGoogle Cloud .

Implantar uma nova revisão de um pool de workers atual

Mudar as configurações de um pool de workers resulta na criação de uma nova revisão, mesmo que não haja alterações na imagem do contêiner. Cada revisão criada é imutável.

A imagem do contêiner é importada pelo Cloud Run quando implantada. O Cloud Run mantém essa cópia da imagem de contêiner enquanto ela é usada por uma revisão.

Siga estas instruções usando o console Google Cloud , a Google Cloud CLI, o Terraform ou a API REST:

Console

No Google Cloud console, acesse o Cloud Run:

Acessar o Cloud Run
Selecione Pools de workers no menu, escolha o pool de workers a ser atualizado e clique em Editar e implantar nova revisão para mostrar o formulário Implantar revisão do pool de workers.
1. Se necessário, especifique o URL da nova imagem do contêiner a ser implantada.
2. Configure o contêiner conforme necessário.
3. Se necessário, atualize o número de instâncias para o pool de trabalhadores.
Se necessário, clique em Contêineres, rede e segurança para definir outras configurações opcionais nas guias apropriadas:
- Configuração do contêiner
- Limites de CPU
- Limites de memória
- Variáveis de ambiente
- Contas de serviço
- Conecte-se a uma rede VPC para saída e entrada.
Quando você terminar de atualizar seu pool de trabalhadores, clique em Implantar.

gcloud

No console do Google Cloud , ative o Cloud Shell.

Ativar o Cloud Shell

Na parte de baixo do console Google Cloud , uma sessão do Cloud Shell é iniciada e exibe um prompt de linha de comando. O Cloud Shell é um ambiente shell com a CLI do Google Cloud já instalada e com valores já definidos para o projeto atual. A inicialização da sessão pode levar alguns segundos.
Para implantar uma imagem de contêiner, realize as etapas a seguir:
1. Execute o comando:
```
gcloud run worker-pools deploy WORKER_POOL --image IMAGE_URL 
```
  Substitua:
  - WORKER_POOL: o nome do pool de workers em que você quer fazer a implantação. Caso o conjunto de trabalhadores ainda não exista, este comando o cria durante a implantação. É possível omitir esse parâmetro inteiramente, mas será solicitado o nome do pool de workers, se você omiti-lo. Os nomes dos grupos de trabalhadores devem ter 49 caracteres ou menos, usar um nome exclusivo por região e projeto e não devem compartilhar o mesmo nome que um nome de serviço existente do seu projeto.
  - IMAGE_URL: uma referência à imagem do contêiner que contém o pool de workers, como us-docker.pkg.dev/cloudrun/container/worker-pool:latest. Observação: se você não fornecer a flag --image, o comando de implantação tentará implantar a partir do código-fonte.
  O sufixo de revisão é atribuído automaticamente para novas revisões. Se você quiser fornecer seu próprio sufixo de revisão, use o parâmetro de CLI gcloud --revision-suffix.
2. Aguarde a conclusão da implantação. Após a conclusão, o Cloud Run mostra uma mensagem de sucesso com as informações de revisão sobre o pool de trabalhadores implantado.

YAML

Baixe a configuração YAML do pool de trabalhadores :

gcloud run worker-pools describe WORKER_POOL --format export > worker-pool.yaml

Faça uma alteração no arquivo de configuração.
Atualize o pool de workers usando o seguinte comando:
```
gcloud run worker-pools replace worker-pool.yaml
```
Por padrão, o comando gcloud run worker-pools replace usa o arquivo worker-pool.yaml, se ele estiver presente.

Terraform

Certifique-se de ter configurado o Terraform conforme descrito no exemplo Implantando um novo pool de trabalhadores.

Faça uma alteração no arquivo de configuração.
Aplique a configuração do Terraform:
```
terraform apply
```
Confirme que você quer aplicar as ações descritas digitando yes.

API REST

Para implantar um novo pool de workers, envie uma solicitação HTTP PATCH para o endpoint de pools de workers da API Cloud Run Admin.

Para criar uma nova revisão a partir do modelo, mesmo que o sistema não detecte nenhuma alteração da revisão implantada anteriormente, defina o parâmetro de consulta forceNewRevision para true.

Por exemplo, usando curl:

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X PATCH \
  -d '{template: {containers: [{image: "IMAGE_URL"}]}}' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/workerPools/WORKER_POOL>?forceNewRevision=true

Substitua:

ACCESS_TOKEN: um token de acesso válido para uma conta com as permissões do IAM para implantar serviços. Por exemplo, se você fez login no gcloud, é possível recuperar um token de acesso usando gcloud auth print-access-token. Em uma instância de contêiner do Cloud Run, é possível recuperar um token de acesso por meio do servidor de metadados da instância de contêiner.
IMAGE_URL: uma referência à imagem do contêiner que contém o pool de workers, como us-docker.pkg.dev/cloudrun/container/worker-pool:latest.
REGION: a região Google Cloud , por exemplo, europe-west1.
PROJECT_ID: o ID do projeto do Google Cloud .
WORKER_POOL: o nome do pool de workers em que você está fazendo a implantação.

Validar a configuração com um teste

É possível validar a configuração do pool de workers sem implantá-la ou persistir as mudanças usando a flag --dry-run.

Quando você especifica a flag --dry-run, o comando realiza as seguintes ações:

Valida a configuração.
Ignora o processo de build se você estiver implantando a partir da origem.
Imprime uma mensagem de sucesso da validação.

Para validar a implantação de um pool de workers:

gcloud beta run worker-pools deploy WORKER_POOL \
    --image IMAGE_URL \
    --dry-run

Substitua:

WORKER_POOL: o nome do pool de workers em que você está fazendo a implantação.
IMAGE_URL: uma referência à imagem de contêiner, por exemplo, us-docker.pkg.dev/cloudrun/container/hello:latest. Se você usa o Artifact Registry, o repositório REPO_NAME já precisará ter sido criado. O URL segue o formato LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG .

Implantar imagens de outros projetos Google Cloud

Para implantar imagens de outros projetos do Google Cloud , você ou seu administrador precisam conceder os papéis do IAM necessários à conta do implantador e ao agente de serviço do Cloud Run.

Para saber quais são os papéis necessários para a conta de implantador, consulte papéis necessários.

Para conceder ao agente de serviço do Cloud Run os papéis necessários, consulte as instruções a seguir:

No console Google Cloud , abra o projeto do seu pool de workers do Cloud Run.

Acessar a página do IAM
Selecione Incluir concessões de papel fornecidas pelo Google.
Copie o e-mail do agente de serviço do Cloud Run. Ele tem o sufixo @serverless-robot-prod.iam.gserviceaccount.com.
Abra o projeto com o registro do contêiner que você quer usar.

Acessar a página do IAM
Clique em Adicionar para adicionar um novo principal.
No campo Novos principais, cole o e-mail da conta de serviço que você copiou anteriormente.
No menu suspenso Selecionar um papel, se você estiver usando o Container Registry, selecione o papel Armazenamento -> Leitor de objetos do Storage. Se você estiver usando o Artifact Registry, selecione o papel Artifact Registry -> Artifact Registry Reader.
Implante a imagem do contêiner no projeto que contém o pool de workers do Cloud Run.

Observação :para aumentar a segurança, conceda acesso apenas ao bucket do Cloud Storage ou ao repositório do Artifact Registry que contém as imagens de contêiner.

Como implantar imagens de outros registros

Para implantar imagens de contêiner públicas ou privadas que não estejam armazenadas no Artifact Registry ou no Docker Hub, ou que não sejam imagens públicas no GitHub Container Registry, configure um repositório remoto do Artifact Registry.

Os repositórios remotos do Artifact Registry permitem:

Implante qualquer imagem de contêiner pública.
Implante imagens de contêiner de repositórios privados que exigem autenticação, por exemplo, JFrog Artifactory ou Nexus.

Se não for possível usar um repositório remoto do Artifact Registry, é possível extrair e enviar imagens de contêiner temporariamente para o Artifact Registry implantando-as no Cloud Run usando docker push. O Cloud Run importa a imagem do contêiner durante a implantação e, depois, é possível excluir a imagem do Artifact Registry.

Implantar vários contêineres (arquivos secundários) em um pool de workers

Em uma implantação do Cloud Run com arquivos secundários, há um contêiner principal de pool de trabalhadores e um ou mais contêineres de arquivo secundário. Os sidecars podem se comunicar entre si e com o contêiner do pool de workers usando uma porta localhost. A porta do localhost varia de acordo com os contêineres usados.

É possível implantar até 10 contêineres por instância, incluindo o contêiner do pool de workers. Todos os contêineres dentro de uma instância compartilham o mesmo espaço de nomes de rede e também podem compartilhar arquivos usando um volume compartilhado na memória.

Você pode exigir que todas as implantações usem um sidecar específico criando políticas de organização personalizadas.

Implantar um pool de workers com contêineres de arquivos secundários

Siga estas instruções, usando a Google Cloud CLI, YAML ou Terraform, para implantar vários contêineres em um pool de workers do Cloud Run:

gcloud

No console do Google Cloud , ative o Cloud Shell.

Ativar o Cloud Shell

Na parte de baixo do console Google Cloud , uma sessão do Cloud Shell é iniciada e exibe um prompt de linha de comando. O Cloud Shell é um ambiente shell com a CLI do Google Cloud já instalada e com valores já definidos para o projeto atual. A inicialização da sessão pode levar alguns segundos.
Para implantar vários contêineres em um pool de workers, execute o seguinte comando:
```
gcloud run worker-pools deploy WORKER_POOL \
 --container WORKER_POOL_CONTAINER_NAME \
 --image='WORKER_POOL_IMAGE' \
 --container SIDECAR_CONTAINER_NAME \
 --image='SIDECAR_IMAGE'
```
Substitua:
- WORKER_POOL: o nome do pool de workers em que você está fazendo a implantação. Se você omitir esse parâmetro, será solicitado o nome do pool de workers.
- WORKER_POOL_CONTAINER_NAME: um nome para o contêiner do pool de workers.
- IMAGE_URL: uma referência à imagem do contêiner que contém o pool de workers, como us-docker.pkg.dev/cloudrun/container/worker-pool:latest.
- SIDECAR_CONTAINER_NAME: um nome para o contêiner sidecar, por exemplo, sidecar.
- SIDECAR_IMAGE: uma referência à imagem do contêiner de arquivo secundário.
Para configurar cada contêiner no comando de implantação, forneça a configuração de cada contêiner após os parâmetros container, por exemplo:
```
gcloud run worker-pools deploy WORKER_POOL \
  --container CONTAINER_1_NAME \
  --image='WORKER_POOL_IMAGE' \
  --set-env-vars=KEY=VALUE \
  --container SIDECAR_CONTAINER_NAME \
  --image='SIDECAR_IMAGE' \
  --set-env-vars=KEY_N=VALUE_N
```
Importante: Quando você usa o--container Se você precisar especificar as flags que não são de nível de contêiner, é necessário especificar todas as flags que não são de nível de contêiner antes das flags de nível de contêiner; caso contrário, o comando de implantação falhará com uma mensagem de erro nesse sentido.
Aguarde a conclusão da implantação. Após a conclusão, o Cloud Run mostra uma mensagem de sucesso.

YAML

Se você estiver criando um novo pool de workers, pule esta etapa. Se você estiver atualizando um pool de trabalhadores, faça o download da configuração YAML correspondente:
```
gcloud run worker-pools describe WORKER_POOL --format export > worker-pool.yaml
```
O exemplo a seguir contém a configuração YAML:
```
apiVersion: run.googleapis.com/v1
kind: WorkerPool
metadata:
  name: WORKER_POOL
spec:
  template:
    spec:
      containers:
      - name: CONTAINER_NAME
        image: IMAGE_URL
      containers:
      - name: SIDECAR_CONTAINER_NAME
        image: SIDECAR_IMAGE_URL
```
Substitua:
- WORKER_POOL: o nome do seu pool de workers do Cloud Run.
- CONTAINER_NAME: um nome para o contêiner do pool de workers.
- IMAGE_URL: uma referência à imagem do contêiner que contém o pool de trabalhadores, como us-docker.pkg.dev/cloudrun/container/worker-pool:latest
- SIDECAR_CONTAINER_NAME: um nome para o contêiner secundário — por exemplo, sidecar.
- SIDECAR_CONTAINER_IMAGE: uma referência à imagem do contêiner secundário.
Crie ou atualize o pool de workers usando o seguinte comando:
```
gcloud run worker-pools replace worker-pool.yaml
```
Por padrão, o comando gcloud run worker-pools replace usa o arquivo worker-pool.yaml, se ele estiver presente.

Terraform

Para saber como aplicar ou remover uma configuração do Terraform, consulte Comandos básicos do Terraform.

resource "google_cloud_run_v2_worker_pool" "default" {
  name     = "WORKER_POOL"
  location = "REGION"

  template {
    containers {
      name = "CONTAINER_NAME"
      image = "IMAGE_URL"
    }
    containers {
      name = "SIDECAR_CONTAINER_NAME"
      image = "SIDECAR_IMAGE_URL"
    }
  }
}

Substitua:

WORKER_POOL: o nome do pool de workers.
REGION: a região Google Cloud , por exemplo, europe-west1.
CONTAINER_NAME: o nome do contêiner.
IMAGE_URL: uma referência à imagem do contêiner que contém o pool de workers, como us-docker.pkg.dev/cloudrun/container/worker-pool:latest.
SIDECAR_CONTAINER_NAME: o nome do contêiner secundário.
SIDECAR_IMAGE_URL: uma referência à imagem do contêiner secundário.

Recursos importantes disponíveis para implantações com arquivos secundários

É possível especificar a ordem de inicialização do contêiner em uma implantação com vários contêineres se você tiver dependências que exigem que alguns contêineres sejam iniciados antes de outros na implantação.

Se você tiver contêineres que dependam de outros contêineres, use verificações de integridade na implantação. Ao usar verificações de integridade, o Cloud Run segue a ordem de inicialização do contêiner, verificando a integridade de cada um antes de iniciar o próximo. Sem verificações de integridade, o Cloud Run tenta iniciar todos os contêineres, mesmo que os contêineres dos quais eles dependem ainda não estejam em execução ou não tenham sido iniciados.

Vários contêineres em uma única instância podem acessar um volume na memória compartilhado, acessível a cada contêiner por meio dos pontos de montagem criados.

A seguir

Depois de implantar um novo pool de trabalhadores, é possível fazer o seguinte:

Implantar pools de worker no Cloud Run Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Funções exigidas

Registros e imagens de contêiner compatíveis

Implantar pools de workers

Implantar um novo pool de workers

Console

gcloud

YAML

Terraform

API REST

Locais do Cloud Run

Sujeitas aos preços do nível 1

Sujeitas aos preços do nível 2

Implantar uma nova revisão de um pool de workers atual

Console

gcloud

YAML

Terraform

API REST

Validar a configuração com um teste

Implantar imagens de outros projetos Google Cloud

Como implantar imagens de outros registros

Implantar vários contêineres (arquivos secundários) em um pool de workers

Implantar um pool de workers com contêineres de arquivos secundários

gcloud

YAML

Terraform

Recursos importantes disponíveis para implantações com arquivos secundários

A seguir

Implantar pools de worker no Cloud Run