In Google Kubernetes Engine bereitstellen

In dieser Anleitung wird beschrieben, wie Sie Images aus Artifact Registry abrufen, um sie in der Google Kubernetes Engine bereitzustellen. Wenn Sie eine Bereitstellung in selbst gehosteten oder von Drittanbietern bereitgestellten Kubernetes-Diensten vornehmen möchten, müssen Sie die Authentifizierung bei Google Cloud konfigurieren, bevor Sie Images aus der Artifact Registry abrufen. Informationen zum Authentifizieren bei Google Cloud über Kubernetes-Arbeitslasten außerhalb von Google Cloudfinden Sie unter Workload Identity Federation mit Kubernetes konfigurieren.

Mit Google Kubernetes Engine können Sie Images direkt aus Docker-Repositories abrufen. Einige Versionen bieten eine vorkonfigurierte Unterstützung zum Abrufen von Images aus Artifact Registry-Docker-Repositories.

Voraussetzungen

In diesem Abschnitt werden die Anforderungen für die Einbindung in GKE beschrieben.

Berechtigungen

GKE verwendet die folgenden Standardeinstellungen, wenn Sie Knotenpools oder Cluster erstellen:

• Das Compute Engine-Standarddienstkonto ist die Identität für Knoten. Dieses Standarddienstkonto hat die Rolle „Artifact Registry-Leser“ (roles/artifactregistry.reader), wenn Sie die Zuweisung der einfachen Rolle „Bearbeiter“ deaktiviert haben.
• Knoten, die Sie mit dem Standarddienstkonto erstellen, haben die Standardzugriffsbereiche der Compute Engine, einschließlich schreibgeschützten Zugriffs auf den Speicher. Sie können die Zugriffsbereiche für vorhandene Knoten nicht ändern.

Wenn Sie diese Standardwerte verwenden, kann GKE Images aus Artifact Registry-Repositories im selben Google Cloud -Projekt abrufen. Wenn Sie Images von Knoten hochladen, Images projektübergreifend abrufen oder hochladen, ein von Nutzern bereitgestelltes Dienstkonto verwenden oder andere Anforderungen haben, die von den Standardeinstellungen nicht unterstützt werden, finden Sie in der Dokumentation zur Zugriffssteuerung Informationen zum Konfigurieren des Zugriffs.

Wenn der Fehler „Berechtigung verweigert“ auftritt, lesen Sie den Hilfeartikel 4xx-Fehler.

GKE-Version

In der folgenden Tabelle sind die erforderlichen Mindestversionen für GKE aufgeführt, um Cluster zu erstellen, die Standardberechtigungen zum Herunterladen von Containern aus Docker-Repositories im selben Projekt haben.

Version	Mindestens erforderlicher Patch
1,14	1.14.10-gke.22
1,15	1.15.9-gke.8

Wenn Ihre GKE-Version älter als die Mindestversion ist, müssen Sie Kubernetes-imagePullSecrets konfigurieren, damit GKE Images abrufen kann.

Befindet sich GKE in einem anderen Projekt als Artifact Registry, gewähren Sie dem Dienstkonto, das Ihr GKE-Knoten verwendet, Berechtigungen für Artifact Registry. Standardmäßig verwenden Knoten das Compute Engine-Standarddienstkonto.

Image ausführen

Mit dem folgenden Befehl führen Sie ein Artifact Registry-Image in einem Google Kubernetes Engine-Cluster aus:

kubectl run [NAME] --image=LOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY/IMAGE:TAG

Dabei gilt:

• LOCATION ist der regionale oder multiregionale Speicherort für das Repository.
• PROJECT ist die Projekt-ID Ihrer Google Cloud -Console. Wenn die Projekt-ID einen Doppelpunkt (:) enthält, finden Sie weitere Informationen unter Auf Domains beschränkte Projekte.
• REPOSITORY ist der Name des Repositorys, in dem das Image gespeichert ist.
• IMAGE ist der Name des Images im Repository.
• TAG ist das Tag für die Image-Version, die Sie herunterladen möchten.

Weitere Informationen zu Kubernetes-Befehlen finden Sie in der Übersicht zu kubectl.

Fehlerbehebung bei containerd-Knoten-Images

Ab GKE-Knotenversion 1.19 ist das Standardknoten-Image für Linux-Knoten die Variante von Container-Optimized OS mit Containerd (cos_containerd) statt der Variante von Container-Optimized OS mit Docker (cos).

Die Docker-Binärdatei ist zwar auf Linux-Knoten verfügbar, die containerd als Laufzeit verwenden, wir empfehlen aber, sie nicht zu verwenden. Docker verwaltet nicht die Container, die Kubernetes auf Containerd-Knoten ausführt. Deshalb können Sie es nicht verwenden, um mit Docker-Befehlen oder der Docker API laufende Kubernetes-Container aufzurufen oder mit diesen zu interagieren.

Zum Debugging und zur Problembehebung auf Linux-Knoten können Sie mithilfe des speziell für Kubernetes-Containerlaufzeiten erstellten portablen Befehlszeilentools mit containerd interagieren: crictl crictl unterstützt allgemeine Funktionen, mit denen Sie Container und Images aufrufen, Logs lesen und Befehle in den Containern ausführen können.

Weitere Informationen finden Sie im crictl-Benutzerhandbuch und in der GKE-Dokumentation zu containerd.

Bei Windows Server-Knoten wird der Containerd-Daemon als Windows-Dienst mit dem Namen containerd ausgeführt. Logs sind im folgenden Logverzeichnis verfügbar: C:\etc\kubernetes\logs\containerd.log und werden im Log-Explorer unter LOG NAME: "container-runtime" angezeigt.

Warnung: Docker kann keine Container für Linux- und Windows-Knotenpools aufrufen oder darauf zugreifen, die containerd als Laufzeit verwenden.

Pull-Vorgang aus einem öffentlichen Artifact Registry-Repository

Nachdem Sie ein Image in einem GKE-Cluster mit Containerd-Knoten bereitgestellt haben, können Sie über SSH eine Verbindung zu einer VM-Instanz herstellen und crictl-Befehle zur Fehlerbehebung ausführen.

Für öffentliche Artifact Registry-Repositories ist keine Authentifizierung erforderlich. crictl kann auch zum Abrufen von Images in privaten Artifact Registry-Repositories verwendet werden.

Console

1. Rufen Sie in der Google Cloud -Konsole die Seite VM-Instanzen auf.

   Zu Seite „VM-Instanzen“

2. Klicken Sie in der Liste der VM-Instanzen in der Zeile der Instanz, zu der Sie eine Verbindung herstellen möchten, auf den Pfeil neben SSH.

   

   Hinweis: Wenn Sie über die Google Cloud Console eine Verbindung zu VMs herstellen, erstellt Compute Engine einen sitzungsspezifischen SSH-Schlüssel für Sie. Weitere Informationen zu SSH-Schlüsseln finden Sie unter SSH-Verbindungen zu Linux-VMs.

3. Wählen Sie im Drop-down-Menü die Option „Im Browserfenster öffnen“ oder die gewünschte Verbindungsmethode aus.

4. In derGoogle Cloud -Console wird ein neues Terminalfenster geöffnet. Mit crictl können Sie ein Image aus Artifact Registry herunterladen:

   crictl pull IMAGE_LOCATION:TAG
   

   Die Ausgabe sieht so aus:

   Image is up to date for sha256:0f25067aa9c180176967b4b50ed49eed096d43fa8c17be9a5fa9bff05933bee5

   Wenn Sie ein Image aus einem privaten Artifact Registry-Repository abrufen, müssen Sie sich beim Repository authentifizieren. Sie können ein Zugriffstoken verwenden, um Ihre Anmeldedaten anzugeben.

gcloud

1. Prüfen Sie, ob Sie die neueste Version des Google Cloud CLI haben.

   gcloud components update
   

2. Stellen Sie eine Verbindung zur VM her.

   gcloud compute ssh --project=PROJECT_ID \
    --zone=ZONE \
    VM_NAME
   

   Dabei gilt:

   • PROJECT_ID: Die ID des Projekts, das die VM enthält
   • ZONE: Der Name der Zone, in der sich die VM befindet
   • VM_NAME: Der Name der VM

   Wenn Sie Standardeigenschaften für das Google Cloud CLI festgelegt haben, können Sie die Flags --project und --zone bei diesem Befehl weglassen. Beispiel:

   gcloud compute ssh VM_NAME
   

3. Wenn Sie noch keinen SSH-Schlüssel erstellt haben, wird dieser von SSH keygen generiert. Geben Sie eine Passphrase ein oder lassen Sie das Feld leer, wenn Sie dazu aufgefordert werden.

4. Verwenden Sie crictl, um ein Image aus Artifact Registry abzurufen:

   crictl pull IMAGE_LOCATION:TAG
   

5. Die Ausgabe sieht so aus:

   Image is up to date for sha256:0f25067aa9c180176967b4b50ed49eed096d43fa8c17be9a5fa9bff05933bee5

   Wenn Sie ein Image aus einem privaten Artifact Registry-Repository abrufen, müssen Sie sich beim Repository authentifizieren. Sie können ein Zugriffstoken verwenden, um Ihre Anmeldedaten anzugeben.

Aus einem privaten Artifact Registry-Repository abrufen

Console

1. Rufen Sie in der Google Cloud -Konsole die Seite VM-Instanzen auf.

   Zu Seite „VM-Instanzen“

2. Klicken Sie in der Liste der VM-Instanzen in der Zeile der Instanz, zu der Sie eine Verbindung herstellen möchten, auf den Pfeil neben SSH.

   

   Hinweis: Wenn Sie über die Google Cloud Console eine Verbindung zu VMs herstellen, erstellt Compute Engine einen sitzungsspezifischen SSH-Schlüssel für Sie. Weitere Informationen zu SSH-Schlüsseln finden Sie unter SSH-Verbindungen zu Linux-VMs.

3. Wählen Sie im Drop-down-Menü die Option „Im Browserfenster öffnen“ aus.

4. In derGoogle Cloud -Console wird ein neues Terminalfenster geöffnet. Generieren Sie mit curl ein Zugriffstoken für ein Compute Engine-Dienstkonto.

   curl -s "http://metadata.google.internal/computeMetadata/v1/instance/service-accounts/default/token" -H "Metadata-Flavor: Google"
   

   Die Ausgabe sieht so aus:

   "access_token":"ya29.c.KpkBCQgdwv6LrZ2tjrCpG6snWwPMX29LzMeUmAV_Hq_XaxUurfXcCfGZfASGh_KbdmUYTvkuV3sh-WaSBplEskdP6Tc
   HDsTv4B9hMyvoL4M9HrzKHuKTa1ZGj_3iQ1lwq_dAMxAPGjxEVKexatwN2KP0EAWyb6R55Cuu8ItgLf9f4pm9lC5zH4Qo0fkxPUsnCGRBe4AYxEpN6T
   sh","expires_in":3526,"token_type":"Bearer"}

5. Kopieren Sie den Wert von access_token aus der zurückgegebenen Ausgabe ohne Anführungszeichen.

6. Rufe das Bild mit crictl pull --creds und dem im vorherigen Schritt kopierten Wert access_token ab.

   crictl pull --creds "oauth2accesstoken:ACCESS_TOKEN" IMAGE_LOCATION:TAG

   Die Ausgabe sieht so aus:

   Image is up to date for sha256:0f25067aa9c180176967b4b50ed49eed096d43fa8c17be9a5fa9bff05933bee5

gcloud

1. Prüfen Sie, ob Sie die neueste Version des Google Cloud CLI haben.

   gcloud components update
   

2. Stellen Sie eine Verbindung zur VM her.

   gcloud compute ssh --project=PROJECT_ID \
    --zone=ZONE \
    VM_NAME
   

   Ersetzen Sie die folgenden Variablen:

   • PROJECT_ID: Die ID des Projekts, das die VM enthält
   • ZONE: Der Name der Zone, in der sich die VM befindet
   • VM_NAME: Der Name der VM

   Wenn Sie Standardeigenschaften für das Google Cloud CLI festgelegt haben, können Sie die Flags --project und --zone bei diesem Befehl weglassen. Beispiel:

   gcloud compute ssh VM_NAME
   

3. Wenn Sie noch keinen SSH-Schlüssel erstellt haben, wird dieser von SSH keygen generiert. Geben Sie eine Passphrase ein oder lassen Sie das Feld leer, wenn Sie dazu aufgefordert werden.

4. Mit curl ein Zugriffstoken für ein Compute Engine-Dienstkonto generieren

   curl -s "http://metadata.google.internal/computeMetadata/v1/instance/service-accounts/default/token" -H "Metadata-Flavor: Google"
   

   Die Ausgabe sieht so aus:

   "access_token":"ya29.c.KpkBCQgdwv6LrZ2tjrCpG6snWwPMX29LzMeUmAV_Hq_XaxUurfXcCfGZfASGh_KbdmUYTvkuV3sh-WaSBplEskdP6Tc
   HDsTv4B9hMyvoL4M9HrzKHuKTa1ZGj_3iQ1lwq_dAMxAPGjxEVKexatwN2KP0EAWyb6R55Cuu8ItgLf9f4pm9lC5zH4Qo0fkxPUsnCGRBe4AYxEpN6T
   sh","expires_in":3526,"token_type":"Bearer"}

5. Kopieren Sie den Wert von access_token aus der zurückgegebenen Ausgabe ohne Anführungszeichen.

6. Rufe das Bild mit crictl pull --creds und dem im vorherigen Schritt kopierten Wert access_token ab.

   crictl pull --creds "oauth2accesstoken:ACCESS_TOKEN" IMAGE_LOCATION:TAG

   Die Ausgabe sieht so aus:

   Image is up to date for sha256:0f25067aa9c180176967b4b50ed49eed096d43fa8c17be9a5fa9bff05933bee5

Mit crictl können Entwickler ihre Laufzeit debuggen, ohne Kubernetes-Komponenten einrichten zu müssen. Eine vollständige Liste der Befehle finden Sie in der crictl-Dokumentation und in der Dokumentation zum Debuggen von Kubernetes.