Mit der Funktion „In Cloud Shell öffnen“ können Sie einen Link veröffentlichen, über den die Google Cloud Console mit einem in Cloud Shell geklonten Git-Repository geöffnet und/oder Cloud Shell mit einem benutzerdefinierten Image gestartet wird. Sie können auch Anweisungen an das Terminal ausgeben, um Nutzern die Interaktion mit dem Inhalt zu erleichtern.
Über „In Cloud Shell öffnen“-Links können Entwickler mit Ihren Codebeispielen und APIs experimentieren, ohne die Google Cloud CLI herunterladen, die erforderlichen Abhängigkeiten installieren oder nach relevanten Quelldateien suchen zu müssen. Auf dieser Seite wird erläutert, wie Sie Ihrem Git-Repository den Link „In Cloud Shell öffnen“ hinzufügen.
URL-Parameter
Ein Link zum Öffnen in Cloud Shell, der optional in ein Schaltflächenbild eingebettet ist, kann der Datei README.md eines beliebigen Verzeichnisses in Ihrem Git-Repository hinzugefügt werden. Der empfohlene Speicherort für diesen Link ist die Stammdatei README.md Ihres Git-Repositorys.
Erforderlicher URL-Parameter
Verwenden Sie zum Erstellen dieses Links die Basis-URL shell.cloud.google.com (oder eine beliebige Seite in der Google Cloud Console, die mit console.cloud.google.com beginnt) mit dem folgenden erforderlichen URL-Parameter:
| URL-Parameter | Beschreibung | Unterstützte Werte |
|---|---|---|
cloudshell_git_repo |
URL des zu klonenden Git-Repositorys Nachdem das Repository geklont wurde, wird das Stammverzeichnis des Projektordners geöffnet. Der Inhalt wird im linken Navigationsbereich angezeigt. |
Gültige URL für ein Git-Repository. Diese URL besteht aus einer zulässigen Domain (GitHub oder Bitbucket) und einem Pfad. Die folgenden Zeichen sind zulässig: Groß- und Kleinbuchstaben, Ziffern, Unterstriche (_), Bindestriche (-), Punkte (.) und Schrägstriche (/). |
Optionale URL-Parameter
Sie können auch einen der folgenden optionalen Parameter angeben:
| URL-Parameter | Beschreibung | Unterstützte Werte |
|---|---|---|
cloudshell_git_branch
|
Zweig vom zu klonenden Git-Repository Gilt nur, wenn cloudshell_git_repo angegeben ist. Der Standardzweig ist master. | Ein beliebiger gültiger Zweig im Repository. Die folgenden Zeichen sind zulässig: Groß- und Kleinbuchstaben, Ziffern, Tilden (~), Unterstriche (_), Bindestriche (-), Punkte (.), Schrägstriche (/) und Doppelpunkte (:). |
cloudshell_image
|
Benutzerdefiniertes Docker-Image, in dem während der Sitzung eine benutzerdefinierte Umgebung ausgeführt wird. Auf diese Weise können Sie in Cloud Shell angepasste Tools bereitstellen, die Nutzer zum Arbeiten mit Ihrem Repository verwenden können. Wenn Sie in Cloud Shell ein Repository mit diesem Parameter öffnen, wird eine temporäre Umgebung mit einem Scratch-Basisverzeichnis erstellt, das am Ende der Sitzung gelöscht wird. |
URL eines Docker-Images, das in der Container Registry gehostet wird. Das Docker-Image muss auf dem Cloud Shell-Basis-Image basieren und öffentlich zugänglich sein. Verwenden Sie zum Erstellen eines gültigen Images die Anleitung zur Erstellung benutzerdefinierter Images, die Sie mit dem folgenden Befehl in Cloud Shell starten können:
Der Download auf eine Cloud Shell-VM dauert etwas länger. |
cloudshell_open_in_editor
|
Datei(en), die im Cloud Shell-Editor geöffnet werden soll(en) Kann wiederholt werden, um mehrere Dateien zum Öffnen anzugeben. Wenn mehrere angegeben sind, werden diese in der angegebenen Reihenfolge geöffnet. Angegebene Datei(en) werden in den rechten Tabs des Editors geöffnet; ein Tab pro Datei im geöffneten Projekt. Dateipfade beziehen sich auf das aktuelle Verzeichnis. Wenn der Parameter working_dir angegeben wird, wird der Pfad zu diesen Dateien so betrachtet, als würde er sich auf working_dir beziehen. |
Jeder gültige Dateipfad, der aus den folgenden zulässigen Zeichen besteht: Groß- und Kleinbuchstaben, Ziffern, Tilden (~), Unterstriche (_), Bindestriche (-), Punkte (.), Schrägstriche (/) und Doppelpunkte (:). |
cloudshell_print
|
Datei im Git-Repository, die in der Regel aus Anleitungen besteht, die an das Terminal ausgegeben werden, um die nächsten Schritte eines Nutzers zu steuern. Der Dateipfad bezieht sich auf das aktuelle Verzeichnis. Wenn der Parameter working_dir angegeben wird, wird der Pfad zu dieser Datei so betrachtet, als würde er sich auf working_dir beziehen. |
Jeder gültige Dateipfad, der aus den folgenden zulässigen Zeichen besteht: Groß- und Kleinbuchstaben, Ziffern, Tilden (~), Unterstriche (_), Bindestriche (-), Punkte (.), Schrägstriche (/) und Doppelpunkte (:). |
cloudshell_tutorial
|
Anleitungs-Markup-Datei im Git-Repository mit Anweisungen, die als Anleitung gestartet werden, um Nutzer durch ein Projekt zu führen. Der Dateipfad bezieht sich auf das aktuelle Verzeichnis. |
Jede korrekt formatierte Anleitungs-Markdown-Datei mit gültigem Dateinamen. |
cloudshell_working_dir (eingestellt)
|
Dieser Parameter wurde eingestellt. Verwenden Sie stattdessen |
Jeder gültige Dateipfad, der aus den folgenden zulässigen Zeichen besteht: Groß- und Kleinbuchstaben, Ziffern, Tilden (~), Unterstriche (_), Bindestriche (-), Punkte (.), Schrägstriche (/) und Doppelpunkte (:). |
cloudshell_workspace
|
Arbeitsverzeichnis für Cloud Shell. Das Terminal wird im angegebenen Verzeichnis geöffnet. Cloud Shell-Editor öffnet das Verzeichnis als Arbeitsbereich. | Jeder gültige Dateipfad relativ zum geklonten Repository. Sie können den Parameterwert leer lassen oder . verwenden, um das Stammverzeichnis des geklonten Repositorys festzulegen. Wenn kein zusätzliches Repository angegeben ist, bezieht sich der Pfad auf das Cloud Shell-Basisverzeichnis. Die folgenden Zeichen sind zulässig: Groß- und Kleinbuchstaben, Ziffern, Tilden (~), Unterstriche (_), Bindestriche (-), Punkte (.), Schrägstriche (/), Doppelpunkte (:)
|
ephemeral |
Wenn Sie in Cloud Shell ein Repository mit diesem Parameter öffnen, wird eine temporäre Umgebung mit einem Scratch-Basisverzeichnis erstellt, das am Ende der Sitzung gelöscht wird. Weitere Informationen finden Sie unter Flüchtigen Modus auswählen. |
|
show
|
Öffnen Sie sie nur mit dem Terminal, nur mit dem Cloud Shell-Editor oder mit beiden. |
|
Beispiele
Wenn Sie eine Schaltfläche zum Öffnen eines Beispiel-Git-Repositorys in Cloud Shell einbetten möchten, fügen Sie den folgenden Markdown-Code in die README.md-Datei Ihres Repositorys ein:
[](https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=http://path-to-repo/sample.git)
Verwenden Sie dieses entsprechende HTML-Snippet, um dieselbe Funktionalität in eine Website einzubetten:
<a href="https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=http://path-to-repo/sample.git">
<img alt="Open in Cloud Shell" src ="https://gstatic.com/cloudssh/images/open-btn.svg">
</a>
Im Cloud Shell-Linkgenerator öffnen
Wenn Sie das Verhalten des Links „In Cloud Shell öffnen“ genauer definieren möchten, können Sie das folgende Formular verwenden, um mit den Parametern zu experimentieren, die zum Öffnen Ihres Repositorys in Cloud Shell erforderlich sind.