Todos os produtos
Search
Central de documentação

Container Service for Kubernetes:Customize containerd parameters for a node pool

Última atualização: Oct 21, 2026

Quando as configurações padrão do containerd não atendem às necessidades da sua carga de trabalho, configure os parâmetros do containerd no nível do node pool. Por exemplo, configure vários registros espelho para um único repositório de imagens ou ignore a verificação do certificado TLS para um registro específico.

Limitações

Este recurso requer o containerd 1.6.20 ou posterior. Se o seu node pool usar uma versão anterior, atualize o node pool.

Notas de uso

  • As configurações personalizadas são aplicadas em lotes: imediatamente nos nós existentes e automaticamente nos novos nós.

  • Não modifique parâmetros personalizáveis do containerd pela linha de comando. O ACK bloqueia esse tipo de alteração e exige que você a reverta.

  • A sintaxe fora do padrão é corrigida automaticamente durante a aplicação.

Parâmetros personalizáveis do containerd

Configuração personalizada do runtime de contêineres

Parâmetro

Observação

Tipo

Valor

max_concurrent_downloads

Número máximo de downloads simultâneos de camadas de imagem. Valores mais altos aceleram os pulls de várias camadas, mas aumentam a carga de rede e de I/O.

Int

  • Intervalo válido: 1–20

  • Padrão: Depende da versão do containerd.

    • containerd 2.x+: 3.

    • containerd 1.x: Determinado pela lógica interna do runtime.

ignore_image_defined_volumes

Especifica se os volumes anônimos definidos pela instrução VOLUME serão ignorados. Para impedir a criação automática de volumes anônimos, defina como true.

Bool

Padrão: true

limitCore

Tamanho máximo do arquivo de core dump em bytes.

Valores-chave:

  • 0: Desativa os core dumps.

  • infinity: Ilimitado.

Int

  • Intervalo válido: Inteiro não negativo

  • Padrão: infinity

limitNoFile

Número máximo de descritores de arquivo abertos por contêiner.

Int

  • Intervalo válido: ≥ 1024

  • Padrão: 1048576

limitMemLock

Memória máxima bloqueável em bytes por processo de contêiner.

Int

  • Intervalo válido: ≥ 65536

  • Padrão: 65536 (consistente com o SO do host).

    Para nós Lingjun ou nós com dispositivos RDMA/EDMA detectados na inicialização, o padrão é infinity. Dispositivos conectados após o nó estar pronto não acionam essa mudança.

Registry Mirror Configuration

Descrição

Recomendação

Configure registros alternativos como espelhos para acelerar o pull de imagens.

Cada espelho suporta o mapeamento de caminho personalizado por meio de override_path.

Essa alteração não exige a reinicialização dos contêineres.
  • Use um registro local para acelerar os pulls.

  • Configure vários espelhos para alta disponibilidade.

Image Registries Skipping Certificate Authentication (Insecure Registries)

Descrição

Recomendação

Ignore a validação do certificado TLS para registros especificados durante o pull de imagens. Destinado a ambientes de teste com certificados autoassinados.

Essa alteração não exige a reinicialização dos contêineres.
  • Ignorar a validação do certificado apresenta riscos de segurança. Use apenas em ambientes de desenvolvimento e teste.

  • Use apenas para registros privados com certificados autoassinados ou que não podem ser obtidos.

Procedimento

As alterações não afetam os contêineres em execução. Execute esta operação fora dos horários de pico.

  1. Faça login no ACK console. No painel de navegação à esquerda, clique em Clusters.

  2. Na página Clusters, clique em seu cluster. No painel de navegação à esquerda, clique em Nodes > Node Pools.

  3. Na página Node Pools, encontre o node pool desejado e, na coluna Actions, escolha image > Containerd Configuration.

  4. Adicione parâmetros, especifique os nós de destino, defina a política de lotes e clique em Submit.

    Consulte Exemplos de configuração .
    • A remoção de um parâmetro de runtime personalizado o reverte para o valor padrão.

    • As configurações são aplicadas aos nós em lotes. Monitore o progresso na área Event Records. Pause, retome ou cancele a atualização. Se a atualização de um nó falhar, solucione o problema e clique em Continue para tentar novamente.

      A pausa permite validar as alterações nos nós atualizados. Os nós em andamento concluem a atualização, mas as novas atualizações aguardam até que você retome. Conclua a tarefa rapidamente: tarefas pausadas são canceladas automaticamente após sete dias, excluindo todos os registros e logs.

Exemplos de configuração

Espelho para docker.io

Registro privado inseguro

Registro privado HTTP

Em Registry mirrors, defina Image registry como docker.io, Registry mirror como o endereço do espelho (por exemplo, https://example.com) e override_path como false.

Em Insecure registries, insira o endereço do registro em Image registry (formato: IP address:Port, por exemplo, 192.xxx.xxx.xxx:443) e defina skip_verify como true.

Em Registry mirrors, defina Image registry como o endereço do registro privado (por exemplo, 192.xxx.1), Registry mirror como seu endereço HTTP (por exemplo, http://192.xxx.1) e override_path como false, e clique em + Add para mais mapeamentos.

FAQ

As configurações personalizadas do containerd afetam os serviços em execução?

Não. As alterações se aplicam apenas aos Pods criados após a atualização, não aos que estão em execução. Execute esta operação fora dos horários de pico.

Para aplicar as novas configurações aos Pods existentes, recrie-os manualmente.

Erros com not match XXX ou must be between XXX****

Causas comuns:

  • must be between XXX: Valor inválido. Verifique o formato e o intervalo permitido.

  • not match XXX: Método de modificação não suportado. O ACK bloqueia alterações na linha de comando para o arquivo de configuração. Reverta o parâmetro para o seu valor original.

Referências