É 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
Abra a página Repositórios no console do Google Cloud.
Na lista de repositórios, selecione o repositório e clique em Editar repositório.
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.
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.