Image mit Docker abrufen

Rufen Sie ein Image aus einem Harbor-Projekt im Docker-Client ab, um das angegebene Container-Image aus Ihrer Harbor-Registry auf Ihren lokalen Computer herunterzuladen. So können Sie die containerisierte Anwendung lokal ausführen oder als Basis-Image zum Erstellen anderer Images verwenden.

Hinweis

Wenn Sie ein Image mit Docker abrufen möchten, müssen Sie Ihre Umgebung mit den erforderlichen Ressourcen und Berechtigungen konfigurieren, einschließlich eines vorhandenen Harbor-Projekts mit dem Container-Image, das Sie abrufen möchten. Weitere Informationen finden Sie unter Harbor-Projekte erstellen.

Erforderliche IAM-Rollen

Wenn Sie Images aus Harbor-Registry-Instanzen abrufen möchten, wenden Sie sich an Ihren IAM-Projektadministrator, um die Rolle Harbor Instance Viewer (harbor-instance-viewer) anzufordern. Mit dieser Rolle können Sie Harbor-Instanzen im Projekt-Namespace abrufen, auflisten und beobachten. Diese Rolle enthält die erforderlichen Berechtigungen zum Aufrufen der Details vorhandener Harbor-Instanzen, damit Sie die Registry-URLs abrufen können, die zum Abrufen von Images erforderlich sind.

Erforderliche Harbor-RBAC-Rollen

Im Gegensatz zu GDC-IAM-Rollen sind für das Abrufen von Images bestimmte Berechtigungen im internen RBAC-System (rollenbasierte Zugriffssteuerung) von Harbor erforderlich. Fordern Sie die erforderlichen Berechtigungen von Ihrem Administrator an. Erzwingen Sie den Zugriff mit den geringsten Berechtigungen, indem Sie nur die Rollen anfordern, die für Ihre spezifischen Aufgaben erforderlich sind.

Image abrufen

So rufen Sie ein Image aus einem Harbor-Projekt im Docker-Client ab:

  1. Achten Sie darauf, dass Sie bei der Harbor-Instanz authentifiziert sind.

  2. Image aus einem Harbor-Projekt abrufen:

    docker pull INSTANCE_URL/HARBOR_PROJECT_NAME/IMAGE:TAG

    oder

    docker pull INSTANCE_URL/HARBOR_PROJECT_NAME/IMAGE@IMAGE_DIGEST

Ersetzen Sie die folgenden Werte:

  • INSTANCE_URL: die URL der Harbor-Instanz. Beispiel: harbor-1.org-1.zone1.google.gdc.test. Sie können die URL der Harbor-Instanz über die GDC-Konsole oder die gdcloud CLI abrufen.
  • HARBOR_PROJECT_NAME: der Name des Harbor-Projekts. Beispiel: my-project
  • IMAGE: der Name des Images. Beispiel: nginx.
  • TAG: das Tag für die Image-Version, die Sie abrufen möchten. Beispiel: staging
  • IMAGE_DIGEST: der sha256-Hashwert des Image-Inhalts. Jede Version eines Images hat einen eindeutigen Image-Digest. Klicken Sie in der Benutzeroberfläche der Harbor-Instanz auf das jeweilige Image, um den Digest aufzurufen. Weitere Informationen finden Sie unter Harbor-Registry-Instanzen ansehen.

Nächste Schritte

Nachdem Sie die Verbindung durch Abrufen eines Images bestätigt haben, können Sie Ihre Artefakte verwenden, um die Anwendung in Ihrer Umgebung zu starten: