Cloud Shell konfigurieren

Mit Cloud Shell können Sie Ihre Entwicklungsumgebung an Ihre Anforderungen anpassen. Sie können persistente Umgebungsvariablen festlegen, gcloud CLI-Einstellungen definieren, ein Anpassungsskript ausführen, um Tools sitzungsübergreifend zu initialisieren, und die Erfassung von Nutzungsstatistiken anpassen.

Konfigurationsdateien in Ihrem Cloud Shell-Basisverzeichnis

Mit Cloud Shell erhalten Sie 5 GB kostenlosen nichtflüchtigen Speicher, der als $HOME-Verzeichnis bereitgestellt wird. Alle Dateien, die Sie in Ihrem Basisverzeichnis speichern, z. B. installierte Software, Skripte und Konfigurationsdateien wie .bashrc und .vimrc, bleiben auch nach der Sitzung erhalten. Da Ihre .bashrc über Sitzungen hinweg bestehen bleibt, können Sie das Verhalten Ihrer Cloud Shell hervorragend anpassen. Auf ähnliche Weise können Sie Pakete in Ihrem Basisverzeichnis installieren, damit Ihre Installationen bestehen bleiben.

Vorkonfigurierte Umgebungsvariablen

Wenn Cloud Shell gestartet wird, wird das aktive Projekt in Cloud Shell zur sofortigen Verwendung an Ihre gcloud-Konfiguration in Cloud Shell weitergegeben. GOOGLE_CLOUD_PROJECT, die Umgebungsvariable, die von der Unterstützung der Bibliothek für Standardanmeldedaten für Anwendungen verwendet wird, um die Projekt-ID zu definieren, wird ebenfalls so festgelegt, dass sie auf das aktive Projekt in Cloud Shell verweist.

Die Umgebungsvariable CLOUD_SHELL ist auf true festgelegt. Diese Variable kann von Anwendungen geprüft werden, um zu bestimmen, ob eine Anwendung in Cloud Shell ausgeführt wird.

gcloud CLI-Einstellungen

Wenn Sie Cloud Shell verwenden, werden Ihre gcloud CLI-Einstellungen in einem temporären tmp-Ordner gespeichert, der nur für den aktuellen Tab festgelegt ist und nicht über Sitzungen hinweg beibehalten wird.

Wenn Sie möchten, dass Ihre gcloud CLI-Konfigurationen persistent gespeichert werden, können Sie sie mit einer der folgenden Methoden festlegen:

  • Wenn Sie die gcloud CLI-Konfiguration pro Tab anpassen, aber die Standardkonfiguration selbst anpassen möchten, können Sie am Ende der Datei $HOME/.bashrc gcloud-Konfigurationsbefehle hinzufügen (z. B. gcloud config set compute/region us-central1, um eine Standardregion festzulegen).

    So wird sichergestellt, dass jeder neue Tab Ihr Google Cloud Console-Projekt und Ihre benutzerdefinierte Standardkonfiguration übernimmt. Sie können die Konfiguration jedes Tabs aber auch weiter anpassen.

  • Wenn Sie immer dieselbe gcloud CLI-Konfiguration verwenden möchten, fügen Sie am Ende der .bashrc-Datei export CLOUDSDK_CONFIG=$HOME/.config/gcloud hinzu und führen Sie dann gcloud config configurations create CONFIG_NAME aus, um die gewünschte Konfiguration zu erstellen.

Allgemeine Eigenschaften

Mit dem folgenden Befehl legen Sie das Projekt fest, an dem Sie arbeiten möchten:

gcloud config set project [PROJECT_NAME]

Die Eingabeaufforderung wird aktualisiert, um Ihr aktuell aktives Projekt zu übernehmen und das Format zu berücksichtigen: [USERNAME]@cloudshell:~ ([PROJECT_NAME])$

Führen Sie Folgendes aus, um Ihre bevorzugte Region auszuwählen:

gcloud config set compute/region us-east1

Die oben genannten Befehle sind Beispiele für gcloud CLI-Konfigurationen, die Sie festlegen können. Eine vollständige Liste und weitere Informationen zum Festlegen von Attributen finden Sie im Leitfaden zu gcloud CLI-Attributen.

Anpassung der Umgebung

Durch die Anpassung der Umgebung können Sie beim Start zusätzliche Pakete in Ihre Cloud Shell-Umgebung installieren.

Skript zur Anpassung der Umgebung

Cloud Shell führt beim Start Ihrer Instanz automatisch das Skript $HOME/.customize_environment aus. Anders als .profile oder .bashrc wird dieses Skript einmal beim Starten von Cloud Shell ausgeführt (anstatt einmal für jede Shell-Anmeldung).

Dieses Skript wird als Root ausgeführt und kann mithilfe von Debian-Paketverwaltungsbefehlen installiert werden, die in jeder Cloud Shell-Sitzung vorhanden sein sollen.

Wenn Sie beispielsweise erlang auf Cloud Shell installieren möchten, sieht Ihre .customize_environment-Datei folgendermaßen aus:

#!/bin/sh
apt-get update
apt-get -y install erlang

Ausführungsprotokolle Ihres .customize_environment-Skripts finden Sie unter /var/log/customize_environment. Das Skript .customize_environment wird als Hintergrundprozess ausgeführt. Bei erfolgreicher Ausführung berühren Sie /google/devshell/customize_environment_done. Da die Paketinstallation parallel mit Ihrer Anmeldung ausgeführt wird, sind die installierten Pakete möglicherweise bereits kurz nach dem Eingabeaufforderung der Anmeldung verfügbar.

Cloud Shell mit einem bestimmten Nutzerkonto öffnen

Mit dem Parameter authuser können Sie ein Nutzerkonto für die Verwendung mit Cloud Shell angeben. Sie müssen mit dem angegebenen Nutzerkonto angemeldet sein. Wenn Sie nicht im angegebenen Konto angemeldet sind, wird Cloud Shell mit dem standardmäßig angemeldeten Konto geöffnet. Sie können beispielsweise Cloud Shell mit der URL shell.cloud.google.com?authuser=client1@example.com öffnen, wenn Sie als client1@example.com angemeldet sind.

tmux-Unterstützung

Cloud Shell verwendet tmux, um die Persistenz über Browsertabsitzungen hinweg zu verbessern. Wenn Sie beispielsweise dieGoogle Cloud Console in einem Tab aktualisieren oder von einem anderen Computer aus eine Verbindung zu Cloud Shell herstellen, geht der Sitzungsstatus nicht verloren.

Cloud Shell unterstützt die standardmäßigen tmux-Tastenkombinationen. Wenn Sie zum Beispiel Strg + B und anschließend % drücken, wird das aktuelle Sitzungsfenster durch tmuxin einen linken und einen rechten Bereich aufgeteilt. Dies kann für die Fehlerbehebung hilfreich sein.

Nutzungsstatistiken

Cloud Shell erfasst anonymisierte Nutzungsstatistiken zu Befehlen, die innerhalb des Cloud Shell-Terminals ausgeführt werden. Statistiken werden nur für Befehle erfasst, die in Cloud Shell vorinstalliert sind. Diese Messwerte können nicht Ihrem Konto zugeordnet werden.

Es werden keine Messwerte zu personenidentifizierbaren Informationen erhoben, z. B. zu Argumenten, die an diese Befehle übergeben werden.

Wenn Sie die Einstellungen für die Messwerterfassung jederzeit ändern möchten, wählen Sie im Menü Einstellungen Button "Einstellungen" die Option Nutzungsstatistiken für das Terminal aus. Jede Änderung Ihrer Einstellungen im Menü Einstellungen wird in der nächsten Sitzung wirksam. Um die Erfassung von Messwerten zu aktivieren oder zu deaktivieren, schließen Sie den Tab und öffnen Sie einen weiteren Tab, nachdem Sie Ihre Änderung vorgenommen haben.

Hinweis: Dies hat keine Auswirkungen auf die gcloud-Nutzungsstatistiken, die in Cloud Shell standardmäßig aktiviert sind.

Führen Sie in Ihrer Cloud Shell-Sitzung den folgenden Befehl aus, um die Erfassung von gcloud CLI-Messwerten zu deaktivieren:

gcloud config set disable_usage_reporting true