Harbor-Projekte erstellen

In diesem Dokument wird beschrieben, wie Entwickler und Administratoren Harbor-Projekte mit der GDC-Konsole oder der gdcloud CLI erstellen und überprüfen können.

Sie können Ihre Container-Images in der Air-Gap-Appliance von Google Distributed Cloud (GDC) speichern, schützen und verteilen, indem Sie sie in Harbor-Projekten in der vorkonfigurierten tear-harbor-Instanz organisieren. In Harbor dient ein Projekt als logische Einheit zum Gruppieren verwandter Artefakte, zum Verwalten Ihrer Images und zum Anwenden bestimmter Richtlinien, Zugriffssteuerungen und Replikationsregeln.

Das tear-Systemprojekt bietet tear-harbor als einzige verfügbare Harbor-Instanz – eine einzelne, vorkonfigurierte Registry für Ihre gesamte Appliance. Sie müssen also keine separaten Harbor-Instanzen für jedes Kundenprojekt bereitstellen, aktualisieren oder verwalten. Diese zentralisierte Architektur macht Infrastruktur-Aufwand überflüssig und ermöglicht es Ihnen, Image-Namespaces, Zugriffssteuerungen und das Scannen auf Sicherheitslücken über eine gemeinsame Registry zu verwalten. Wenn Sie diese freigegebene Registry für Arbeitslasten in einem beliebigen Kundenprojekt verwenden möchten, müssen Sie Ihre Harbor-Rollen im Projekt tear erstellen und Ihre Harbor-Projekte direkt im Projekt tear erstellen.

Hinweis

Bevor Sie beginnen, sollten Sie prüfen, ob die folgenden Anforderungen erfüllt sind:

  • Empfohlenes Wissen: Machen Sie sich mit den Konzepten und der Architektur vertraut, die in der Übersicht über den Managed Harbor Service behandelt werden. Es ist wichtig zu wissen, dass Harbor eine gemeinsam genutzte Ressource ist, die im Projekt tear gehostet wird, da alle Rollenzuweisungen und Projekterstellungsaufgaben für Harbor auf das Projekt tear ausgerichtet sein müssen.

  • Harbor-Identität initialisieren: Sie müssen sich mindestens einmal in der Harbor-Benutzeroberfläche anmelden, bevor Sie versuchen, Projekte in der Konsole zu erstellen. Bei der ersten Anmeldung wird Ihre Identität in der Harbor-Registrierung initialisiert. Weitere Informationen finden Sie unter Harbor-Instanz-URL abrufen und Harbor-Identität initialisieren.

Erforderliche IAM-Rolle

Wenn Sie ein Harbor-Projekt erstellen möchten, auch wenn Sie es in einem Kundenprojekt verwenden möchten, benötigen Sie die IAM-Rolle (Identity and Access Management) „Harbor Project Creator“ (harbor-project-creator), die im Projekt tear erstellt und gewährt wurde, um auf die tear-harbor-Instanz zuzugreifen. Diese Rolle bietet Berechtigungen zum Erstellen, Abrufen und Beobachten von benutzerdefinierten Harbor-Projektressourcen in der tear-harbor-Instanz im tear-Projekt. So können Sie neue Image-Namespaces definieren und Sicherheitsgrenzen für Ihre containerisierten Anwendungen festlegen.

Wenn Sie Zugriff auf das tear-Projekt anfordern möchten, wenden Sie sich an Ihren Projekt-IAM-Administrator.

Harbor-Instanz-URL abrufen

Wenn Sie sich in der Harbor-Benutzeroberfläche anmelden oder die gcloud CLI zum Verwalten von Bildern verwenden möchten, benötigen Sie die externe Endpunkt-URL der Registry-Instanz:

  1. Rufen Sie mit der gcloud CLI die Harbor-Instanz-URL ab:

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

    Die Ausgabe sieht in etwa so aus und enthält in der Regel das Feld externalEndpoint:

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

  2. Kopieren Sie die externalEndpoint-URL, um über Ihren Browser auf die Harbor-Benutzeroberfläche zuzugreifen und die Client-Trust-Authentifizierung einzurichten.

Wenn Sie keinen Zugriff auf die gdcloud CLI haben, wenden Sie sich an Ihren Infrastrukturbetreiber (IO).

Harbor-Identität initialisieren

Melden Sie sich mindestens einmal in der Harbor-Benutzeroberfläche an, um Ihre Identität zu synchronisieren. Bei dieser ersten Anmeldung wird Ihr Nutzerprofil in der Harbor-Datenbank registriert, damit das System Ihre Berechtigungen erkennt:

  1. Rufen Sie in einem Browser die Registrierungs-URL auf.
  2. Melden Sie sich mit Ihren GDC-Anmeldedaten an.

Harbor-Projekt erstellen

Da tear-harbor im Projekt tear die einzige verfügbare Harbor-Instanz ist und als gemeinsame Registry für die gesamte Appliance dient, müssen Sie alle Harbor-Projekte im Projekt tear erstellen, einschließlich der Harbor-Projekte, in denen Bilder für Arbeitslasten in anderen Kundenprojekten gespeichert werden. Erstellen Sie ein Harbor-Projekt mit der GDC-Konsole oder der gdcloud-CLI.

Console

Führen Sie in der GDC Console die folgenden Schritte im tear-Projekt aus:

  1. Wählen Sie das Projekt tear aus.
  2. Klicken Sie im Navigationsmenü im Bereich CI/CD auf den Link Harbor Container Registry.
  3. Klicken Sie auf Harbor-Projekt erstellen.
  4. Geben Sie den Namen des Harbor-Projekts ein.
  5. Optional: Das Scannen auf Sicherheitslücken ist standardmäßig aktiviert. Wenn Sie das automatische Scannen auf Sicherheitslücken für Harbor-Projekte deaktivieren möchten, klicken Sie auf den Ein/Aus-Button Sicherheitslückenscan für das Projekt aktivieren. Weitere Informationen finden Sie unter Auf Sicherheitslücken prüfen.
  6. Klicken Sie auf Erstellen. Es wird eine Bestätigungsmeldung angezeigt, dass Ihr Projekt erstellt wurde.
  7. Melden Sie sich in der Harbor-Benutzeroberfläche an, um zu bestätigen, dass Sie das Harbor-Projekt aufrufen können.

gdcloud

Erstellen Sie das Harbor-Projekt im Projekt tear:

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

Ersetzen Sie HARBOR_PROJECT durch den Namen des zu erstellenden Harbor-Projekts.