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 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 aponta para o mesmo resumo de imagem, incluindo a tag latest padrão.

    Para saber mais sobre tags de imagem, resumos de imagens e tags de imagem 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 para conceder a você o papel do IAM de administrador do Registro de artefatos (roles/artifactregistry.admin) no projeto do Google Cloud. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

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 CLI do Google Cloud.

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:

    • Alterar a descrição do repositório.
    • Atualize os detalhes de autenticação upstream do repositório remoto.

    • Ative ou desative 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.
      • Remover uma tag de uma imagem.
      • Enviar uma imagem com uma tag que já é 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 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 com o local. Use esta sinalização para ver repositórios em um local específico. Se você tiver configurado um local padrão, poderá omitir essa flag para usar o padrão.
  • DESCRIPTION com uma descrição para o 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 de imagens.
  • --no-immutable-tags: a versão da imagem para a qual a tag aponta pode mudar. Excluir imagens, remover tags e alterar a versão de uma imagem que uma tag aponta são permitidas.
  • --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:
    • Exclui uma imagem marcada.
    • Remover uma tag de uma imagem.
    • Envie por push uma imagem com uma tag que já é usada por outra versão do a imagem no repositório.
  • KEY=VALUE,... com 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.

A seguir