Docker Hub-Remote-Repository erstellen

Docker Hub-Remote-Repository erstellen

Erstellen Sie ein Remote-Repository, das als Proxy für Docker Hub dient.

Hinweise

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Artifact Registry, Secret Manager APIs.

   Enable the APIs

5. Install the Google Cloud CLI.

6. To initialize the gcloud CLI, run the following command:

   gcloud init

   Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.

7. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

8. Make sure that billing is enabled for your Google Cloud project.

9. Enable the Artifact Registry, Secret Manager APIs.

   Enable the APIs

10. Install the Google Cloud CLI.

11. To initialize the gcloud CLI, run the following command:

    gcloud init

    Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
12. Erstellen Sie ein Docker Hub-Konto.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen eines Remote-Repositories in Docker Hub benötigen:

• Sie benötigen die Rolle Artifact Registry Administrator (roles/artifactregistry.admin) für das Projekt, um Remote-Repositories zu erstellen und Zugriff auf einzelne Repositories zu gewähren.
• Zum Erstellen und Verwalten von Secrets: Secret Manager-Administratorrolle (roles/secretmanager.admin) für das Projekt

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Shell auswählen

Sie können diese Kurzanleitung entweder in Cloud Shell oder in Ihrer lokalen Shell ausführen.

Cloud Shell

Cloud Shell ist eine Shell-Umgebung für die Verwaltung von Ressourcen, die in Google Cloudgehostet werden. Dort sind Docker und die Google Cloud CLI, die primäre Befehlszeile für Google Cloud, vorinstalliert.

Lokale Shell

Wenn Sie Ihre lokale Shell bevorzugen, müssen Sie in Ihrer Umgebung Docker und die gcloud CLI installieren.

Cloud Shell starten

So starten Sie Cloud Shell:

1. Rufen Sie die Google Cloud -Konsole auf.

   Google Cloud Console

2. Klicken Sie auf die Schaltfläche Cloud Shell aktivieren: .

In einem Frame im unteren Teil der Console wird eine Cloud Shell-Sitzung geöffnet. Mit dieser Shell führen Sie gcloud-Befehle aus.

Lokale Shell einrichten

So installieren Sie die gcloud CLI und Docker:

1. Installieren Sie das gcloud-CLI. Führen Sie den Befehl gcloud components update aus, um eine vorhandene Installation zu aktualisieren.

   Hinweis: Unter Ubuntu verwenden Sie das Debian-Paket, um die gcloud CLI zu installieren. Das Snap-Paket der gcloud CLI enthält weder kubectl noch Erweiterungen zur Authentifizierung bei Artifact Registry mithilfe der gcloud CLI.

2. Installieren Sie Docker, falls es noch nicht installiert ist.

3. Docker benötigt für die Interaktion mit Registries Zugriff. Fügen Sie unter Linux oder Windows den Nutzer hinzu, mit dem Sie Docker-Befehle in der Docker-Sicherheitsgruppe ausführen. Dieser Schritt ist unter macOS nicht erforderlich, da Docker Desktop auf einer virtuellen Maschine als Root-Nutzer ausgeführt wird.

   Linux

   Die Docker-Sicherheitsgruppe heißt docker. Führen Sie den folgenden Befehl aus, um Ihren Nutzernamen hinzuzufügen:

   sudo usermod -a -G docker ${USER}
   

   Windows

   Die Docker-Sicherheitsgruppe heißt docker-users. Führen Sie den folgenden Befehl aus, um einen Nutzer über die Administrator-Eingabeaufforderung hinzuzufügen:

   net localgroup docker-users DOMAIN\USERNAME /add
   

   Dabei gilt:

   • DOMAIN ist Ihre Windows-Domain.
   • USERNAME Ihr Nutzername ist.
   Hinweis: Die Docker-Sicherheitsgruppe hat dieselben Zugriffsrechte wie der Root- oder Administratornutzer. Fügen Sie nur vertrauenswürdige Nutzer hinzu, die Zugriff auf Docker benötigen. Weitere Informationen zu den Auswirkungen auf die Sicherheit finden Sie unter Sicherheit des Docker-Daemon.

4. Melden Sie sich ab und wieder an, damit Änderungen an der Gruppenmitgliedschaft wirksam werden. Wenn Sie eine virtuelle Maschine verwenden, müssen Sie sie unter Umständen neu starten, damit die Mitgliedschaftsänderungen wirksam werden.

5. Prüfen Sie mit dem folgenden Docker-Befehl, durch den die aktuelle Zeit und das aktuelle Datum zurückgegeben werden, ob Docker ausgeführt wird:

   docker run --rm busybox date
   

   Das Flag --rm löscht die Containerinstanz beim Beenden.

Docker Hub-Authentifizierung konfigurieren

Wenn Sie verhindern möchten, dass ein nicht authentifiziertes Docker Hub-Kontingent verwendet wird, sollten Sie sich bei der Verwendung von Remote-Repositories bei Docker Hub authentifizieren. Bei Remote-Repositories können Sie Ihren Docker Hub-Nutzernamen und ein persönliches Zugriffstoken hinzufügen, das als Secret zum Authentifizieren bei Docker Hub gespeichert ist.

Persönliches Docker Hub-Zugriffstoken erstellen

1. Melden Sie sich bei Docker Hub an.
2. Erstellen Sie ein persönliches Zugriffstoken mit Lesezugriffsberechtigungen.

3. Kopieren Sie das Zugriffstoken.

   Warnung :Das Zugriffstoken wird nur einmal angezeigt. Wenn Sie das Fenster schließen, kann es nicht wiederhergestellt werden und Sie müssen ein neues Zugriffstoken erstellen.

4. Speichern Sie das Zugriffstoken in einer Textdatei in Ihrer lokalen oder Cloud Shell.

   Warnung :Behandeln Sie Zugriffstokens wie Passwörter und bewahren Sie sie sicher auf.

Persönliches Zugriffstoken in einem Secret speichern

Console

1. Rufen Sie in der Google Cloud -Konsole die Seite Secret Manager auf.

   Zur Seite "Secret Manager"

2. Klicken Sie auf der Seite Secret Manager auf Secret erstellen.

3. Geben Sie auf der Seite Secret erstellen unter Name den Namen my-secret für das Secret ein.

4. Geben Sie im Feld Secret-Wert Ihr persönliches Docker Hub-Zugriffstoken ein.

5. Lassen Sie den Abschnitt Regionen unverändert.

6. Klicken Sie auf Secret erstellen.

gcloud-CLI

gcloud secrets create my-secret --data-file="/path/to/file.txt"

Dabei ist /path/to/file.txt der Speicherort der Textdatei mit Ihrem persönlichen Zugriffstoken.

Gewähren Sie dem Artifact Registry-Dienstkonto Zugriff auf Ihr Secret

Console

1. Rufen Sie in der Google Cloud -Konsole die Seite Secret Manager auf.

   Zur Seite "Secret Manager"

2. Klicken Sie auf der Seite Secret Manager auf das Kästchen neben my-secret.

3. Falls das Fenster noch nicht geöffnet ist, klicken Sie auf Infofeld ansehen, um es zu öffnen.

4. Klicken Sie im Infofeld auf Hauptkonto hinzufügen.

5. Geben Sie im Textfeld Neue Hauptkonten die E-Mail-Adresse des Artifact Registry-Dienstkontos ein. Die E-Mail-Adresse des Artifact Registry-Dienstkontos ist so formatiert:

   [e-mail]

   Dabei ist PROJECT-NUMBER die Projektnummer.

   So finden Sie Ihre Projektnummer:

   • Rufen Sie in der Google Cloud -Console die Seite Dashboard auf.

     Seite „Dashboard“ öffnen

   • Klicken Sie oben auf der Seite auf das Drop-down Auswählen aus.

   • Wählen Sie im angezeigten Fenster Auswählen aus Ihr Projekt aus.

     Die Projekt-ID und die Projektnummer werden auf der Dashboard-Karte Projektinformationen des Projekts angezeigt.

6. Wählen Sie im Drop-down-Menü Rolle auswählen die Option Secret Manager und dann Zugriffsfunktion für Secret Manager-Secret aus.

gcloud-CLI

gcloud secrets add-iam-policy-binding my-secret \
    --member="serviceAccount:[e-mail]" \
    --role="roles/secretmanager.secretAccessor"

Dabei ist PROJECT-NUMBER die Projektnummer Ihres Projekts.

So finden Sie Ihre Projektnummer:

• Rufen Sie in der Google Cloud -Console die Seite Dashboard auf.

  Seite „Dashboard“ öffnen

• Klicken Sie oben auf der Seite auf das Drop-down Auswählen aus.

• Wählen Sie im angezeigten Fenster Auswählen aus Ihr Projekt aus.

  Die Projekt-ID und die Projektnummer werden auf der Dashboard-Karte Projektinformationen des Projekts angezeigt.

Remote-Repository erstellen

Erstellen Sie ein Artifact Registry-Remote-Repository mit dem Namen quickstart-docker-hub-remote am Speicherort us-central1 mit Ihren Docker Hub-Anmeldedaten. Führen Sie dazu den folgenden Befehl aus:

gcloud artifacts repositories create quickstart-docker-hub-remote \
    --project=PROJECT_ID \
    --repository-format=DOCKER  \
    --location=us-central1 \
    --description="Remote Docker repository" \
    --mode=remote-repository \
    --remote-repo-config-desc="Docker Hub" \
    --remote-docker-repo=DOCKER-HUB \
    --remote-username=USERNAME \
    --remote-password-secret-version=projects/PROJECT/secrets/my-secret/versions/1

Wobei:

• quickstart-docker-hub-remote ist der Name des Repositorys. Repository-Namen können für jeden Repository-Speicherort in einem Projekt nur einmal vorkommen.
• PROJECT_ID ist die Projekt-ID. Wenn dieses Flag nicht angegeben ist, wird das aktuelle Projekt oder das Standardprojekt verwendet.
• us-central1 ist der regionale oder multiregionale Standort für das Repository. Sie können dieses Flag weglassen, wenn Sie einen Standard-Speicherort festgelegt haben. Führen Sie den Befehl gcloud artifacts locations list aus, um eine Liste der unterstützten Speicherorte aufzurufen.
• "Remote Docker repository" ist die optionale Beschreibung Ihres Repositorys. Geben Sie keine vertraulichen Daten an, da Repository-Beschreibungen nicht verschlüsselt werden.
• "Docker Hub" ist die optionale Beschreibung für die externe Repositorykonfiguration für dieses Remote-Repository.
• DOCKER-HUB legt das Remote-Repository als Upstream zum öffentlichen Docker Hub-Upstream fest.
• USERNAME ist Ihr Docker Hub-Nutzername.
• projects/PROJECT/secrets/my-secret/versions/1 ist die Secret-Version, die Sie zum Speichern Ihres persönlichen Zugriffstokens für Docker Hub erstellt haben.

Artifact Registry erstellt das Repository und fügt es der Liste der Repositories hinzu.

Docker-Authentifizierung konfigurieren

Bevor Sie Images hoch- oder herunterladen können, müssen Sie Docker so konfigurieren, dass die Google Cloud CLI zum Authentifizieren von Anfragen an Artifact Registry verwendet wird.

1. Melden Sie sich in der gcloud CLI als Nutzer an, der Docker-Befehle ausführt.

   gcloud auth login
   

2. Um die Authentifizierung für Docker-Repositories in der Region us-central1 einzurichten, führen Sie folgenden Befehl aus:

   gcloud auth configure-docker us-central1-docker.pkg.dev
   

   Durch den Befehl wird die Docker-Konfiguration aktualisiert. Sie können jetzt eine Verbindung zu Artifact Registry in Ihrem Google Cloud -Projekt herstellen, um Images zu übertragen und abzurufen.

Informationen zu anderen Authentifizierungsmethoden finden Sie unter Authentifizierungsmethoden.

Image in Ihr Remote-Repository herunterladen

1. Melden Sie sich in der gcloud CLI als Nutzer an, der Docker-Befehle ausführt.

   gcloud auth login
   

2. Mit dem folgenden Befehl können Sie ein Image von Docker Hub auf Ihren Computer und in Ihr Remote-Repository herunterladen:

   docker pull us-central1-docker.pkg.dev/PROJECT/quickstart-docker-hub-remote/busybox:latest
   

   Wobei:

   • us-central1 ist der Speicherort des Remote-Repositorys.
   • us-central1-docker.pkg.dev ist der Hostname des von Ihnen erstellten Docker-Repositorys.
   • PROJECT ist die Projekt-ID Ihres Google Cloud-Kontos. Wenn die Projekt-ID einen Doppelpunkt (:) enthält, finden Sie weitere Informationen unter Auf Domains beschränkte Projekte.
   • quickstart-docker-hub-remote ist die ID des von Ihnen erstellten Repositorys.
   • busybox ist der Name des Images, das Sie aus Docker Hub in quickstart-docker-hub-remote abrufen möchten.
   • latest ist die getaggte Image-Version, die Sie aus Docker Hub abrufen möchten.

   Das Image wird auf Ihren Computer heruntergeladen und im Remote-Repository im Cache gespeichert. Wenn Sie dasselbe getaggte Bild noch einmal abrufen, wird es aus Ihrem Remote-Repository abgerufen. Ihre Docker Hub-Anmeldedaten werden verwendet.

3. Liste der in Ihrem Remote-Repository gespeicherten Artefakte auflisten:

   gcloud artifacts packages list \
       --location=us-central1 \
       --repository=quickstart-docker-hub-remote
   

   Die Ausgabe sollte so aussehen:

   Listing items under project my-project, location us-central1, repository quickstart-docker-hub-remote.
   
   PACKAGE: busybox
   CREATE_TIME: 2023-06-19T18:59:09
   UPDATE_TIME: 2023-06-19T18:59:10
   

Bereinigen

Mit den folgenden Schritten vermeiden Sie, dass Ihrem Google Cloud -Konto die in dieser Anleitung verwendeten Ressourcen in Rechnung gestellt werden:

Repository löschen

Wenn Sie Ihr Projekt behalten und nur die Repository-Ressource löschen möchten, folgen Sie der Anleitung in diesem Abschnitt. Wenn Sie das gesamte Projekt löschen möchten, folgen Sie der Anleitung unter Projekt löschen.

Prüfen Sie vor dem Entfernen des Repositorys, ob alle Images, die Sie beibehalten möchten, an einem anderen Speicherort verfügbar sind.

So löschen Sie das Repository:

Console

1. Öffnen Sie in der Google Cloud -Konsole die Seite Repositories.

   Zur Seite „Repositories“

2. Wählen Sie in der Repository-Liste das Repository quickstart-docker-hub-remote aus.

3. Klicken Sie auf Löschen.

gcloud

Um das Repository quickstart-docker-hub-remote zu löschen, führen Sie folgenden Befehl aus:

gcloud artifacts repositories delete quickstart-docker-hub-remote \
    --location=us-central1

Projekt löschen

Achtung: Das Löschen von Projekten hat folgende Auswirkungen:

• Alle Inhalte des Projekts werden gelöscht. Wenn Sie für die Aufgaben in diesem Dokument ein bereits bestehendes Projekt verwendet haben und dieses löschen, werden auch alle anderen im Rahmen des Projekts erstellten Daten gelöscht.
• Benutzerdefinierte Projekt-IDs gehen verloren. Beim Erstellen dieses Projekts haben Sie möglicherweise eine benutzerdefinierte Projekt-ID erstellt, die Sie weiterhin verwenden möchten. Damit die URLs, die die Projekt-ID nutzen, z. B. eine appspot.com-URL, erhalten bleiben, sollten Sie ausgewählte Ressourcen innerhalb des Projekts löschen, statt das gesamte Projekt.

Wenn Sie mehrere Architekturen, Anleitungen und Kurzanleitungen durcharbeiten möchten, können Sie die Überschreitung von Projektkontingenten verhindern, indem Sie Projekte wiederverwenden.

1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

Nächste Schritte

• Weitere Informationen zu den verschiedenen Repository-Modi in Artifact Registry
• Weitere Informationen zu Remote-Repositories in Artifact Registry
• Weitere Informationen zu CI/CD