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.

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

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

Acesse o Cloud Run
Se você estiver configurando um novo job, clique na guia Jobs e preencha a página inicial de configurações do job conforme quiser. Se você estiver configurando um job, clique nele e em Editar.
Clique em Contêiner, variáveis e secrets, conexões e segurança para expandir a página de propriedades do job.
Clique na guia Contêiner.
- Selecione o tamanho de memória que você quer na lista suspensa Memória.
Clique em Criar ou Atualizar.

Linha de comando

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.
Para definir limites de memória ao atualizar um job:
```
gcloud run jobs update JOB_NAME --memory SIZE
```

YAML

Faça o download e veja a configuração do job que já existe usando o comando gcloud run jobs describe --format export, que gera resultados limpos no formato YAML. Em seguida, modifique os campos descritos abaixo e faça upload do YAML modificado usando o comando gcloud run jobs replace. Modifique os campos somente conforme documentado.

Para visualizar e fazer o download da configuração:

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

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

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

Acessar jobs do Cloud Run
Clique no job em que você tem interesse para abrir a página Detalhes do job.
Clique na guia Configuração.
Localize a definição do limite de memória nos detalhes da configuração.

Linha de comando

Use o comando a seguir:
```
gcloud run jobs describe JOB_NAME
```
Localizar a configuração de limite de memória na configuração retornada.