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.

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

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

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

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

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:

Desenvolvedor do Cloud Run (roles/run.developer) no job do Cloud Run
Usuário da conta de serviço (roles/iam.serviceAccountUser) na conta de serviço

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.

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

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

Acessar o Cloud Run
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.
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.

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

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

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

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.