Cloud Shell konfigurieren

Auf dieser Seite wird beschrieben, wie Sie Cloud Shell für die Nutzererfahrung anpassen.

Konfigurationsdateien in Ihrem Cloud Shell-Basisverzeichnis

Cloud Shell bietet 5 GB freien nichtflüchtigen Speicher, der als Ihr $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 „Standardanmeldedaten für Anwendungen“ zur Definition der Projekt-ID verwendet wird, ist so eingestellt, dass sie auf das aktive Projekt in Console 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.

Einstellungen für die gcloud-Befehlszeile

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

Damit die Konfigurationen der gcloud CLI erhalten bleiben, können Sie Folgendes festlegen: Verwenden Sie dazu eine der folgenden Methoden:

  • Damit die gcloud CLI-Konfiguration pro Tab anpassbar bleibt, aber die Standardkonfiguration selbst anpassen, können Sie gcloud hinzufügen. Konfigurationsbefehle (wie gcloud config set compute/region us-central1 zum Festlegen einer Standardregion) an das Ende der Datei $HOME/.bashrc an.

    Dadurch wird gewährleistet, dass jeder neue Tab Ihr Google Cloud Console-Projekt und Ihre benutzerdefinierte Standardkonfiguration übernimmt, aber auch die Konfiguration der einzelnen Tabs weiter angepasst werden kann.

  • Um immer dieselbe gcloud CLI-Konfiguration zu verwenden, fügen Sie export CLOUDSDK_CONFIG=$HOME/.config/gcloud am Ende der .bashrc-Datei und dann ausführen gcloud config configurations create CONFIG_NAME 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 obigen Befehle sind Beispiele für gcloud CLI-Konfigurationen, die Sie Folgendes festlegen: Eine vollständige Liste und weitere Informationen zum Festlegen der Eigenschaften finden Sie unter in der Anleitung zu Attributen der gcloud CLI.

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 mit dem standardmäßigen angemeldeten Konto geöffnet. Sie können beispielsweise Cloud Shell mit der URL shell.cloud.google.com?authuser=client1@example.com öffnen, wobei Sie als client1@example.com angemeldet sind.

Container-Image-Anpassung

Durch die Anpassung von Container-Images können Sie ein Docker-Image erstellen, das als benutzerdefinierte Cloud Shell-Umgebung mit den angegebenen zusätzlichen Paketen und benutzerdefinierten Konfigurationen dient. Ihr Docker-Image muss auf dem Cloud Shell-Basis-Image basieren und in Container Registry gehostet werden.

Weitere Informationen zum Erstellen eines benutzerdefinierten Container-Images finden Sie im Leitfaden zum Anpassen von Container-Images.

Im Gegensatz zur Umgebungsanpassung wirkt sich die Anpassung von Container-Images nicht auf Ihre standardmäßige Cloud Shell-Umgebung aus. Sie können Ihr benutzerdefiniertes Image mithilfe von In Cloud Shell öffnen-Links verwenden und freigeben.

tmux-Unterstützung

Cloud Shell nutzt tmux, um und bleiben über mehrere Browser-Tab-Sitzungen hinweg erhalten. Wenn Sie beispielsweise die Google Cloud Console in einem Tab aktualisieren oder eine Verbindung zu Cloud Shell von einem anderen Computer aus 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.

Messwerte werden nicht für persönlich identifizierbare Informationen erfasst, z. B. für Argumente, die an diese Befehle übergeben werden.

Um die Einstellungen für die Messwerterfassung jederzeit zu ändern, wählen Sie im Menü Einstellungen Statistiken zur Terminalnutzung aus Schaltfläche "Einstellungen". 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 folgenden Befehl aus, um die Messwerterfassung über die gcloud CLI zu deaktivieren. in Ihrer Cloud Shell-Sitzung an:

gcloud config set disable_usage_reporting true