Atualize as definições do repositório

Pode atualizar as seguintes definições do repositório:

  • Descrição do repositório.
  • Detalhes de autenticação a montante do repositório remoto.
  • Etiquetas de imagens imutáveis para repositórios Docker. Se ativar esta definição, uma etiqueta de imagem aponta sempre para o mesmo resumo da imagem, incluindo a etiqueta latest predefinida.

    Para saber mais sobre etiquetas de imagens, resumos de imagens e etiquetas de imagens imutáveis, consulte o artigo Versões de imagens de contentores.

  • Etiquetas do repositório.
  • Definições de análise de vulnerabilidades.

Funções necessárias

Para receber as autorizações de que precisa para atualizar as definições do repositório, peça ao seu administrador para lhe conceder a função do IAM Administrador do Artifact Registry (roles/artifactregistry.admin) no Google Cloud projeto. Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

Atualize as definições

Pode atualizar as definições através da Google Cloud consola ou da CLI Google Cloud.

Consola

  1. Abra a página Repositórios na Google Cloud consola.

    Abra a página Repositórios

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

  3. Edite as definições que quer alterar:

    • Altere a descrição do repositório.
    • Atualize os detalhes de autenticação a montante do repositório remoto.
    • Ative ou desative as etiquetas de imagens imutáveis na secção Etiquetas de imagens imutáveis. Se ativar esta definição, as seguintes ações não são permitidas:
      • Elimine uma imagem etiquetada.
      • Remova uma etiqueta de uma imagem.
      • Enviar uma imagem com uma etiqueta que já é usada por outra versão da imagem no repositório.
      • Adicione, remova ou atualize etiquetas.
    • Ative ou desative a análise de vulnerabilidades.

  4. Clique em Guardar.

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 a montante 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 capacidade de alteração da etiqueta de imagem, execute um dos seguintes comandos:

Para definir etiquetas de imagens como imutáveis:

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

Para definir etiquetas de imagens como mutáveis:

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

Para atualizar etiquetas, execute o seguinte comando:

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

Para editar as definições de análise de vulnerabilidades, execute um dos seguintes comandos:

Para desativar a análise no repositório:

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

Para permitir a análise 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 configurou um repositório predefinido, pode omitir esta flag para usar o predefinido.
  • PROJECT-ID é o Google Cloud ID do projeto. Se esta flag for omitida, é usado o projeto atual ou predefinido.
  • LOCATION é a localização regional ou multirregional do repositório. Use esta flag para ver repositórios numa localização específica. Se configurou uma localização predefinida, pode omitir esta flag para usar a predefinição.
  • DESCRIPTION é uma descrição do repositório.
  • USERNAME é o nome de utilizador do seu repositório upstream.
  • SECRET_ID é o nome do seu segredo.
  • SECRET_VERSION é a versão do segredo que quer usar.
  • Os dois indicadores de definição de etiquetas, --no-immutable-tags ou --immutable-tags, indicam como as etiquetas estão associadas às versões das imagens.
    • --no-immutable-tags: a versão da imagem para a qual a etiqueta aponta pode mudar. A eliminação de imagens, a remoção de etiquetas e a alteração da versão de uma imagem para a qual uma etiqueta aponta são permitidas.
    • --immutable-tags: no repositório, uma etiqueta aponta sempre para a mesma versão de uma imagem. As seguintes ações não são permitidas:
      • Elimine uma imagem etiquetada.
      • Remova uma etiqueta de uma imagem.
      • Enviar uma imagem com uma etiqueta que já é usada por outra versão da imagem no repositório.

  • KEY=VALUE... é uma lista de etiquetas separadas por vírgulas especificadas como pares de chave-valor. Por exemplo: team=team-1,product=example_product,stage=development. Para mais informações sobre como trabalhar com etiquetas, consulte o artigo Etiquete repositórios.

O que se segue?