Aggiornare 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 scoprire di più su tag immagine, digest immagine e tag immagine immutabili, consulta Versioni delle immagini container.

  • Etichette del repository.
  • Impostazioni di analisi delle vulnerabilità.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per aggiornare le impostazioni del repository, chiedi all'amministratore di concederti il ruolo IAM Artifact Registry Administrator (roles/artifactregistry.admin) nel progetto Google Cloud . Per saperne di più sull'assegnazione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

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

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 Repositori

  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.
    • Attiva o disattiva i tag immagine immutabili nella sezione Tag immagine immutabili. Se attivi questa impostazione, le seguenti azioni non sono consentite:
      • Elimina un'immagine taggata.
      • Rimuovere 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.
    • Attiva o disattiva l'analisi delle vulnerabilità.

  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 questo 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

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

Per impostare i tag immagine su immutabili:

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

Per impostare i tag immagine su 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,..."

Per modificare le impostazioni di analisi delle vulnerabilità, esegui uno dei seguenti comandi:

Per disattivare l'analisi sul repository:

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

Per consentire l'analisi sul repository:

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

Sostituisci i seguenti valori:

  • REPOSITORY è il nome del repository. Se hai configurato un repository predefinito, puoi omettere questo flag per utilizzare quello predefinito.
  • PROJECT-ID è l' Google Cloud ID progetto. Se questo flag viene omesso, viene utilizzato il progetto attuale o predefinito.
  • LOCATION è la posizione regionale o multiregionale del repository. Utilizza questo flag per visualizzare i repository in una località specifica. Se hai configurato una località predefinita, puoi omettere questo flag per utilizzare quella predefinita.
  • DESCRIPTION è una descrizione del repository.
  • USERNAME è il nome utente del repository upstream.
  • SECRET_ID è il nome del tuo secret.
  • SECRET_VERSION è la versione del secret che vuoi utilizzare.
  • I due flag di impostazione dei tag, --no-immutable-tags o --immutable-tags, indicano come i tag sono associati alle versioni delle immagini.
    • --no-immutable-tags: la versione dell'immagine a cui punta il tag può cambiare. Sono consentite l'eliminazione di immagini, la rimozione di tag e la modifica della versione di un'immagine a cui fa riferimento un tag.
    • --immutable-tags: nel repository, un tag punta sempre alla stessa versione di un'immagine. Non sono consentite le seguenti azioni:
      • Elimina un'immagine taggata.
      • Rimuovere 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... è un elenco di etichette separate da virgole specificate come coppie chiave-valore. Ad esempio: team=team-1,product=example_product,stage=development. Per saperne di più sull'utilizzo delle etichette, consulta Repository di etichette.

Passaggi successivi