Todos os produtos
Search
Central de documentação

Container Registry:Acessar uma instância Enterprise Edition usando um domínio Personal Edition

Última atualização: Sep 21, 2026

Migrar imagens de uma instância Personal Edition para uma instância Enterprise Edition exige alterar o domínio das imagens, o que pode ser custoso. Para simplificar essa migração, as instâncias Enterprise Edition oferecem um recurso de compatibilidade que permite acessá-las pelo domínio da Personal Edition, sem necessidade de alterações.

Pré-requisitos

Nota

Este recurso está disponível apenas para usuários incluídos na lista de permissões.

Limitações

  • É possível ativar esse recurso de compatibilidade para apenas uma instância Enterprise Edition por região.

  • Ao usar um domínio Personal Edition para fazer pull de imagens de instâncias Personal Edition de outros usuários, somente as imagens públicas estarão acessíveis.

  • Se um namespace na sua instância Enterprise Edition tiver o mesmo nome de um namespace em uma instância Personal Edition, não será possível fazer pull de imagens desse namespace da Personal Edition. Portanto, evite usar strings específicas do Container Service for Kubernetes (ACK), como acs, como nomes de namespace na instância Enterprise Edition. Isso ajuda a evitar falhas de acesso às imagens de contêiner oficiais do ACK.

  • Para acesso pela internet, configure manualmente a resolução de nomes de domínio para apontar ao endpoint da instância Enterprise Edition.

  • Para usar um usuário RAM no login e pull de imagens, configure também as credenciais de acesso da instância Enterprise Edition e conceda ao usuário RAM as permissões necessárias. Para obter mais informações, consulte RAM authorization.

Informações gerais

As instâncias Personal Edition e Enterprise Edition oferecem suporte aos seguintes tipos de nomes de domínio:

  • Nomes de domínio de uma instância Personal Edition (usando a região China (Hangzhou) como exemplo)

    Nota

    A partir de 9 de setembro de 2024, os nomes de domínio usados para acessar novas instâncias Personal Edition foram ajustados. Para obter mais informações, consulte Limits on new Personal Edition instances.

    • Nome de domínio de internet padrão para o site China: registry.cn-hangzhou.aliyuncs.com

    • Nome de domínio de rede privada padrão para o site China: registry-vpc.cn-hangzhou.aliyuncs.com

    • Nome de domínio de internet padrão para o site internacional: registry-intl.cn-hangzhou.aliyuncs.com

    • Nome de domínio de rede privada padrão para o site internacional: registry-intl-vpc.cn-hangzhou.aliyuncs.com

  • Nomes de domínio de uma instância Enterprise Edition (usando a região China (Hangzhou) como exemplo)

    • Nome de domínio de internet padrão: <Nome da instância Enterprise Edition>-registry.cn-hangzhou.cr.aliyuncs.com

    • Nome de domínio de rede privada padrão: <Nome da instância Enterprise Edition>-registry-vpc.cn-hangzhou.cr.aliyuncs.com

    • Nome de domínio personalizado: você pode usar um nome de domínio que tenha registrado.

Como funciona

O recurso de compatibilidade resolve o nome de domínio da Personal Edition para o endpoint de internet ou VPC da sua instância Enterprise Edition dentro do seu ambiente privado.

  • Na cloud: o sistema usa automaticamente o Alibaba Cloud DNS PrivateZone para adicionar o nome de domínio VPC da instância Personal Edition e resolvê-lo para o endpoint VPC da instância Enterprise Edition. Para acessar a instância Enterprise Edition pela internet usando o domínio da Personal Edition, configure manualmente o Alibaba Cloud DNS PrivateZone para resolver o domínio da Personal Edition para o endpoint de internet da instância Enterprise Edition. Recomenda-se usar VPC para acessar a instância.

  • No ambiente local (on-premises), configure a resolução de nomes de domínio para apontar à instância Enterprise Edition. Ao fazer push ou pull de uma imagem, o sistema distribui o tráfego com base no namespace especificado no endereço. Se o namespace existir na instância Enterprise Edition, o tráfego será direcionado para ela. Caso contrário, será direcionado para a instância Personal Edition.

Cenários

Cenário

Compatibilidade com Personal Edition

Domínio Enterprise Edition

  • Seus ambientes de build, código e aplicações dependem fortemente de imagens da Personal Edition, tornando a troca para um domínio Enterprise Edition custosa.

  • Seus ambientes de build e distribuição de imagens são fixos, o que torna uma alteração única de DNS pouco custosa.

Recomendado

Não recomendado

Seus cenários de distribuição são complexos, tornando a resolução de nomes de domínio custosa. Por exemplo, pode ser necessário fornecer imagens a terceiros.

Não recomendado

Recomendado

Você precisa usar imagens privadas de instâncias Personal Edition de outros usuários na mesma região.

Não recomendado

Recomendado

Etapa 1: Ativar a compatibilidade com domínio Personal Edition

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

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

  3. Na página Instances, clique em a instância Enterprise Edition que deseja gerencie.

  4. No painel de navegação à esquerda, escolha Repository > Domain.

  5. Na página Domain, ative o botão Support Personal Edition Instance Domains.

    Importante

    Para usar o recurso de compatibilidade, envie um ticket para adicionar sua instância Enterprise Edition à lista de permissões.

  6. Na caixa de diálogo Configure Resolution, selecione Confirm to Enable the feature of supporting personal edition instance domains e clique em Confirm.

    Após ativar o recurso de compatibilidade, dois nomes de domínio da Personal Edition são adicionados à página Domain. Por exemplo, se a instância estiver na região China (Hangzhou), o nome de domínio de internet registry.cn-hangzhou.aliyuncs.com e o nome de domínio de rede privada registry-vpc.cn-hangzhou.aliyuncs.com serão adicionados.

    Importante

    A ativação do recurso de compatibilidade leva alguns segundos. Durante esse período, não é possível gerencie namespaces nem configure o controle de acesso à rede.

    Após a ativação do recurso de compatibilidade, as imagens enviadas por push usando um domínio Personal Edition passam a ser armazenadas na instância Enterprise Edition, e não na instância Personal Edition.

Etapa 2: Configurar a resolução de nomes de domínio

Antes de usar um domínio Personal Edition para acessar uma instância Enterprise Edition, configure a resolução de nomes de domínio. O procedimento varia conforme o tipo de domínio.

  • Para rede privada, o Alibaba Cloud DNS PrivateZone resolve automaticamente o nome de domínio para a VPC vinculada. Nenhuma ação adicional é necessária.

  • Para internet, adicione manualmente o bloco CIDR da máquina local a uma lista de permissões de internet e configure a resolução de nomes de domínio. Esta seção usa uma conexão de internet como exemplo.

  1. Adicione uma lista de permissões de internet e obtenha o nome de domínio de internet.

    1. Faça login 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 da instância Enterprise Edition, escolha Repository > Access Control.

    5. Na página Access Control, clique em a aba Internet.

      Na aba Internet, anote o Domain address .

    6. Ative o botão Enable Access over Internet e clique em Add Internet Whitelist.

    7. Na caixa de diálogo Add Internet Whitelist, insira o intervalo de endereços do host local e uma descrição. Em seguida, clique em Confirm.

  2. Execute o comando a seguir na máquina local para obter o endereço IP do nome de domínio.

    ping <Domain name>

    Obtenha o endereço IP do nome de domínio a partir da saída do comando.

  3. Adicione a seguinte entrada ao arquivo hosts da sua máquina local e salve o arquivo.

    <IP address of the domain name> <Internet domain name of the Personal Edition instance>

Etapa 3: Acessar a instância pelo domínio Personal Edition

Após ativar o recurso de compatibilidade, use o domínio Personal Edition para fazer login na instância Enterprise Edition e enviar imagens por push para os repositórios de imagens dela.

  1. Na página Domain, obtenha o nome de domínio de internet. Neste exemplo, registry.cn-hangzhou.aliyuncs.com é utilizado.

  2. Execute o comando a seguir em um cliente Docker para fazer login na instância Enterprise Edition.

    docker login registry.cn-hangzhou.aliyuncs.com

    Insira seu nome de usuário e senha quando solicitado. A mensagem Login Succeeded indica que o login foi bem-sucedido.

  3. Faça push de uma imagem.

    1. Execute o comando a seguir para crie uma tag na imagem.

      docker tag <Image ID> registry.cn-hangzhou.aliyuncs.com/<Namespace>/<Image repository name>:<Image tag>
    2. Execute o comando a seguir para enviar a imagem por push para a instância Enterprise Edition.

      docker push registry.cn-hangzhou.aliyuncs.com/<Namespace>/<Image repository name>:<Image tag>

      Na página Repositories da instância Enterprise Edition, clique em o nome do repositório de imagens desejado e selecione Image Version. Na página Image Version, é possível visualizar a imagem enviada. Isso confirme que você acessou a instância Enterprise Edition com sucesso usando um domínio Personal Edition.

Tópicos relacionados

Para usar uma instância Enterprise Edition para fazer pull de imagens diretamente do Docker Hub, consulte Use an Enterprise Edition instance to push and pull images.