Atualizar as configurações do repositório

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

  • Descrição do repositório.
  • 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 padrão latest.

    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 .

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 Artifact Registry (roles/artifactregistry.admin) noprojeto. Cloud de Confiance 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 usando personalizados papéis ou outros predefinidos papéis.

Atualizar configurações

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

Console

  1. Abra a página Repositórios no Cloud de Confiance console.

    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:

    • Mude a descrição do repositório.
    • 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á é usada por outra versão da imagem no repositório.
      • Adicionar, remover ou atualizar 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 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 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 é o nome do repositório. Se você tiver configurado um repositório padrão, você pode omitir essa sinalização para usar o padrão.
  • PROJECT-ID é o Cloud de Confiance by S3NS ID do projeto. Se essa flag for omitida, o projeto atual ou padrão será usado.
  • LOCATION é o local regional do repositório. Use essa flag para visualizar repositórios em um local específico. Se você tiver configurado um local padrão, poderá omitir essa sinalização para usar o padrão.
  • DESCRIPTION é uma descrição do repositório.
  • SECRET_ID é o nome do seu 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 de 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á é 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 Rotular repositórios.