Todos os produtos
Search
Central de documentação

Container Registry:Sincronizar imagens usando assinatura de artefato

Última atualização: Jul 05, 2026

O pull de imagens de contêiner de registros externos, como Docker Hub, Google Container Registry (GCR) e Quay, pode falhar devido a problemas de rede. O recurso de assinatura de artefato permite que sua instância do ACR Enterprise sincronize imagens diretamente de fontes externas ou personalizadas para seus repositórios de imagens, sem exigir configurações adicionais de rede.

Observações de uso

Este recurso está disponível apenas nas edições Basic, Premium de uma instância do ACR Enterprise. A cota de regras de assinatura varia conforme a edição da instância. Para mais informações, consulte assinatura de artefato.

Configurar uma assinatura automática

Após configurar uma assinatura automática, a instância do ACR Enterprise sincroniza as imagens de contêiner com um repositório de destino conforme a regra de assinatura.

  1. Faça logon no Container Registry console.

  2. Na barra de menus superior, selecione uma região. No painel de navegação à esquerda, clique em Instances.

  3. Na página Instances, clique na instância do ACR Enterprise desejada. No painel de navegação à esquerda, escolha Repository > Artifact Subscription.

  4. Na página Artifact Subscription, clique em Create Subscription Rule. Na caixa de diálogo, configure os parâmetros a seguir e clique em Next.

    Parâmetro

    Descrição

    Artifact Source

    Selecione a fonte externa para assinar as imagens.

    Source Repository Domain Name

    Esta opção aparece apenas quando você seleciona Custom Source em Artifact Source. Este campo é obrigatório.

    Nome de domínio da fonte personalizada. Por exemplo, para uma imagem da comunidade Anolis, insira anolis-registry.cn-zhangjiakou.cr.aliyuncs.com.

    Source Repository Location

    Caminho do repositório de imagens de origem. O caminho deve estar no formato <namespace>/<repository>. Exemplo: library/nginx.

    Subscription Policy

    Versões de imagem para assinar (Obrigatório): expressão regular que define quais versões de imagem serão assinadas. O valor padrão, .*, corresponde a todas as versões de imagem.

    Assinar as primeiras N imagens no repositório de origem (Obrigatório): quantidade de versões de imagem correspondentes mais recentes a sincronizar. É possível sincronizar no máximo 5 versões do Docker Hub e até 30 versões de outras fontes.

    OS/Architecture

    Se o repositório de origem contiver imagens multiarquitetura, especifique um sistema operacional e uma arquitetura para assinar apenas as imagens dessa plataforma.

  5. Na página Repositories, defina as configurações abaixo e clique em Create Subscription Rule.

    Parâmetro

    Descrição

    Repositories

    Repositório de imagens de destino onde as imagens sincronizadas serão armazenadas.

    Overwrite Image

    Define se uma imagem existente no repositório de destino será sobrescrita caso a imagem sincronizada tenha o mesmo nome.

    Acceleration Link

    Acelera a sincronização de imagens por meio de políticas de agendamento e otimização de link de rede.

    Update Period

    Especifica o método para sincronizar atualizações do repositório de origem.

  6. Após a criação da regra, a instância do ACR Enterprise sincroniza as imagens automaticamente conforme definido. Se precisar de uma imagem antes da próxima sincronização agendada, execute uma sincronização imediata.

Executar uma sincronização imediata

Você pode acionar manualmente uma regra de assinatura para sincronizar imagens a qualquer momento.

  1. Faça logon no Container Registry console.

  2. Na barra de menus superior, selecione uma região. No painel de navegação à esquerda, clique em Instances.

  3. Na página Instances, clique na instância do ACR Enterprise desejada. No painel de navegação à esquerda, escolha Repository > Artifact Subscription.

  4. Na página Artifact Subscription, localize a regra de assinatura desejada e clique em Execute na coluna Actions.

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

    Após a conclusão da tarefa de sincronização, visualize as imagens de contêiner sincronizadas no repositório de imagens de destino.