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

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

  • Rótulos do repositório.
  • Configurações de verificação de vulnerabilidades.

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

Console

  1. Abra a página Repositórios no console 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 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.
      • Remover uma tag de uma imagem.
      • Enviar uma imagem com uma tag que já está sendo usada por outra versão da imagem no repositório.
      • Adicione, remova ou atualize rótulos.
    • Ative ou desative a verificação de vulnerabilidades.

  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 as 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,..."

Para editar as configurações da verificação de vulnerabilidades, execute um dos seguintes comandos:

Para desativar a verificação no repositório:

gcloud artifacts repositories update REPOSITORY \
    --project=PROJECT-ID \
    --location=LOCATION \
    --disable-vulnerability-scanning

Para permitir a verificação no repositório:

gcloud artifacts repositories update REPOSITORY \
    --project=PROJECT-ID \
    --location=LOCATION \
    --allow-vulnerability-scanning

Substitua os seguintes valores:

  • REPOSITORY é o nome do repositório. Se você tiver configurado um repositório padrão, poderá omitir essa flag para usar o padrão.
  • PROJECT-ID é o ID do projeto do Google Cloud . Se essa flag for omitida, o projeto atual ou padrão será usado.
  • LOCATION é o local regional ou multirregional do repositório. Use essa flag para conferir 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 é uma descrição do repositório.
  • USERNAME é o nome de usuário do repositório upstream.
  • SECRET_ID é o nome do secret.
  • SECRET_VERSION é a versão do secret que você quer usar.
  • As duas flags de configuração de tag, --no-immutable-tags ou --immutable-tags, indicam como as tags são associadas a versões de imagens.
    • --no-immutable-tags: a versão da imagem para a qual a tag aponta pode mudar. É permitido excluir imagens, remover tags e mudar a versão de uma imagem para a qual uma tag aponta.
    • --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.
      • Remover uma tag de uma imagem.
      • Enviar uma imagem com uma tag que já está sendo usada por outra versão da imagem no repositório.

  • KEY=VALUE... é 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