Cloud Shell konfigurieren

Auf dieser Seite wird beschrieben, wie Sie Cloud Shell konfigurieren können, um Ihre Umgebung 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 für die gcloud CLI in einem temporären tmp-Ordner gespeichert, der nur für den aktuellen Tab festgelegt ist. Sie sind nicht sitzungsübergreifend.

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

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

    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.

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

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 Konfigurationen der gcloud CLI, die Sie festlegen können. Eine vollständige Liste und weitere Informationen zum Festlegen von Eigenschaften finden Sie in der Anleitung zu gcloud-Befehlszeileneigenschaften.

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 Cloud Shell beispielsweise mit der URL shell.cloud.google.com?authuser=client1@example.com öffnen, wenn 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

In Cloud Shell wird tmux verwendet, um die Persistenz zwischen den Browsertabsitzungen zu verbessern. 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 den folgenden Befehl in Ihrer Cloud Shell-Sitzung aus, um die Erfassung von gcloud-Befehlszeilenmesswerten zu deaktivieren:

gcloud config set disable_usage_reporting true