Atualizar as configurações do repositório

É possível atualizar as seguintes configurações do repositório:

  • Descrição do repositório.

  • Detalhes de autenticação de upstream do repositório remoto.

  • Tags de imagem imutáveis para repositórios do Docker. Se você ativar essa configuração, uma tag de imagem sempre apontará para o mesmo resumo de imagem, incluindo a tag latest padrão.

    Para saber mais sobre tags de imagem, resumos de imagens e tags imutáveis, consulte Versões de imagens de contêiner.

  • Rótulos do repositório.

Funções exigidas

Para receber as permissões necessárias para atualizar as configurações do repositório, peça ao administrador que conceda a você o papel do IAM Administrador do Artifact Registry (roles/artifactregistry.admin) no projeto do Google Cloud. Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.

Também é possível conseguir as permissões necessárias por meio de papéis personalizados ou de outros papéis predefinidos.

Atualizar configurações

É possível atualizar as configurações usando o console do Google Cloud ou a Google Cloud CLI.

Console

  1. Abra a página Repositórios no console do Google Cloud.

    Abrir a página Repositórios

  2. Na lista de repositórios, selecione o repositório e clique em Editar repositório.

  3. Edite as configurações que você quer mudar:

    • Altere a descrição do repositório.
    • Atualize os detalhes de autenticação upstream do repositório remoto.
    • Ative ou desative as tags de imagem imutáveis na seção Tags de imagem imutáveis. Se você ativar essa configuração, as seguintes ações não serão permitidas:

      • Excluir uma imagem marcada.
      • Remova uma tag de uma imagem.
      • Envie uma imagem com uma tag que já esteja sendo usada por outra versão da imagem no repositório.
      • Adicione, remova ou atualize rótulos.
  4. Clique em Salvar.

gcloud

Para editar a descrição do repositório, execute o seguinte comando:

gcloud artifacts repositories update REPOSITORY \
    --project=PROJECT-ID \
    --location=LOCATION \
    --description="DESCRIPTION"

Para atualizar os detalhes de autenticação do upstream do repositório remoto, execute o seguinte comando:

gcloud artifacts repositories update REPOSITORY \
    --project=PROJECT_ID \
    --location=LOCATION \
    --remote-username=USERNAME \
    --remote-password-secret-version=projects/PROJECT_ID/secrets/SECRET_ID/versions/SECRET_VERSION

Para editar a mutabilidade da tag de imagem, execute um dos seguintes comandos:

Para definir tags de imagem como imutáveis:

gcloud artifacts repositories update REPOSITORY \
    --project=PROJECT-ID \
    --location=LOCATION \
    --immutable-tags

Para definir tags de imagem como mutáveis:

gcloud artifacts repositories update REPOSITORY \
    --project=PROJECT-ID \
    --location=LOCATION \
    --no-immutable-tags

Para atualizar os rótulos, execute o seguinte comando:

gcloud artifacts repositories update REPOSITORY \
    --project=PROJECT-ID \
    --location=LOCATION \
    --update-labels="KEY=VALUE,..."

Substitua os seguintes valores:

  • REPOSITORY pelo nome do repositório. Se você tiver configurado um repositório padrão, será possível omitir essa sinalização para usar o padrão.
  • PROJECT-ID pelo ID do projeto do Google Cloud. Se essa sinalização for omitida, o projeto atual ou padrão será usado.
  • LOCATION pelo localregional ou multirregional Use esta sinalização para ver repositórios em um local específico. Se você configurou um local padrão, omita essa sinalização para usar o padrão.
  • DESCRIPTION por uma descrição do repositório.
  • USERNAME pelo nome de usuário do repositório upstream.
  • SECRET_ID pelo nome do secret.
  • SECRET_VERSION pela versão do secret que você quer usar.
  • TAG-SETTING indica como as tags são associadas às versões das imagens.
  • --no-immutable-tags: a versão de imagem para a qual a tag aponta pode mudar. Excluir imagens, remover tags e alterar a versão de uma imagem para onde uma tag aponta são permitidos.
  • --immutable-tags: no repositório, uma tag sempre aponta para a mesma versão de uma imagem. As seguintes ações não são permitidas:
    • Excluir uma imagem marcada.
    • Remova uma tag de uma imagem.
    • Envie uma imagem com uma tag que já esteja sendo usada por outra versão da imagem no repositório.
  • KEY=VALUE,... por uma lista de rótulos separados por vírgulas especificados como pares de chave-valor. Por exemplo, team=team-1,product=example_product,stage=development. Para mais informações sobre como trabalhar com rótulos, consulte Repositórios de rótulos.