Todos os produtos
Search
Central de documentação

Container Registry:Use o Helm 3.7 ou versão posterior para enviar e baixar charts

Última atualização: Sep 25, 2026

Armazene e gerencie Helm charts como artefatos Open Container Initiative (OCI) em uma instância do Container Registry Enterprise Edition. O suporte a artefatos OCI está estável no Helm desde a versão 3.7.

Pré-requisitos

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

  • Helm 3.7 ou posterior instalado. Execute helm version para verificar

  • Uma instância do Container Registry Enterprise Edition

  • Uma conta Alibaba Cloud com acesso ao console do Container Registry

Etapa 1: Configure sua instância Enterprise Edition

Crie 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. No painel de navegação à esquerda, escolha Repository > Namespace.

  5. Clique em Create Namespace.

  6. Na caixa de diálogo Create Namespace, defina Namespace e Automatically Create Repository e clique em Confirm.

Crie um repositório de imagens

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

  2. Clique em Create Repository.

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

  4. Na etapa Code Source, configure Code Source, Build Settings e Build Rules. Em seguida, clique em Create Repository. Para confirmar que o repositório está vinculado a um repositório de código-fonte, clique no repositório na página Repositories e verifique se Build aparece no painel de navegação à esquerda.

    Parâmetro

    Descrição

    Code Source

    Repositório de código-fonte a ser vinculado a este repositório de imagens

    Automatically Build Images When Code Changes

    Aciona um build automaticamente quando código é enviado para a branch vinculada

    Build with Servers Deployed Outside Chinese Mainland

    Compila imagens em servidores no exterior e as envia para a região de destino. Ative esta opção quando o Dockerfile buscar recursos no exterior e a conexão transfronteiriça estiver instável.

    Build Without Cache

    Baixa a imagem base novamente a cada build. Desative para acelerar os builds reutilizando camadas em cache

Configure uma credencial de acesso

Defina uma senha como credencial de acesso para sua instância Enterprise Edition.

  1. No painel de navegação à esquerda, escolha Instances > Access Credentials.

  2. Clique em Password.

  3. Na caixa de diálogo Set Password, insira e confirme sua senha e clique em Confirm.

Também é possível usar um token temporário como credencial de acesso.

Configure políticas de acesso

Ative o acesso pela Internet para que os charts possam ser enviados e baixados da instância.

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

  2. Clique na aba Internet.

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

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

Para usar o acesso via VPC em vez do acesso pela Internet, consulte Configure a VPC ACL .

(Opcional) Ative o pull anônimo

Ative Pull from Anonymous Users para permitir que qualquer pessoa baixe charts de repositórios públicos nesta instância 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. Clique na instância Enterprise Edition que deseja gerenciar.

  5. Na página Overview, na seção Instance Settings, ative Pull from Anonymous Users.

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

Etapa 2: Envie e baixe charts

Ative o suporte a OCI

Execute o comando a seguir para ativar o suporte a artefatos OCI no Helm 3.7:

export HELM_EXPERIMENTAL_OCI=1

Faça logon na instância

Substitua <registry-logon-name> pelo nome da sua conta Alibaba Cloud. Substitua <instance-name> e <region-id> pelos detalhes da sua instância.

helm3 registry login -u <registry-logon-name> <instance-name>-registry.cn-<region-id>.cr.aliyuncs.com

Quando solicitado, insira a senha definida na etapa anterior.

Exemplo:

helm3 registry login -u acr_test_***@test.aliyunid.com ***-registry.cn-hangzhou.cr.aliyuncs.com
Se Pull from Anonymous Users estiver ativado na página Overview , os charts em repositórios públicos poderão ser baixados sem fazer logon.

Crie e empacote um chart

  1. Crie um chart de exemplo HelloWorld:

    helm3 create helloworld
  2. Empacote o diretório do chart em um arquivo compactado:

    tar -zcvf test.tgz helloworld

Envie um chart

O URI OCI para envio deve terminar com o namespace, e não com o nome do repositório. O nome do repositório é lido diretamente do pacote do chart.

helm3 push test.tgz oci://<instance-name>-registry.cn-<region-id>.cr.aliyuncs.com/<namespace>

Exemplo:

helm3 push test.tgz oci://***-registry.cn-hangzhou.cr.aliyuncs.com/test

Baixe e instale um chart

O URI OCI para download deve terminar com o nome do repositório, seguido de --version para especificar a tag da imagem.

  1. Baixe o pacote do chart:

    helm3 pull oci://<instance-name>-registry.cn-<region-id>.cr.aliyuncs.com/<namespace>/<repository-name> --version <image-tag>

    Exemplo:

    helm3 pull oci://***-registry.cn-hangzhou.cr.aliyuncs.com/test/trem --version helloworld
  2. Descompacte o pacote do chart:

    tar -xzvf helloworld-<image-tag>.tgz
  3. Instale o chart:

    helm install helloworld ./helloworld

Próximos passos