Aggiorna le impostazioni del repository

Puoi aggiornare le seguenti impostazioni del repository:

  • Descrizione del repository.

  • Dettagli di autenticazione upstream del repository remoto.

  • Tag immagine immutabili per i repository Docker. Se attivi questa impostazione, un tag immagine rimanda sempre allo stesso digest immagine, incluso il tag latest predefinito.

    Per ulteriori informazioni su tag immagine, sintesi delle immagini e tag immagine immutabili, consulta Versioni immagine container.

  • Etichette del repository:

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per aggiornare le impostazioni del repository, chiedi all'amministratore di concederti il ruolo IAM Amministratore del registry di elementi (roles/artifactregistry.admin) nel progetto Google Cloud. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite la ruoli o altri ruoli predefiniti ruoli.

Aggiorna impostazioni

Puoi aggiornare le impostazioni utilizzando la console Google Cloud o Google Cloud CLI.

Console

  1. Apri la pagina Repository nella console Google Cloud.

    Apri la pagina Repository

  2. Nell'elenco dei repository, seleziona il repository e fai clic su Modifica repository.

  3. Modifica le impostazioni che vuoi cambiare:

    • Modifica la descrizione del repository.
    • Aggiorna i dettagli di autenticazione upstream del repository remoto.

    • Abilita o disabilita i tag immagine immutabili nel Tag immagine immutabili. Se attivi questa impostazione, non sono consentite le seguenti azioni:

      • Eliminare un'immagine taggata.
      • Rimuovi un tag da un'immagine.
      • Esegui il push di un'immagine con un tag già utilizzato da un'altra versione dell'immagine nel repository.
      • Aggiungi, rimuovi o aggiorna le etichette.

  4. Fai clic su Salva.

gcloud

Per modificare la descrizione del repository, esegui questo comando:

gcloud artifacts repositories update REPOSITORY \
    --project=PROJECT-ID \
    --location=LOCATION \
    --description="DESCRIPTION"

Per aggiornare i dettagli di autenticazione upstream del repository remoto, esegui il comando seguente:

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

Per modificare la mutabilità del tag immagine, esegui uno dei seguenti comandi:

Per impostare i tag immagine come immutabili:

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

Per impostare i tag immagine come modificabili:

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

Per aggiornare le etichette, esegui questo comando:

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

Sostituisci i seguenti valori:

  • REPOSITORY con il nome del repository. Se hai configurato un repository predefinito, puoi omettere questo flag per utilizzare quello predefinito.
  • PROJECT-ID con l'ID progetto Google Cloud. Se questo flag viene omesso, viene utilizzato il progetto corrente o predefinito.
  • LOCATION con una o più regioni località. Utilizza questo flag per visualizzare i repository in una posizione specifica. Se hai configurato una posizione predefinita, puoi omettere questo flag per utilizzare quella predefinita.
  • DESCRIPTION con una descrizione per il repository.
  • USERNAME con il nome utente del repository upstream.
  • SECRET_ID con il nome del tuo secret.
  • SECRET_VERSION con la versione del secret che vuoi per gli utilizzi odierni.
  • TAG-SETTING indica in che modo i tag vengono associati alle versioni delle immagini.
  • --no-immutable-tags: la versione dell'immagine a cui fa riferimento il tag può cambiare. Sono consentite l'eliminazione delle immagini, la rimozione dei tag e la modifica della versione di un'immagine a cui rimanda un tag.
  • --immutable-tags: nel repository, un tag rimanda sempre alla stessa versione di un'immagine. Non sono consentite le seguenti azioni:
    • Eliminare un'immagine taggata.
    • Rimuovi un tag da un'immagine.
    • Esegui il push di un'immagine con un tag già utilizzato da un'altra versione dell'immagine nel repository.
  • KEY=VALUE,... con un elenco di etichette separate da virgole specificate come coppie chiave/valore. Ad esempio: team=team-1,product=example_product,stage=development. Per ulteriori informazioni sull'utilizzo delle etichette, consulta Repositori di etichette.