Todos os produtos
Search
Central de documentação

Container Registry:Configure um repositório como imutável

Última atualização: Sep 17, 2026

O Container Registry oferece suporte à imutabilidade de tags de imagem no nível do repositório. Ao ativar esse recurso, você impede a substituição de todas as tags de imagem existentes e novas, exceto a tag latest. Isso garante a consistência das tags de imagem. Esse recurso assegura o envio único de uma imagem com uma tag específica, evitando substituições acidentais.

Procedimento

  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 Enterprise Edition que deseja gerenciar.

  5. No painel de navegação à esquerda, escolha Repository > Repositories.

  6. Na página Repositories, localize o repositório desejado e clique em Manage na coluna Actions.

  7. Na página Details, clique em Edit.

  8. Na caixa de diálogo Modify Settings, selecione Immutable e clique em Confirm.

    Nota

    Para desativar a imutabilidade de tags de imagem, desmarque Immutable.

Verificação

  1. Execute o comando docker push para enviar uma nova imagem com uma tag diferente de latest para o repositório.

    docker push example-registry-vpc.cn-hangzhou.cr.aliyuncs.com/test/example:v1
  2. Envie outra imagem com a mesma tag da imagem enviada na Etapa 1.

    A solicitação de envio é negada. O sistema retorna o seguinte erro, indicando que não é possível sobrescrever a tag da imagem:

    The requested tag already exists and cannot be overwritten.
  3. Execute o comando docker push para enviar uma nova imagem com a tag latest para o repositório.

    docker push example-registry-vpc.cn-hangzhou.cr.aliyuncs.com/test/example:latest
  4. Envie outra imagem cuja tag também seja latest. Essa tag é idêntica à da imagem enviada na Etapa 3.

    O envio é bem-sucedido. A imagem sobrescreve aquela enviada na Etapa 3.

  5. Desmarque a caixa de seleção Immutable.

  6. Envie outra imagem com a mesma tag da imagem enviada na Etapa 1.

    O envio é bem-sucedido. A imagem sobrescreve aquela enviada na Etapa 1.