Todos os produtos
Search
Central de documentação

Container Registry:Replicar imagens na mesma conta

Última atualização: Jul 03, 2026

Configure uma regra de replicação para copiar imagens de contêiner de uma instância de origem para uma instância de destino entre regiões.

Observações de uso

  • A instância de origem deve ser da Premium Edition ou . A instância de destino pode ser das edições Basic Edition ou Premium Edition.

    Para atualizar uma instância Enterprise Edition, acesse o Container Registry console e clique em Upgrade no canto inferior direito do cartão da instância.
  • A replicação de uma região de nuvem pública para uma região de nuvem não pública, como Finance Cloud ou Gov Cloud, não é suportada.

  • Algumas regiões têm restrições específicas, como a falta de acesso à rede pública para um bucket do OSS. Nesses casos, use apenas links de replicação personalizados.

Replicação automática na mesma conta

Uma regra de replicação copia automaticamente as imagens de contêiner para uma instância de destino na mesma conta sempre que uma nova imagem é enviada (push) para a instância de origem.

Importante

A replicação automática aplica-se somente a novas imagens enviadas após a criação da regra; ela não se aplica a imagens existentes.

Para replicar imagens existentes, adote uma das seguintes abordagens:

  • Se houver poucas imagens existentes, replique-as manualmente. Para mais informações, consulte Replicação manual na mesma conta e CreateRepoSyncTask.

  • Para um grande volume de imagens existentes, recomendamos o método replicação do OSS e importação de imagens do ACR:

    1. Copie todos os arquivos do bucket do OSS da instância de origem para o bucket do OSS da instância de destino. Para mais detalhes, consulte Replicação de dados.

    2. Crie uma regra de importação com a origem da migração definida como um bucket do OSS. Em seguida, inicie a tarefa de importação de imagens para migrá-las.

A replicação automática na mesma conta suporta os níveis de namespace e repositório. Os seguintes requisitos se aplicam:

  • Ao replicar imagens no nível de namespace, as instâncias de origem e de destino devem ter namespaces idênticos. O recurso de criação automática de repositórios deve estar ativado para esses namespaces.

  • Na replicação no nível de repositório, as instâncias de origem e de destino devem ter o mesmo namespace e repositório.

  1. Faça login no Container Registry console.

  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. No painel de navegação à esquerda, escolha Distribution > Instance Replication. Em seguida, clique em Create Rule.

  6. No assistente de configuração Instance da caixa de diálogo Create Rule, defina os parâmetros e clique em Next.

    Parâmetro

    Descrição

    Rule Name

    Insira um nome para a regra de replicação.

    Replication Scenario

    Selecione Same Account.

    Destination Instance

    Selecione a região e o nome da instância de destino.

    Nota

    É possível replicar imagens automaticamente entre regiões sem expor endpoints públicos, o que reduz riscos de segurança associados ao acesso pela rede pública.

  7. Na caixa de diálogo Create Rule, configure os parâmetros no assistente Replication Information e clique em Create Rule.

    Parâmetro

    Descrição

    Replication Level

    Permite replicar imagens no nível de namespace ou de repositório.

    Source Address

    • Se definir Replication Level como Namespace, selecione um namespace e insira uma expressão regular para filtrar tags.

    • Se definir Replication Level como Repository, selecione um namespace e um repositório e insira uma expressão regular para filtrar tags.

    O envio de uma nova imagem de contêiner para um repositório correspondente à regra aciona automaticamente uma tarefa de replicação.

    Para visualizar as tarefas de replicação, escolha Distribution > Replication Record no painel de navegação à esquerda.

Replicação manual na mesma conta

Replique manualmente uma imagem de contêiner específica de uma instância de origem para uma instância de destino na mesma conta.

  1. Faça login no Container Registry console.

  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. No painel de navegação à esquerda da página de gerenciamento da instância Enterprise Edition, escolha Repository > Repositories.

  6. Na página Repositories, clique no nome do repositório de destino.

  7. No painel de navegação à esquerda, clique em Image Version. Localize a tag desejada e clique em Replication na coluna Actions.

  8. Na caixa de diálogo Sync, defina Replication Scenario como Same Account. Selecione a região e o nome da instância de destino, escolha o namespace de destino e insira o nome do repositório e a tag. Por fim, especifique se deseja sobrescrever uma imagem existente com o mesmo nome e clique em Confirm.

    Para verificar a replicação, acesse Distribution > Replication Record. Se o status da tarefa na página Replication Record for Completed e a imagem replicada estiver disponível na instância de destino, a replicação manual foi concluída com sucesso.

Tópicos relacionados

Para replicar imagens entre contas diferentes, consulte Replicar imagens entre contas.