Todos os produtos
Search
Central de documentação

Container Service for Kubernetes:aliyun-acr-credential-helper

Última atualização: Jun 27, 2026

O componente aliyun-acr-credential-helper permite baixar imagens privadas do Container Registry (ACR) em clusters ACK sem credenciais.

Importante

A autenticação sem credenciais para o ACR Personal Edition é compatível apenas com instâncias criadas até 8 de setembro de 2024. Para instâncias criadas após essa data, configure um AccessKey ID e AccessKey Secret.

Visão geral

O aliyun-acr-credential-helper lê o ConfigMap acr-configuration no namespace kube-system de um cluster ACK para autenticar e baixar imagens privadas sem credenciais manuais.

Principais recursos:

  • Autenticação sem credenciais: Autentica automaticamente no ACR Enterprise Edition e Personal Edition (instâncias criadas até 8 de setembro de 2024), eliminando a criação e rotação manual de Secrets.

  • Suporte a múltiplas contas: Por padrão, baixa imagens do registro da conta atual. Também permite downloads entre contas mediante autorização entre contas ou configuração de AccessKey.

  • Suporte entre regiões: Baixa imagens privadas de instâncias do ACR em outras regiões.

Uso

Consulte Usar o aliyun-acr-credential-helper para fazer pull de imagens sem credenciais (não gerenciado) ou Usar o aliyun-acr-credential-helper para fazer pull de imagens sem credenciais (gerenciado).

Histórico de versões

Julho de 2025

Versão

Data

Descrição

Impacto

v25.07.21.1-67f1f51-aliyun

21 de julho de 2025

Recurso: O credential helper não gerenciado agora é compatível com o Modo de Reforço de Segurança para metadados do Elastic Compute Service (ECS).

Esta atualização não afeta seus serviços.

Setembro de 2024

Versão

Data

Descrição

Impacto

v24.09.05.1-e65351a-aliyun

5 de setembro de 2024

Correção de bug: Credential helper não gerenciado: Corrigida a invalidação intermitente de Secret na versão v24.08.01.1-1aa1880-aliyun.

Esta atualização não afeta seus serviços.

Agosto de 2024

Versão

Data

Descrição

Impacto

v24.08.01.1-1aa1880-aliyun

26 de agosto de 2024

Segurança: Credential helper não gerenciado: Permissões de Secret restritas.

Esta atualização não afeta seus serviços.

Maio de 2024

Versão

Data

Descrição

Impacto

v24.01.29.1-5318af4-aliyun

10 de maio de 2024

Correção de bug: Credential helper gerenciado: Corrigido o tratamento de erros para falhas em chamadas de API.

Esta atualização não afeta seus serviços.

Janeiro de 2024

Versão

Data

Descrição

Impacto

v24.01.16.1-aeea43b-aliyun

22 de janeiro de 2024

Correção de bug: Credential helper não gerenciado: Corrigido o tratamento de erros para falhas em chamadas de API.

Esta atualização não afeta seus serviços.

Abril de 2023

Versão

Data

Descrição

Impacto

v23.02.06.2-74e2172-aliyun

4 de abril de 2023

Recurso: Adicionado suporte a funções gerenciadas, tornando opcional a dependência da função de worker.

Isso afeta o uso do add-on. Consulte [[Alteração de Produto] Aviso sobre alteração nas dependências de permissão do aliyun-acr-credential-helper](t2292520.dita#task_2292520).

Março de 2023

Versão

Data

Descrição

Impacto

v23.02.06.1-74e2172-aliyun

15 de março de 2023

  • Correção de bug: Vários problemas conhecidos foram corrigidos.

  • Recurso: Adicionada configuração de permissão para RAM Roles for Service Accounts (RRSA).

  • Recurso: Os ServiceAccounts criados durante a instalação do Helm chart agora ficam disponíveis imediatamente.

  • Recurso: Adicionado diagnóstico inteligente de O&M para o add-on sem credenciais.

Esta atualização não afeta seus serviços.

Março de 2022

Versão

Data

Descrição

Impacto

v22.03.25.1-efe240e-aliyun

25 de março de 2022

  • Correção de bug: Resolvidos conflitos de versão de Secret causados por atualizações simultâneas do controller.

  • Recurso: Ativado o Auto Scaling para o pool de nós padrão.

Esta atualização não afeta seus serviços.

Janeiro de 2022

Versão

Data

Descrição

Impacto

v22.01.04.0-f637776-aliyun

4 de janeiro de 2022

  • Recurso: Adicionado suporte à arquitetura ARM.

  • Alteração: Deixou de ser instalado por padrão durante a criação do cluster. Instale manualmente pela página Add-ons.

  • Otimização: Melhorado o desempenho do add-on.

Esta atualização não afeta seus serviços.

Novembro de 2021

Versão

Data

Descrição

Impacto

v21.11.15.0-19d8bc1-aliyun

15 de novembro de 2021

Otimização: Atualizada a versão do ClusterRole.

Esta atualização não afeta seus serviços.

Setembro de 2021

Versão

Data

Descrição

Impacto

v21.09.22.0-450db22-aliyun

22 de setembro de 2021

Recurso: O add-on agora relata eventos do cluster em caso de erros.

Esta atualização não afeta seus serviços.

Janeiro de 2021

Versão

Data

Descrição

Impacto

v21.01.26.0-9ac7d9b-aliyun

26 de janeiro de 2021

Otimização: Aperfeiçoado o método de autenticação.

Esta atualização não afeta seus serviços.

Agosto de 2020

Versão

Data

Descrição

Impacto

v20.08.20.0-c2da10b-aliyun

24 de agosto de 2020

Correção de bug: Corrigidas falhas ao baixar imagens privadas devido a tokens expirados.

Esta atualização não afeta seus serviços.

Julho de 2020

Versão

Data

Descrição

Impacto

v20.07.13.0-2866ccd-aliyun

13 de julho de 2020

  • Recurso: Adicionado suporte a rede interna para chamadas OpenAPI.

  • Recurso: Adicionado suporte a AccessKey personalizado para credenciais de download de imagens.

  • Otimização: Reduzida a frequência de chamadas OpenAPI.

Esta atualização não afeta seus serviços.

Março de 2020

Versão

Data

Descrição

Impacto

v20.03.16.0-36d5d7e-aliyun

16 de março de 2020

Recurso: Adicionado suporte para download de imagens privadas entre contas.

Esta atualização não afeta seus serviços.