Kurzanleitung: Erste Schritte mit Cloud SDK

Diese Kurzanleitung führt Sie durch die Installation und Initialisierung von Cloud SDK und führt einige grundlegende Befehle des gcloud-Tools aus, um Ihnen den Einstieg zu erleichtern.

Neueste Version des Cloud SDK (357.0.0) installieren

Linux
  1. Das Cloud SDK erfordert Python. Unterstützte Versionen sind Python 3 (bevorzugt; 3.5 bis 3.8) und Python 2 (2.7.9 oder höher).

    python --version
    Ihr Betriebssystem muss in der Lage sein, eine dieser unterstützten Python-Versionen auszuführen, damit Cloud SDK ausgeführt werden kann. Weitere Informationen zum Auswählen und Konfigurieren des Python-Interpreters finden Sie unter gcloud topic startup.
  2. Laden Sie eine der folgenden Dateien herunter:
  3. Plattform Paket Größe SHA256-Prüfsumme
    Linux 64-Bit

    (x86_64)

    google-cloud-sdk-357.0.0-linux-x86_64.tar.gz 87,7 MB 7FA9058ECEE419564f53ad768699a78baec5b712b15db63f9e2aed42b5dcde29
    Linux 64-Bit

    (arm)

    google-cloud-sdk-357.0.0-linux-arm.tar.gz 85.0 MB d11a08f02db5ebe7e03688e13fff0ec2a9a9af19e4ab2cf04c75f90015c6c6a4
    Linux 32-Bit

    (x86)

    google-cloud-sdk-357.0.0-linux-x86.tar.gz 85.0 MB 62efaaa3032780f665bb325aed9eacd6a1273f3fc680f94c9c4168dda4c1933f

  4. Alternativ können Sie so die 64-Bit-Linux-Archivdatei über die Befehlszeile herunterladen:

    curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-sdk-357.0.0-linux-x86_64.tar.gz

    Führen Sie für die 64-Bit-Arm-Archivdatei Folgendes aus:

    curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-sdk-357.0.0-linux-arm.tar.gz

    Führen Sie für die 32-Bit-Archivdatei Folgendes aus:

    curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-sdk-357.0.0-linux-x86.tar.gz
  5. Extrahieren Sie den Inhalt der Datei an einen beliebigen Speicherort in Ihrem Dateisystem (vorzugsweise in Ihrem Basisverzeichnis). Wenn Sie eine vorhandene Installation ersetzen möchten, entfernen Sie das vorhandene Verzeichnis google-cloud-sdk und extrahieren Sie das Archiv an denselben Speicherort.
  6. Optional. Fügen Sie dem PATH mithilfe des Installationsskripts Cloud SDK-Tools hinzu. Sie können auch die Vervollständigung von Shell-Befehlen und das Erfassen von Nutzungsstatistiken aktivieren.

    Führen Sie das Skript (im Stammverzeichnis des Ordners, den Sie im letzten Schritt extrahiert haben) mit diesem Befehl aus:

    ./google-cloud-sdk/install.sh
    
    Dies kann auch auf nicht interaktive Weise erfolgen (z. B. mithilfe eines Skripts) und indem Sie Einstellungen als Flags angeben. Diese werden beschrieben in:
    ./google-cloud-sdk/install.sh --help
    
    Öffnen Sie ein neues Terminal, damit die Änderungen wirksam werden.
  7. Führen Sie gcloud init aus, um das SDK zu initialisieren:
  8. ./google-cloud-sdk/bin/gcloud init
    
  9. Optional: Sie können zusätzliche Komponenten mit dem Komponentenmanager installieren.
Debian/Ubuntu

Paketinhalt

Das Cloud SDK steht im Paketformat zur Installation auf Debian- und Ubuntu-Systemen zur Verfügung. Dieses Paket umfasst nur die Befehle von gcloud, gcloud alpha, gcloud beta, gsutil und bq. Nicht enthalten sind kubectl oder die App Engine-Erweiterungen, die für die Bereitstellung einer Anwendung mit gcloud-Befehlen erforderlich sind. Wenn Sie diese Komponenten benötigen, müssen Sie sie gemäß der Anleitung weiter unten in diesem Abschnitt separat installieren.

Voraussetzungen

Prüfen Sie vor der Installation des Cloud SDK, ob Sie eines der folgenden Betriebssysteme verwenden:

Installation
  1. Fügen Sie den URI der Cloud SDK-Distribution als Paketquelle hinzu:
    echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list
    Hinweis: Prüfen Sie, ob apt-transport-https installiert ist:
    sudo apt-get install apt-transport-https ca-certificates gnupg
  2. Importieren Sie den öffentlichen Google Cloud-Schlüssel:
    curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add -
  3. Aktualisieren und installieren Sie das Cloud SDK:
    sudo apt-get update && sudo apt-get install google-cloud-sdk
    Weitere Optionen für apt-get, wie das Deaktivieren von Eingabeaufforderungen oder Probeläufen, finden Sie auf den apt-get-man-Seiten.

    Docker-Tipp: Wenn Sie das Cloud SDK in einem Docker-Image installieren, verwenden Sie stattdessen einen einzigen RUN-Schritt:

    RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] http://packages.cloud.google.com/apt cloud-sdk main" | tee -a /etc/apt/sources.list.d/google-cloud-sdk.list && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | apt-key --keyring /usr/share/keyrings/cloud.google.gpg  add - && apt-get update -y && apt-get install google-cloud-sdk -y
          

  4. Optional können Sie eine oder mehrere dieser zusätzlichen Komponenten installieren:
    • google-cloud-sdk-app-engine-python
    • google-cloud-sdk-app-engine-python-extras
    • google-cloud-sdk-app-engine-java
    • google-cloud-sdk-app-engine-go
    • google-cloud-sdk-bigtable-emulator
    • google-cloud-sdk-cbt
    • google-cloud-sdk-cloud-build-local
    • google-cloud-sdk-datalab
    • google-cloud-sdk-datastore-emulator
    • google-cloud-sdk-firestore-emulator
    • google-cloud-sdk-pubsub-emulator
    • kubectl

    Die Komponente google-cloud-sdk-app-engine-java kann beispielsweise so installiert werden:

    sudo apt-get install google-cloud-sdk-app-engine-java
  5. Führen Sie gcloud init aus, um zu beginnen:
    gcloud init

Downgrade auf ältere Versionen von Cloud SDK ausführen

Wenn Sie eine bestimmte Version von Cloud SDK wiederherstellen möchten, wobei VERSION das Format 123.0.0 hat, führen Sie Folgendes aus: sudo apt-get update && sudo apt-get install google-cloud-sdk=123.0.0-0 Die letzten zehn Releases sind immer im Repository verfügbar.

Red Hat/Fedora/CentOS

Paketinhalt

Cloud SDK ist im Paketformat zur Installation auf den Systemen Red Hat Enterprise Linux 7, Red Hat Enterprise Linux 8, Fedora 33 und CentOS 7 und 8 verfügbar. Dieses Paket umfasst nur die Befehle von gcloud, gcloud alpha, gcloud beta, gsutil und bq. Nicht enthalten sind kubectl oder die App Engine-Erweiterungen, die für die Bereitstellung einer Anwendung mit gcloud-Befehlen erforderlich sind. Sie können separat installiert werden, wie weiter unten in diesem Abschnitt beschrieben.

Installation
  1. Aktualisieren Sie DNF mit den Cloud SDK-Repository-Informationen:
    sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM
    [google-cloud-sdk]
    name=Google Cloud SDK
    baseurl=https://packages.cloud.google.com/yum/repos/cloud-sdk-el8-x86_64
    enabled=1
    gpgcheck=1
    repo_gpgcheck=0
    gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg
           https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
    EOM
    
  2. Installieren Sie das Cloud SDK:
    sudo dnf install google-cloud-sdk
  3. Optional können Sie eine oder mehrere dieser zusätzlichen Komponenten installieren:
    • google-cloud-sdk-app-engine-python
    • google-cloud-sdk-app-engine-python-extras
    • google-cloud-sdk-app-engine-java
    • google-cloud-sdk-app-engine-go
    • google-cloud-sdk-bigtable-emulator
    • google-cloud-sdk-cbt
    • google-cloud-sdk-cloud-build-local
    • google-cloud-sdk-datalab
    • google-cloud-sdk-datastore-emulator
    • google-cloud-sdk-firestore-emulator
    • google-cloud-sdk-pubsub-emulator
    • kubectl

    Die Komponente google-cloud-sdk-app-engine-java kann beispielsweise so installiert werden:

    sudo dnf install google-cloud-sdk-app-engine-java
  4. Führen Sie gcloud init aus, um zu beginnen:
    gcloud init

Downgrade auf ältere Versionen von Cloud SDK ausführen

Wenn Sie eine bestimmte Version von Cloud SDK wiederherstellen möchten, wobei VERSION das Format 123.0.0 hat, führen Sie Folgendes aus: sudo dnf downgrade google-cloud-sdk-VERSION Die letzten zehn Releases sind immer im Repository verfügbar.

macOS
  1. Cloud SDK erfordert Python:
    • Unterstützte Versionen sind Python 3 (3.7 wird empfohlen) und Python 2 (2.7.9 oder höher).
    • Moderne Versionen von macOS enthalten die entsprechende Version von Python, die für das Cloud SDK erforderlich ist. Führen Sie folgenden Befehl aus, um Ihre aktuelle Python-Version zu prüfen: python -V
    • Für die Clou SDK-Release-Version 352.0.0 und höher bietet das Hauptinstallationsskript an, Python 3.7 von CPython auf Intel-basierten Macs zu installieren.
    • Weitere Informationen zum Auswählen und Konfigurieren des Python-Interpreters finden Sie unter gcloud topic startup.
  2. Laden Sie eine der folgenden Dateien herunter:
  3. Plattform Paket Größe SHA256-Prüfsumme
    macOS 64-Bit

    (x86_64)

    google-cloud-sdk-357.0.0-darwin-x86_64.tar.gz 88,2 MB 6dfef80cf74b058edb1561e4a1aaed29af5b0dbbc2d1f4afe7f96a5fca7e6da4
    macOS 64-Bit

    (arm64, Apple M1 silicon)

    google-cloud-sdk-357.0.0-darwin-arm.tar.gz 88,1 MB af77b1bcc3476a1ed173b90dcc918a47cbc9eead3d8efdab6ff99dc8ae79b11e
    macOS 32-Bit

    (x86)

    google-cloud-sdk-357.0.0-darwin-x86.tar.gz 91,9 MB d946dfbc0bcebbe428d47673fa01a382bac453aa304a1b76c72a440737c09cf2

    1. Entpacken Sie das Archiv in einem Verzeichnis Ihres Dateisystems, vorzugsweise im Basisverzeichnis. Unter macOS erreichen Sie dies, indem Sie die heruntergeladene Archivdatei .tar.gz am bevorzugten Speicherort öffnen.

      Wenn Sie eine vorhandene Installation ersetzen möchten, entfernen Sie das vorhandene Verzeichnis google-cloud-sdk und extrahieren das Archiv an denselben Speicherort.

    2. Optional. Fügen Sie dem PATH mithilfe des Installationsskripts Cloud SDK-Tools hinzu.

      Sie können auch die Vervollständigung von Befehlen für Ihre Shell und die Erfassung von Nutzungsstatistiken aktivieren und optional Python 3.7 installieren.

      Führen Sie das Skript (im Stammverzeichnis des Ordners, den Sie im letzten Schritt extrahiert haben) mit diesem Befehl aus:

      ./google-cloud-sdk/install.sh
      
      Dies kann auch auf nicht interaktive Weise erfolgen (z. B. mithilfe eines Skripts) und indem Sie Einstellungen als Flags angeben. Diese werden beschrieben in:
      ./google-cloud-sdk/install.sh --help
      
      So führen Sie das Installationsskript mit aktiviertem Screenreader-Modus aus:
      ./google-cloud-sdk/install.sh --screen-reader=true
      
      Öffnen Sie ein neues Terminal, damit die Änderungen wirksam werden.
    3. Führen Sie gcloud init aus, um das SDK zu initialisieren:
    4. ./google-cloud-sdk/bin/gcloud init
      
    5. Optional: Sie können zusätzliche Komponenten mit dem Komponentenmanager installieren.
Windows
  1. Laden Sie das Cloud SDK-Installationsprogramm herunter.

    Alternativ können Sie ein PowerShell-Terminal öffnen und die folgenden PowerShell-Befehle ausführen.

    (New-Object Net.WebClient).DownloadFile("https://dl.google.com/dl/cloudsdk/channels/rapid/GoogleCloudSDKInstaller.exe", "$env:Temp\GoogleCloudSDKInstaller.exe")
    
    & $env:Temp\GoogleCloudSDKInstaller.exe
        
  2. Starten Sie das Installationsprogramm und folgen Sie den Anweisungen. Das Installationsprogramm ist von Google LLC signiert.

    Wenn Sie einen Screenreader verwenden, klicken Sie auf das Kästchen Screenreader-Modus aktivieren. Diese Option konfiguriert gcloud so, dass Status-Tracker anstelle von rotierenden Unicode-Ladesymbolen verwendet, die Fortschritt als Prozentsatz angezeigt und Tabellen vereinfacht werden. Weitere Informationen finden Sie im Leitfaden zu Bedienungshilfen.

  3. Das Cloud SDK erfordert Python. Unterstützte Versionen sind Python 3 (bevorzugt; 3.5 bis 3.8) und Python 2 (2.7.9 oder höher). Cloud SDK ist standardmäßig in Python 3 enthalten. Um das Cloud SDK verwenden zu können, muss das Betriebssystem in der Lage sein, eine unterstützte Version von Python auszuführen.

    Das Installationsprogramm installiert alle notwendigen Abhängigkeiten, darunter die erforderliche Version von Python. Das Cloud SDK installiert und verwaltet Python 3 standardmäßig, kann aber bei Bedarf eine vorhandene Python-Installation verwenden. Dazu deaktivieren Sie die Option zum gebündelten Installieren von Python. Informationen zur Verwendung einer vorhandene Python-Installation finden Sie unter gcloud topic start.

  4. Nach Abschluss der Installation haben Sie die Möglichkeit, Startmenü- und Desktopverknüpfungen zu erstellen, die Cloud SDK Shell zu starten und das Cloud SDK zu konfigurieren. Achten Sie darauf, dass die Optionen zum Starten der Shell und zum Konfigurieren der Installation ausgewählt bleiben. Das Installationsprogramm startet ein Terminalfenster und führt den Befehl gcloud init aus.

  5. Die Standardinstallation umfasst nicht die App Engine-Erweiterungen, die für die Bereitstellung einer Anwendung mit gcloud-Befehlen erforderlich sind. Diese Komponenten können mit dem Cloud SDK-Komponentenmanager installiert werden.
Tipps zur Fehlerbehebung:
  • Wenn die Installation aufgrund der Nichterkennung des Befehls find fehlschlägt, achten Sie darauf, dass die Umgebungsvariable PATH so eingestellt ist, dass sie den Ordner mit find enthält. Normalerweise ist dies C:\WINDOWS\system32;.
  • Wenn Sie das Cloud SDK gerade deinstalliert haben, müssen Sie das System neu starten, bevor Sie Cloud SDK neu installieren.

Optional: Aktuelle Cloud-Clientbibliotheken installieren

Sie können Cloud-Clientbibliotheken für unterstützte Sprachen herunterladen.

Das Cloud SDK initialisieren

Verwenden Sie den Befehl gcloud init, um mehrere gängige Cloud SDK-Einrichtungsaufgaben auszuführen. Dazu gehört die Autorisierung der Cloud SDK-Tools für den Zugriff auf Google Cloud mit Ihren Anmeldedaten für das Nutzerkonto und die Einrichtung der Standardkonfiguration.

So initialisieren Sie das Cloud SDK:

  1. Führen Sie bei der Eingabeaufforderung folgenden Befehl aus:

    ```
    gcloud init
    ```
    

  2. Stimmen Sie der Anmeldung mit Ihrem Google-Nutzerkonto zu:

    To continue, you must log in. Would you like to log in (Y/n)? Y
    
  3. Melden Sie sich bei entsprechender Aufforderung über den Browser bei Ihrem Google-Nutzerkonto an. Klicken Sie auf Zulassen, um die Berechtigung für den Zugriff auf Google Cloud-Ressourcen zu gewähren.

  4. Wählen Sie in der Eingabeaufforderung aus der Liste der Cloud Platform-Projekte, für die Sie die Berechtigungen Inhaber, Bearbeiter oder Bearbeiter haben, ein Projekt aus:

    Pick cloud project to use:
     [1] [my-project-1]
     [2] [my-project-2]
     ...
     Please enter your numeric choice:
    

    Wenn Sie nur ein einziges Projekt haben, wählt gcloud init dieses für Sie aus.

    Wenn Sie Zugriff auf mehr als 200 Projekte haben, werden Sie aufgefordert, eine Projekt-ID einzugeben, ein neues Projekt zu erstellen oder Projekte aufzulisten.

    This account has a lot of projects! Listing them all can take a while.
     [1] Enter a project ID
     [2] Create a new project
     [3] List projects
    Please enter your numeric choice:
    
  5. Wenn die Google Compute Engine API aktiviert ist, können Sie mit gcloud init eine Standardzone für Compute Engine auswählen:

    Which compute zone would you like to use as project default?
     [1] [asia-east1-a]
     [2] [asia-east1-b]
     ...
     [14] Do not use default zone
     Please enter your numeric choice:
    

    gcloud init bestätigt, dass die Einrichtungsschritte erfolgreich abgeschlossen wurden:

    gcloud has now been configured!
    You can use [gcloud config] to change more gcloud settings.
    
    Your active configuration is: [default]
    
  6. (Optional) Wenn Sie einen optimierten Screenreader nutzen möchten, enthält das gcloud-Tool das Attribut accessibility/screen_reader.

    Führen Sie folgenden Befehl aus, um dieses Attribut zu aktivieren:

    gcloud config set accessibility/screen_reader true
    

    Weitere Informationen zu den Bedienungshilfen des gcloud-Tools finden Sie im Leitfaden Bedienungshilfen aktivieren.

Wichtige Befehle ausführen

Führen Sie die folgenden Befehle des gcloud-Tools aus, um Informationen zu Ihrer Cloud SDK-Installation aufzurufen:

  1. Auflisten der Konten, deren Anmeldedaten auf dem lokalen System gespeichert sind:

    ```
    gcloud auth list
    ```
    

    Das gcloud-Tool zeigt eine Liste von Konten mit Anmeldedaten an:

           Credentialed Accounts
    ACTIVE             ACCOUNT
    *                  example-user-1@gmail.com
                       example-user-2@gmail.com
    
  2. Auflisten der Attribute in der aktiven Cloud SDK-Konfiguration:

    ```
    gcloud config list
    ```
    

    Das gcloud-Tool zeigt die Liste der Attribute an:

    [core]
    account = example-user-1@gmail.com
    disable_usage_reporting = False
    project = example-project
    
  3. Abrufen der Informationen zu Ihrer Cloud SDK-Installation und der aktiven Konfiguration:

    ```
    gcloud info
    ```
    

    Das gcloud-Tool zeigt eine Zusammenfassung der Informationen zu Ihrer Cloud SDK-Installation an. Dazu gehören Informationen zu Ihrem System, den installierten Komponenten, dem aktiven Nutzerkonto und dem aktuellen Projekt sowie zu den Attributen in der aktiven Konfiguration.

  4. So rufen Sie Informationen zu gcloud-Befehlen und anderen Themen über die Befehlszeile auf:

    ```
    gcloud help
    ```
    

    So rufen Sie beispielsweise die Hilfe für gcloud compute instances create auf:

    ```
    gcloud help compute instances create
    ```
    

    Das gcloud-Tool zeigt ein Hilfethema an, das eine Beschreibung des Befehls, eine Liste von Befehls-Flags und Argumenten sowie Beispiele zur Verwendung des Befehls enthält.

Nächste Schritte

  • Lesen Sie den Leitfaden zum gcloud-Tool, um einen Überblick über das gcloud-Tool zu erhalten, einschließlich einer kurzen Einführung in wichtige Konzepte, Befehlskonventionen und hilfreiche Tipps.
  • Ausführliche Informationen zu den einzelnen gcloud-Befehlsbefehlen finden Sie in der Referenz zum gcloud-Tool, einschließlich Beschreibungen, Flags und Beispiele, mit denen Sie eine einer Vielzahl von Aufgaben in Google Cloud.
  • Auf dem Spickzettel des gcloud-Tools finden Sie eine Liste häufig verwendeter Befehle und wichtiger Konzepte.
  • Installieren Sie zusätzliche Komponenten wie die App Engine-Emulatoren oder kubectl mit dem Cloud SDK-Komponentenmanager.

Jetzt testen

Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie einfach ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis zu prüfen und zu bewerten. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

Jetzt kostenlos starten