Eseguire il push di un'immagine

Esegui il push delle immagini su Harbor per una maggiore sicurezza con controllo dell'accesso basato su ruoli, l'analisi automatica delle vulnerabilità e la gestione semplificata delle immagini per le tue applicazioni containerizzate. Per eseguire il push di un'immagine locale in un'istanza Harbor, contrassegnala con il nome del repository ed esegui il push dell'immagine.

Prima di iniziare

Per eseguire il push di un'immagine, devi configurare l'ambiente con le risorse e le autorizzazioni necessarie, incluso un progetto Harbor esistente. Per saperne di più, consulta Crea progetti Harbor.

Ruoli IAM richiesti

Per eseguire il push delle immagini alle istanze del registry Harbor, contatta l'amministratore del progetto IAM per richiedere il seguente ruolo:

  • Harbor Instance Viewer (harbor-instance-viewer): recupera, elenca e monitora le istanze Harbor nello spazio dei nomi del progetto. Questo ruolo include le autorizzazioni necessarie per visualizzare i dettagli delle istanze Harbor esistenti, in modo da poter recuperare gli URL del registry necessari per eseguire il push delle immagini.

Ruoli RBAC Harbor richiesti

A differenza dei ruoli IAM di GDC, il push delle immagini richiede autorizzazioni specifiche all'interno del sistema di controllo degli accessi basato su ruoli (RBAC) interno di Harbor. Richiedi le autorizzazioni necessarie all'amministratore. Applica il principio del privilegio minimo richiedendo solo i ruoli necessari per le tue attività specifiche.

Tagga l'immagine locale

Per contrassegnare un'immagine locale con il nome del repository, segui questi passaggi:

  1. Devi aver eseguito l'autenticazione all'istanza Harbor. Per saperne di più, consulta Configura l'autenticazione Docker per le istanze del registry Harbor.

  2. Imposta il nome dell'immagine. Il formato di un nome completo dell'immagine è:

    INSTANCE_URL/HARBOR_PROJECT_NAME/IMAGE

    Sostituisci quanto segue:

    • INSTANCE_URL: l'URL dell'istanza Harbor. Ad esempio, harbor-1.org-1.zone1.google.gdc.test. Recupera l'URL dell'istanza Harbor utilizzando la console GDC o la CLI gdcloud.
    • HARBOR_PROJECT_NAME: il nome del progetto Harbor. Ad esempio, my-project.
    • IMAGE_NAME: il nome dell'immagine. Ad esempio, nginx.

    Un esempio di nome completo dell'immagine potrebbe essere il seguente:

    harbor-1.org-1.zone1.google.gdc.test/my-project/nginx

  3. Tagga l'immagine locale con il nome del repository:

    docker tag SOURCE-IMAGE
INSTANCE_URL/HARBOR_PROJECT_NAME/IMAGE:TAG

Sostituisci quanto segue:

  • SOURCE-IMAGE: il nome o l'ID dell'immagine locale. Ad esempio, nginx.
  • TAG: il nome del tag. Ad esempio, staging. Se non specifichi un tag, Docker applica il tag latest per impostazione predefinita.

Esegui il push dell'immagine con tag in un'istanza di Harbor Registry

Dopo aver aggiunto il tag all'immagine, esegui il push all'istanza del registry Harbor:

  1. Assicurati di aver eseguito l'autenticazione all'istanza Harbor.
  2. Esegui il push dell'immagine taggata con il comando:
docker push
INSTANCE_URL/HARBOR_PROJECT_NAME/IMAGE:TAG

Quando esegui il push di un'immagine, questa viene archiviata nell'istanza e nel progetto Harbor specificati.

Dopo aver eseguito il push dell'immagine, vai alla UI dell'istanza Harbor per visualizzarla.

Passaggi successivi

Dopo aver eseguito il push dell'immagine nel registry Harbor, puoi eseguirne il pull nel tuo ambiente locale per verificarla. Puoi anche configurare regole di conservazione dei tag per gestire automaticamente i repository ed esaminare i risultati delle scansioni di sicurezza per rilevare le vulnerabilità: