Configurar limites de memória

Nesta página, descrevemos como definir limites de memória.

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:

  • Abrir o executável do aplicativo (já que o executável precisa ser carregado na memória).
  • Alocar memória no processo do aplicativo.
  • Gravar arquivos no sistema.

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

Ao definir um limite de memória, os seguintes limites mínimos de CPU são obrigatórios:

Memória CPU mínima necessária
Mais de 4 GiB 2
Mais de 8 GiB 4
Mais de 16 GiB 6
Mais de 24 GiB 8

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

    Substituir

    • 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.