Todos os produtos
Search
Central de documentação

Container Registry:Use Helm earlier than V3.7 to push and pull charts

Última atualização: Jul 08, 2026

Utilize versões do Helm anteriores à V3.7 para enviar e baixar charts no Container Registry

Versões do Helm anteriores à V3.7 utilizam um conjunto experimental de comandos da Open Container Initiative (OCI) — helm3 chart save, helm3 chart push e helm3 chart export — diferente do comando helm push disponível na V3.7 e posteriores. Este tópico descreve como configurar uma instância do Container Registry Enterprise Edition e usar versões do Helm anteriores à V3.7 para enviar e baixar charts armazenados como artefatos OCI.

Pré-requisitos

Antes de começar, verifique se você possui:

  • Uma instância do Container Registry Enterprise Edition. Para criar uma, consulte a documentação do Container Registry.

  • O Helm V3 instalado. Execute helm3 version -c para verificar sua versão. Este tópico utiliza a V3.0.2.

  • Acesso de rede à sua instância Enterprise Edition (acesso à internet ou acesso via virtual private cloud (VPC) configurado).

Etapa 1: Configurar sua instância Enterprise Edition

Criar um namespace

  1. Faça logon no console do Container Registry.

  2. No painel de navegação à esquerda, clique em Instances.

  3. Na página Instances, clique na instância Enterprise Edition que deseja gerenciar.

  4. Faça logon no console do Container Registry.

  5. No painel de navegação à esquerda, escolha Repository > Namespace.

  6. Na página Namespace, clique em Create Namespace.

  7. Na caixa de diálogo Create Namespace, configure Namespace, Automatically Create Repository e Default Configurations for Automatically Created Repositories e, em seguida, clique em Confirm.

Criar um repositório de imagens

  1. No painel de navegação à esquerda, escolha Repository > Repositories.

  2. Na página Repositories, clique em Create Repository.

  3. Na etapa Repository Info, configure Namespace, Repository Name, Repository Type, Tags, Accelerated Images, Summary e Description e, em seguida, clique em Next.

  4. Na etapa Code Source, configure Code Source, Build Settings e Build Rules e, em seguida, clique em Create Repository. A tabela a seguir descreve os principais parâmetros.

    Parâmetro

    Descrição

    Code Source

    A origem do código.

    Automatically Build Images When Code Changes

    Aciona uma build automaticamente quando o código é commitado em um branch.

    Build With Servers Deployed Outside Chinese Mainland

    Cria imagens em servidores no exterior e as envia para o repositório na região especificada. Ative esta opção se o seu Dockerfile buscar dependências de sites fora da China continental e a conexão transfronteiriça for instável.

    Build Without Cache

    Busca a imagem base do repositório de origem em cada build, o que pode aumentar o tempo de construção. Desative esta opção para acelerar as builds.

  5. Na página Repositories, clique no repositório de imagens criado. Se Build aparecer no painel de navegação à esquerda da página de gerenciamento do repositório, significa que o repositório de imagens está vinculado ao repositório de código-fonte.

Configurar uma credencial de acesso

Utilize uma senha ou token como credencial de acesso ao repositório de imagens. Este tópico utiliza uma senha.

  1. No painel de navegação à esquerda, escolha Repository > Access Credential.

  2. Na página Access Credential, clique em Set Password.

  3. Na caixa de diálogo Set Password, defina Password e Confirm Password e, em seguida, clique em Confirm.

Configurar uma lista de controle de acesso (ACL)

Ative o acesso à internet ou adicione uma VPC para garantir que os charts possam ser enviados ao repositório de imagens. Este tópico utiliza o acesso à internet. Para acesso via VPC, consulte Configurar uma ACL de VPC.

  1. No painel de navegação à esquerda, escolha Repository > Access Control.

  2. Na página Access Control, clique na aba Internet.

  3. Ative Enable Access over Internet e, em seguida, clique em Add Internet Whitelist.

  4. Na caixa de diálogo Add Internet Whitelist, especifique o bloco CIDR e uma descrição e, em seguida, clique em Confirm.

(Opcional) Ativar pull anônimo

Após ativar o pull anônimo, os usuários podem baixar charts de um repositório de imagens público sem fazer logon.

  1. Faça logon no console do Container Registry.

  2. Na barra de navegação superior, selecione uma região.

  3. No painel de navegação à esquerda, clique em Instances.

  4. Na página Instances, clique na instância Enterprise Edition que deseja gerenciar.

  5. Faça logon no console do Container Registry.

  6. Na seção Instance Settings, no lado direito da página Overview, ative Pull from Anonymous Users.

  7. Na caixa de diálogo Tips, clique em Confirm.

Etapa 2: Enviar e baixar charts

Configurar o Helm

  1. Baixe o Helm V3 no site oficial. Este tópico utiliza a V3.0.2. Execute o comando a seguir para verificar sua versão:

    helm3 version -c
  2. Ative o recurso experimental OCI:

    export HELM_EXPERIMENTAL_OCI=1

Fazer login na instância Enterprise Edition

Substitua <Registry logon name> pela sua conta Alibaba Cloud e <instance-name>.<region>.cr.aliyuncs.com pelo endpoint da sua instância.

helm3 registry login --username=<Registry logon name> <Name of the Enterprise Edition instance>.<Region in which the Enterprise Edition instance resides>.cr.aliyuncs.com

Exemplo:

helm3 registry login --username=123@188077086902**** m**-registry.cn-hangzhou.cr.aliyuncs.com

Quando solicitado, insira a senha definida em Configurar uma credencial de acesso.

Para baixar charts de um repositório de imagens público sem fazer logon, ative Pull from Anonymous Users na página Overview da sua instância Enterprise Edition.

Enviar um chart

  1. Crie um chart de exemplo:

    helm3 create helloworld
  2. Salve o diretório do chart como uma tag de imagem na sua instância Enterprise Edition:

    helm3 chart save helloworld <Name of the Enterprise Edition instance>.<Region in which the Enterprise Edition instance resides>.cr.aliyuncs.com/<Namespace name>/<Name of the image repository>:<Image tag>

    Exemplo:

    helm3 chart save helloworld m**-registry.cn-hangzhou.cr.aliyuncs.com/m**/test:latest
  3. Envie o chart para o repositório de imagens:

    helm3 chart push <Name of the Enterprise Edition instance>.<Region in which the Enterprise Edition instance resides>.cr.aliyuncs.com/<Namespace name>/<Name of the image repository>:<Image tag>

    Exemplo:

    helm3 chart push m**-registry.cn-hangzhou.cr.aliyuncs.com/m**/test:latest

Baixar um chart

  1. Baixe a tag do chart do repositório de imagens:

    helm3 chart save helloworld <Name of the Enterprise Edition instance>.<Region in which the Enterprise Edition instance resides>.cr.aliyuncs.com/<Namespace name>/<Name of the image repository>:<Image tag>

    Exemplo:

    helm3 chart save helloworld m**-registry.cn-hangzhou.cr.aliyuncs.com/m**/test:latest
  2. Exporte o chart para um diretório local:

    helm3 chart export <Name of the Enterprise Edition instance>.<Region in which the Enterprise Edition instance resides>.cr.aliyuncs.com/<Namespace name>/<Name of the image repository>:<Image tag> -d .

    Exemplo:

    helm3 chart export m**-registry.cn-hangzhou.cr.aliyuncs.com/m**/test:latest -d .
  3. Instale o chart:

    helm install helloworld ./helloworld