Creare progetti Harbor

Questo documento guida sviluppatori e amministratori su come creare e verificare i progetti Harbor utilizzando la console GDC o la CLI gdcloud.

Puoi archiviare, proteggere e distribuire le immagini container nell'appliance air-gap Google Distributed Cloud (GDC) organizzandole in progetti Harbor all'interno dell'istanza tear-harbor preconfigurata. In Harbor, un progetto funge da unità logica per raggruppare gli artefatti correlati, gestire le immagini e applicare policy, controlli dell'accesso e regole di replica specifici.

Il progetto di sistema tear fornisce tear-harbor come unica istanza di Harbor disponibile, ovvero un singolo registro preconfigurato per l'intero appliance, in modo da non dover eseguire il provisioning, l'upgrade o la manutenzione di istanze di Harbor separate per ogni progetto cliente. Questa architettura centralizzata elimina il sovraccarico dell'infrastruttura e ti consente di gestire gli spazi dei nomi delle immagini, i controlli dell'accesso e l'analisi delle vulnerabilità da un unico registro condiviso. Per utilizzare questo registro condiviso per i carichi di lavoro in qualsiasi progetto cliente, devi creare i ruoli Harbor nel progetto tear e creare i progetti Harbor direttamente nel progetto tear.

Prima di iniziare

Prima di iniziare, assicurati di soddisfare i seguenti requisiti:

  • Conoscenze consigliate: assicurati di conoscere i concetti e l'architettura trattati nella panoramica del servizio Managed Harbor. È essenziale comprendere che Harbor è una risorsa condivisa ospitata nel progetto tear, perché tutte le assegnazioni di ruoli Harbor e le attività di creazione di progetti devono avere come target il progetto tear.

  • Inizializza la tua identità Harbor: devi accedere all'interfaccia utente di Harbor almeno una volta prima di tentare di creare progetti nella console. L'accesso iniziale inizializza la tua identità con il registro Harbor. Per maggiori informazioni, vedi Recuperare l'URL dell'istanza Harbor e Inizializzare l'identità Harbor.

Ruolo IAM richiesto

Per creare un progetto Harbor, incluso un progetto Harbor che intendi utilizzare in un progetto cliente, devi disporre del ruolo IAM (Identity and Access Management) Project Creator Harbor (harbor-project-creator) creato e concesso nel progetto tear per accedere all'istanza tear-harbor. Questo ruolo fornisce le autorizzazioni create, get e watch per le risorse personalizzate del progetto Harbor all'interno dell'istanza tear-harbor nel progetto tear, il che ti consente di definire nuovi spazi dei nomi delle immagini e stabilire limiti di sicurezza per le tue applicazioni containerizzate.

Per richiedere l'accesso al progetto tear, contatta l'amministratore IAM del progetto.

Recupera l'URL dell'istanza di Harbor

Per accedere alla UI di Harbor o utilizzare gcloud CLI per gestire le immagini, devi disporre dell'URL dell'endpoint esterno dell'istanza del registro:

  1. Utilizzando la CLI gdcloud, ottieni l'URL dell'istanza Harbor:

    gdcloud harbor instances describe tear-harbor --project=tear

    L'output è simile al seguente, che in genere contiene il campo externalEndpoint:

    externalEndpoint: https://harbor.tear.example.com

  2. Copia l'URL externalEndpoint per accedere alla UI di Harbor tramite il browser e per stabilire l'autenticazione di attendibilità del client.

Se non hai accesso alla CLI gdcloud, contatta il tuo operatore dell'infrastruttura (IO) per ricevere assistenza.

Inizializza l'identità di Harbor

Accedi all'interfaccia utente di Harbor almeno una volta per sincronizzare la tua identità. Questo accesso iniziale registra il tuo profilo utente nel database di Harbor, in modo che il sistema riconosca le tue autorizzazioni:

  1. In un browser, vai all'URL del registro.
  2. Accedi utilizzando le tue credenziali GDC.

Crea un progetto Harbor

Poiché tear-harbor nel progetto tear è l'unica istanza Harbor disponibile e funge da registro condiviso per l'intero appliance, devi creare tutti i progetti Harbor nel progetto tear, inclusi i progetti Harbor che archiviano immagini per i carichi di lavoro in altri progetti del cliente. Crea un progetto Harbor utilizzando la console GDC o la CLI gdcloud.

Console

Nella console GDC, segui questi passaggi nel progetto tear:

  1. Seleziona il progetto tear.
  2. Fai clic sul link Harbor Container Registry nella sezione CI/CD del menu di navigazione.
  3. Fai clic su Crea un progetto Harbor.
  4. Inserisci il nome del progetto Harbor.
  5. (Facoltativo) L'analisi delle vulnerabilità è attivata per impostazione predefinita. Per disattivare l'analisi automatica delle vulnerabilità per i progetti Harbor, fai clic sul pulsante di attivazione/disattivazione Attiva l'analisi delle vulnerabilità per il progetto. Per saperne di più, consulta Eseguire la scansione per rilevare vulnerabilità.
  6. Fai clic su Crea. Viene visualizzato un messaggio di conferma che indica che il progetto è stato creato.
  7. Accedi alla UI di Harbor per verificare di poter visualizzare il progetto Harbor.

gdcloud

Crea il progetto Harbor nel progetto tear:

gdcloud harbor harbor-projects create HARBOR_PROJECT \
  --project=tear \
  --instance=tear-harbor

Sostituisci HARBOR_PROJECT con il nome del progetto Harbor da creare.