Configurar limites de memória

É possível provisionar o job do Cloud Run com diferentes quantidades de memória. Esta página descreve como especificar a quantidade de memória disponível para o job.

Entender o uso da memória

As instâncias do Cloud Run que excedem o limite de memória permitido são encerradas.

Os itens a seguir afetam a memória disponível da instância:

  • Executar o executável do job, porque ele precisa ser carregado na memória.
  • Alocar memória no processo do job
  • Gravar arquivos no sistema de arquivos

O tamanho da imagem de contêiner implantada não afeta a memória disponível.

Definir e atualizar os limites de memória

É possível definir limites de memória em jobs do Cloud Run. Por padrão, a memória alocada para cada job é de 512 MiB.

CPU mínima necessária

A quantidade de memória alocada escolhida corresponde a uma quantidade de CPU alocada para seu job. Ao definir um limite de memória, os seguintes limites mínimos de CPU são necessários:

Memória CPU mínima necessária
128 MiB .083 vCPU
256 MiB .167 vCPU
512 MiB .333 vCPU
1 GiB .583 vCPU
2 GiB 1 vCPU
Mais de 4 GiB 2 vCPU
Mais de 8 GiB 4 vCPUs
Mais de 16 GiB 6 vCPU
Mais de 24 GiB 8 vCPUs

Quantidade máxima de memória

A quantidade máxima de memória que você pode configurar é 32 gibibyte (32 Gi).

Memória mínima

A quantidade mínima de memória que pode ser configurada no ambiente de execução de segunda geração é de 512 MiB.

Funções exigidas

Para receber as permissões necessárias para configurar os jobs do Cloud Run, peça ao administrador para conceder a você os seguintes papéis do IAM:

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 job do Cloud Run interagir com APIs do Google Cloud, como 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.

Configurar limites de memória

Especifique um mínimo de 512 Mi para um job do Cloud Run. Para especificar memória de um job do Cloud Run:

Console

  1. No console do Google Cloud, acesse a página de jobs do Cloud Run:

    Acessar o Cloud Run

  2. Clique em Implantar contêiner e selecione Job para preencher a página inicial de configurações do job. Se você estiver configurando um job, clique nele e em Editar.

  3. Clique em Contêiner, variáveis e secrets, conexões e segurança para expandir a página de propriedades do job.

  4. Clique na guia Contêiner.

    imagem

    • Selecione o tamanho de memória que você quer na lista suspensa Memória.

  5. Clique em Criar ou Atualizar.

gcloud

  1. Para definir limites de memória ao criar um job:

    gcloud run jobs create JOB_NAME --image IMAGE_URL --memory SIZE

    Substitua:

    • JOB_NAME pelo nome do job.
    • IMAGE_URL por uma referência à imagem de contêiner. Por exemplo, us-docker.pkg.dev/cloudrun/container/job:latest;
    • SIZE pelo tamanho de memória desejado. O formato do tamanho é um número de ponto fixo ou flutuante seguido de uma unidade: G ou M correspondente a gigabyte ou megabyte, respectivamente, ou usa a potência de dois equivalentes: Gi ou Mi correspondentes a gibibyte ou mebibyte, respectivamente.

  2. Para definir limites de memória ao atualizar um job:

    gcloud run jobs update JOB_NAME --memory SIZE

YAML

  1. Se você estiver criando um novo serviço, pule esta etapa. Se você estiver atualizando um serviço existente, faça o download da configuração YAML correspondente:

    gcloud run jobs describe JOB_NAME --format export > job.yaml

  2. Atualize o atributo memory:

    apiVersion: run.googleapis.com/v1
kind: Job
metadata:
  name: JOB
spec:
  template:
    spec:
      template:
        spec:
      containers:
      - image: IMAGE
        resources:
          limits:
            memory: SIZE

    Substitua SIZE pelo tamanho de memória desejado, especificando um mínimo de 512 Mi. O formato é um número de ponto fixo ou flutuante seguido por uma unidade, G ou M, correspondente a gigabyte ou megabyte, respectivamente, ou usar a potência de dois equivalentes, Gi ou Mi, correspondente a gibibyte ou mebibyte, respectivamente.

    Também é possível definir outras configurações, como variáveis de ambiente ou limites de memória.

  3. Atualize a configuração do job que já existe:

    gcloud run jobs replace job.yaml

Ver configurações de limite de memória

Para ver as configurações de limite de memória atuais do seu job do Cloud Run:

Console

  1. No console do Google Cloud, acesse a página de jobs do Cloud Run:

    Acessar jobs do Cloud Run

  2. Clique no job em que você tem interesse para abrir a página Detalhes do job.

  3. Clique na guia Configuração.

  4. Localize a definição do limite de memória nos detalhes da configuração.

gcloud

  1. Use o comando a seguir:

    gcloud run jobs describe JOB_NAME

  2. Localizar a configuração de limite de memória na configuração retornada.