gcloud CLI verwenden

Die gdcloud CLI ist eine Reihe von Tools zum Erstellen und Verwalten von Google Distributed Cloud-Ressourcen (GDC), die nicht mit dem Internet verbunden sind. Mit diesen Tools lassen sich gängige Aufgaben über die Befehlszeile oder über Skripts und Automatisierung ausführen. Mit der gcloud CLI können Sie die Infrastruktur einrichten, die Authentifizierung verwalten und lokale Konfigurationen anpassen.

Dieses Dokument richtet sich an alle Zielgruppen, die die dedizierte CLI von GDC einrichten müssen, um ihre Hardware- und Software-Workflows in Air-Gap-Umgebungen zu verwalten. Weitere Informationen finden Sie unter Dokumentation zu Zielgruppen für GDC mit Air Gap.

Hinweis

  • Prüfen Sie, ob Sie Zugriff auf die GDC-Konsole haben, und notieren Sie sich die URL Ihrer Organisation. Weitere Informationen finden Sie unter Zugriff auf die GDC-Konsole.

  • Prüfen Sie, ob Sie ein Zertifizierungsstellenzertifikat haben, das im Speicher für vertrauenswürdige Zertifikate Ihres Systems installiert ist. Weitere Informationen finden Sie unter GDC-Vertrauensbündel abrufen.

  • Prüfen Sie, ob Sie eine Organisationsnetzwerkrichtlinie haben, die Traffic von einem bestimmten CIDR außerhalb Ihrer Organisation zur Artifact Registry zulässt. Konfigurieren Sie beispielsweise den Dienstnamen all in der Ressource OrganizationNetworkPolicy. Weitere Informationen finden Sie unter Organisationsnetzwerkrichtlinien erstellen.

  • Prüfen Sie, ob auf Ihrem Gerät ein Browser installiert ist.

gcloud CLI einrichten

So richten Sie die gcloud CLI ein:

  1. Öffnen Sie die GDC-Konsole, indem Sie die globale oder zonale URL Ihrer Organisation in Ihren Browser eingeben.

  2. Wählen Sie auf der Startseite CLI-Bundle herunterladen aus.

  3. Wählen Sie die Linux-Plattform und die gdcloud CLI-Bundle-Version aus, die Ihrer GDC-Umgebung entspricht.

    Bei der Auswahl von Nicht-Linux-Plattformen können die Konfigurationsschritte leicht variieren. Beachten Sie außerdem, dass einige nicht auf Linux basierende gcloud CLI-Bundles nur eine Teilmenge der gcloud-Befehle enthalten. Weitere Informationen finden Sie unter Verfügbare gdcloud CLI-Bundles.

  4. Klicken Sie auf Herunterladen.

  5. Rufen Sie auf Ihrem Gerät den Ordner Downloads auf:

    cd ~/Downloads

  6. Extrahieren Sie den Inhalt des gdcloud CLI-Bundles:

    tar -xf ./gdcloud_cli.tar.gz

  7. Fügen Sie das gdcloud-CLI-Bundle Ihrem Pfad hinzu:

    eval echo 'export GDCLOUD_PATH=$(pwd)/google-distributed-cloud-hosted-cli' >> ~/.bashrc
echo 'export PATH="$GDCLOUD_PATH/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

  8. Prüfen Sie, ob die gcloud CLI korrekt installiert ist:

    gdcloud version

    Die Ausgabe sieht etwa so aus:

    gdcloud version: 1.15.0-gdch.380608

  9. Initialisieren Sie die gcloud CLI:

    gdcloud init

  10. Geben Sie die beiden angeforderten Attribute an, um die Initialisierung abzuschließen:

    • organization_console_url: Die URL zur Console Ihrer aktuellen GDC-Organisation. Diese URL kann global oder zonal sein. Beispiel: https://console.org-1.google.gdch.test/.

    • project: Name Ihres GDC-Projekts. Wenn Sie noch kein Projekt haben, verwenden Sie default.

    Informationen zum Aktualisieren Ihrer gdcloud CLI-Konfigurationen nach der Initialisierung finden Sie unter gdcloud CLI-Konfigurationen verwalten.

  11. Installieren Sie die Komponente gdcloud-k8s-auth-plugin:

    gdcloud components install gdcloud-k8s-auth-plugin

  12. Authentifizieren Sie sich mit der gcloud CLI, um sich anzumelden:

    gdcloud auth login

    Sie werden zum Browser weitergeleitet, um Ihre Identität auszuwählen und sich anzumelden.

  13. Prüfen Sie, ob Ihre gcloud CLI-Einrichtung mit Ihrer GDC-Umgebung verbunden ist:

    gdcloud compute images list

    Die Ausgabe sieht etwa so aus:

    METADATA.NAME               METADATA.NAMESPACE SPEC.OPERATINGSYSTEM.NAME SPEC.MINIMUMDISKSIZE
rocky-8-v20250809-gdch      vm-system          rocky-linux-8             12G
ubuntu-20.04-v20250809-gdch vm-system          ubuntu-2004               12G
ubuntu-22.04-v20250809-gdch vm-system          ubuntu-2204               12G
ubuntu-24.04-v20250809-gdch vm-system          ubuntu-2404               12G

Nächste Schritte