Cloud Shell konfigurieren

Auf dieser Seite wird beschrieben, wie Sie Cloud Shell konfigurieren können, um die Nutzung anzupassen.

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 CLI

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

Wenn die Konfigurationen der gcloud CLI bestehen bleiben sollen, können Sie sie mit einer der folgenden Methoden festlegen:

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

    Dadurch wird sichergestellt, dass für jeden neuen Tab Ihr Google Cloud Console-Projekt und Ihre benutzerdefinierte Standardkonfiguration übernommen werden. Sie können die Konfiguration der einzelnen Tabs aber auch weiter anpassen.

  • Wenn Sie immer dieselbe gcloud CLI verwenden möchten, fügen Sie export CLOUDSDK_CONFIG=$HOME/.config/gcloud am Ende der .bashrc-Datei ein und führen 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 ausführlichere Informationen zum Festlegen von Attributen finden Sie im Leitfaden zu den 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 zur 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 Cloud Shell beispielsweise öffnen, wenn Sie als client1@example.com angemeldet sind. Verwenden Sie dazu die URL shell.cloud.google.com?authuser=client1@example.com.

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

Durch die standardmäßige Verwendung von tmux in Cloud Shell ist eine bessere Persistenz der Daten zwischen den Browsertabsitzungen gewährleistet. Wenn Sie beispielsweise die Google Cloud Console in einem Tab aktualisieren oder von einer anderen Maschine 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.

Um tmux in der Cloud Shell zu deaktivieren, klicken Sie auf die Schaltfläche Terminaleinstellungen (Schraubenschlüsselsymbol), wählen Sie Tmux-Einstellungen aus und deaktivieren Sie die Option Tmux-Integration aktivieren.

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 den folgenden Befehl in Ihrer Cloud Shell-Sitzung aus, um die Erfassung von gcloud CLI-Messwerten zu deaktivieren:

gcloud config set disable_usage_reporting true