Todos os produtos
Search
Central de documentação

Container Registry:Envie e faça pull de imagens em uma instância Personal Edition

Última atualização: Jul 03, 2026

O Docker é uma plataforma de containerização, mas não oferece hospedagem nativa de imagens. Você pode enviar imagens Docker para uma instância do Container Registry (ACR) Personal Edition para obter serviços básicos de imagens de contêiner, hospedagem segura de imagens e permitir que outros usuários façam o download das imagens.

Pré-requisitos

Etapa 1: Obter o nome de usuário do registro

Faça login no console do Container Registry. Na página de gerenciamento da instância Personal Edition, escolha Repository > Access Credentials para obter seu nome de usuário.

  • Se você estiver usando uma conta Alibaba Cloud, o nome da sua conta será o nome de usuário do registro.

  • Se você estiver usando um usuário RAM, o nome de usuário do registro corresponde à parte do nome de usuário RAM antes do sufixo .onaliyun.com. Por exemplo, se o usuário RAM for XXX@10051309672****.onaliyun.com, o nome de usuário do registro será XXX@10051309672****.

Etapa 2: Definir a senha de login do registro

Redefinir senha

Se você esqueceu a senha de login do registro, pode redefini-la definindo uma senha fixa.

  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 Instances, clique na instância Personal Edition que deseja gerenciar.

  5. Na página de gerenciamento da instância Personal Edition, escolha Repository > Access Credentials.

  6. Na página Access Credentials, clique em Set Password e siga as instruções para redefinir a senha.

    Nota

    O Container Registry Personal Edition não oferece suporte ao uso da operação de API GetAuthorizationToken para obter um nome de usuário e senha temporários para login na instância. Recomendamos o uso de uma senha fixa para fazer login.

Configuração inicial de senha

Se esta for a primeira vez que você faz login no console do Container Registry, defina uma senha de login do registro para enviar e fazer pull de imagens.

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

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

  3. Na caixa de diálogo Tips, clique em Activate Now e, em seguida, clique em Reset Docker Login Password.

  4. Na caixa de diálogo Reset Docker Login Password, insira a senha nos campos Password e Confirm Password e clique em Confirm.

Etapa 3: Criar um namespace

Use um namespace para gerenciar um conjunto de repositórios de imagens, incluindo permissões e propriedades.

  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 Instances, clique na instância Personal Edition que deseja gerenciar.

  5. Na página de gerenciamento da instância Personal Edition, escolha Repository > Namespace.

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

  7. Na caixa de diálogo Create Namespace, insira um nome de namespace e clique em Confirm.

Etapa 4: Criar um repositório de imagens

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

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

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

  4. Na página de gerenciamento da instância Personal Edition, escolha Repository > Repositories.

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

  6. Na etapa Repository Info, defina Namespace, Repository Name, Repository Type, Summary e Description. Em seguida, clique em Next.

    Nota

    O nome do repositório deve ter entre 2 e 64 caracteres. Pode conter letras minúsculas, dígitos, sublinhados (_), hífens (-) e pontos (.). O nome não pode começar nem terminar com sublinhado e não pode conter barras (/).

  7. Na etapa Code Source, configure Code Source, Build Settings e Build Rules. Em seguida, clique em Create Repository.

    Parâmetro

    Descrição

    Code Source

    Selecione uma fonte de código.

    Importante

    Antes de selecionar uma fonte de código, verifique se você já vinculou uma plataforma de código-fonte. Para mais informações, consulte Vincular uma plataforma de hospedagem de código-fonte.

    Build Settings

    • Automatically Build Images When Code Changes: ao selecionar esta opção, as regras de compilação são acionadas automaticamente quando o código é enviado para um branch.

    • Build with Servers Deployed Outside Chinese Mainland: ao selecionar esta opção, as imagens são compiladas em um data center fora da China continental e enviadas para a região especificada após a compilação bem-sucedida.

    • Build Without Cache: ao selecionar esta opção, as imagens de dependência base são baixadas novamente a cada compilação, o que aumenta o tempo de compilação.

    Build Rules Setting

    Após criar o repositório, acesse a página de compilação para configurar as regras de compilação. Para mais informações, consulte Compilar um repositório e uma imagem.

Etapa 5: Enviar e fazer pull de uma imagem

A partir de 9 de setembro de 2024, o formato dos endpoints de registro para novas instâncias Personal Edition foi alterado. Para mais informações, consulte Notas de uso para novas instâncias Personal Edition. Escolha um método para enviar e fazer pull de imagens com base na versão da sua instância.

Nota

Devido a problemas na rede das operadoras, o pull de imagens de registros no exterior por meio do recurso de acelerador de imagens pode falhar. Para mais informações, consulte [Alteração de Produto] Aviso sobre ajustes no recurso de acelerador de imagens do ACR.

Novas instâncias Personal Edition

  1. Faça login no console do Container Registry. Na página de gerenciamento da instância Personal Edition, escolha Repository > Access Credentials para obter o comando de login.

    Execute o seguinte comando para fazer login no repositório de imagens.

    docker login --username=<registry-username> crpi-xxxx.cn-<region-of-your-instance>.personal.cr.aliyuncs.com

    Quando solicitado, insira a senha definida na Etapa 2: Definir a senha de login do registro. Uma mensagem login succeeded indica que o login foi bem-sucedido.

  2. Envie a imagem.

    1. Execute o seguinte comando para marcar a imagem com uma tag.

      docker tag <image-ID> crpi-xxxx.cn-<region-of-your-instance>.personal.cr.aliyuncs.com/<namespace-name>/<image-repository-name>:<tag>
    2. Execute o seguinte comando para enviar a imagem para a instância Personal Edition.

      docker push crpi-xxxx.cn-<region-of-your-instance>.personal.cr.aliyuncs.com/<namespace-name>/<image-repository-name>:<tag>

      Na página Repositories, clique no nome do repositório desejado e selecione Image Version. Se a imagem enviada aparecer na página Image Version, o envio foi bem-sucedido.

  3. Execute o seguinte comando para fazer pull da imagem.

    docker pull crpi-xxxx.cn-<region-of-your-instance>.personal.cr.aliyuncs.com/<namespace-name>/<image-repository-name>:<tag>

    Execute o comando docker images. Se a imagem baixada aparecer na saída do comando, o pull foi bem-sucedido.

Instâncias Personal Edition antigas

  1. Execute o seguinte comando para fazer login no repositório de imagens. Para obter o comando de login, faça login no console do Container Registry e, na página de gerenciamento da instância Personal Edition, escolha Repository > Access Credentials.

    docker login --username=<registry-username> registry.cn-<region-of-your-instance>.aliyuncs.com

    Quando solicitado, insira a senha definida na Etapa 2: Definir a senha de login do registro. Uma mensagem login succeeded indica que o login foi bem-sucedido.

  2. Envie a imagem.

    1. Execute o seguinte comando para marcar a imagem com uma tag.

      docker tag <image-ID> registry.cn-<region-of-your-instance>.aliyuncs.com/<namespace-name>/<image-repository-name>:<tag>
    2. Execute o seguinte comando para enviar a imagem para a instância Personal Edition.

      docker push registry.cn-<region-of-your-instance>.aliyuncs.com/<namespace-name>/<image-repository-name>:<tag>

      Na página Repositories, clique no nome do repositório desejado e selecione Image Version. Se a imagem enviada aparecer na página Image Version, o envio foi bem-sucedido.

  3. Execute o seguinte comando para fazer pull da imagem.

    docker pull registry.cn-<region-of-your-instance>.aliyuncs.com/<namespace-name>/<image-repository-name>:<tag>

    Execute o comando docker images. Se a imagem baixada aparecer na saída do comando, o pull foi bem-sucedido.

Operações relacionadas

Excluir tags de imagem em lote

  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 Instances, clique na instância Personal Edition que deseja gerenciar.

  5. Na página de gerenciamento da instância Personal Edition, escolha Repository > Repositories e clique no nome do repositório desejado.

  6. No painel de navegação à esquerda da página de detalhes do repositório, clique em Image Version.

  7. Na página Image Version, selecione o ícone Batch delete à esquerda da Tag e clique em Batch Delete.

  8. Na caixa de diálogo de confirmação, selecione I am sure to delete the images of these tags e clique em Confirm.