Todos os produtos
Search
Central de documentação

Container Service for Kubernetes:Sync images by using artifact subscription

Última atualização: Sep 18, 2026

A extração 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 artefatos permite que a instância do ACR Enterprise sincronize imagens diretamente de fontes externas ou personalizadas para seus repositórios de imagens, sem exigir configurações de rede adicionais.

Observações de uso

Este recurso está disponível apenas para as edições Basic e Advanced de uma instância do ACR Enterprise. A cota de regras de assinatura varia de acordo com a edição da instância. Para mais informações, consulte assinatura de artefatos.

Configure uma assinatura automática

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

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

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

  3. Na página Instances, clique em instância do ACR Enterprise de destino. 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 da qual assinar imagens. Se você selecionar Custom Source, o repositório de origem deve atender a todos os requisitos a seguir:

    • O repositório é compatível com o protocolo docker Registry HTTP API V2.

    • O repositório é público. Não há suporte para repositórios privados.

    • O repositório é acessível pela Internet por meio de HTTPS.

    A assinatura de artefatos oferece suporte apenas a fontes internacionais e fontes personalizadas elegíveis. Não há suporte para o uso de imagens de instâncias do ACR como fontes de assinatura.

    Source Repository Domain Name

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

    O 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

    O caminho para o repositório de imagens de origem. O caminho deve estar no formato <namespace>/<repository>. Por exemplo, library/nginx.

    Subscription Policy

    Assinar a tag da imagem no repositório de origem (Obrigatório): Uma expressão regular que especifique quais versões de imagem assinar. O valor padrão, .*, corresponde a todas as versões da imagem.

    Assinar as primeiras N imagens no repositório de origem (Obrigatório): O número de versões de imagem correspondentes a serem sincronizadas. Você pode sincronizar no máximo 5 versões do docker Hub e 30 versões de outras fontes.

    OS/Architecture

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

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

    Parâmetro

    Descrição

    Repositories

    O repositório de imagens de destino onde as imagens sincronizadas ficarão armazenadas.

    Overwrite Image

    Indica se a imagem sincronizada substituirá uma imagem existente no repositório de destino caso tenha o mesmo nome.

    Acceleration Link

    Permite sincronizar imagens mais rapidamente por meio de políticas de agendamento e otimização de links de rede.

    Update Period

    Sincroniza periodicamente as tags de imagem do repositório de origem para o repositório de destino.

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

Execute uma sincronização imediata

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

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

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

  3. Na página Instances, clique em instância do ACR Enterprise de destino. 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.