gcloud CLI verwenden

Die gdcloud CLI ist eine Reihe von Tools zum Erstellen und Verwalten von isolierten Google Distributed Cloud-Ressourcen (GDC). Mit diesen Tools können Sie allgemeine Aufgaben über die Befehlszeile oder über Skripts und Automatisierung ausführen. Mit der gdcloud CLI können Sie die Infrastruktur einrichten, die Authentifizierung verwalten und lokale Konfigurationen anpassen.

Dieses Dokument richtet sich an alle Zielgruppen, die die spezielle CLI von GDC einrichten müssen, um ihre isolierten Hardware- und Softwareworkflows zu verwalten. Weitere Informationen finden Sie unter Zielgruppen für die isolierte GDC-Dokumentation.

Hinweis

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

  • Prüfen Sie, ob Sie ein Zertifikat der Zertifizierungsstelle 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 Netzwerkrichtlinie für die Organisation haben, die Traffic von einer 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 Netzwerkrichtlinien für Organisationen erstellen.

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

gdcloud CLI einrichten

Führen Sie die folgenden Schritte aus, um die gdcloud CLI einzurichten:

  1. Öffnen Sie die GDC Console, 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 Version des gdcloud CLI-Bundles 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-Linux-gdcloud CLI-Bundles nur eine Teilmenge der gdcloud-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 gdcloud CLI korrekt installiert ist:

    gdcloud version

    Die Ausgabe sieht etwa so aus:

    gdcloud version: 1.15.0-gdch.380608

  9. Initialisieren Sie die gdcloud 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: Der Name Ihres GDC-Projekts. Wenn Sie kein vorhandenes 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 gdcloud 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 gdcloud 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