Auf dieser Seite wird beschrieben, wie Sie ein benutzerdefiniertes Docker-Image als Cloud Shell-Umgebung erstellen und verwenden.
Erstellen Sie für eine benutzerdefinierte Cloud Shell-Umgebung ein Docker-Image, das als benutzerdefinierte Cloud Shell-Umgebung mit den angegebenen zusätzlichen Paketen und benutzerdefinierten Konfigurationen dient. Das Docker-Image muss auf dem Cloud Shell-Basis-Image basieren und in Container Registry gehostet werden.
Benutzerdefiniertes Docker-Image erstellen
Klicken Sie auf Anleitung, um eine detaillierte Anleitung für diese Aufgabe direkt im Cloud Shell-Editor zu erhalten:
Erstellen Sie Ihr eigenes benutzerdefiniertes Docker-Image:
Führen Sie in einem Cloud Shell-Terminal-Tab den folgenden Befehl aus, um ein benutzerdefiniertes Standard-Image in einem von Cloud Source Repositories gehosteten Repository zu erstellen:
cloudshell env create-custom-image NEW_REPO_NAME
Wenn Sie alternativ lieber manuell in Container Registry bereitstellen oder Ihren eigenen Automatisierungsablauf verwenden möchten, können Sie ein neues, leeres Dockerfile erstellen und mit Schritt 3 fortfahren.
Öffnen Sie das neue Dockerfile. Folgen Sie dazu der Anleitung in der Befehlszeile:
cd $HOME/NEW_REPO_NAME && cloudshell edit Dockerfile
Fügen Sie unter der ersten Zeile alle zusätzlichen Pakete hinzu, die Sie in Ihrer Cloud Shell-Umgebung zur Verfügung stellen möchten. Beispiel:
FROM gcr.io/cloudshell-images/cloudshell:latest RUN apt-get -y install lsof
In der ersten Zeile des Dockerfile
FROM gcr.io/cloudshell-images/cloudshell:latest
, verweist auf die Basis Cloud Shell-Image und sollte nicht entfernt werden.Erstellen Sie das Image lokal, indem Sie Folgendes ausführen:
cloudshell env build-local
Testen Sie Ihr Image lokal und prüfen Sie, ob Ihre installierten Pakete vorhanden sind. Führen Sie dazu folgenden Befehl aus:
cloudshell env run
Führen Sie Folgendes aus, um die Tests zu beenden:
exit
Wenden Sie Ihre Codeänderungen lokal an:
git commit -a -m "Initial custom environment check-in."
Übertragen Sie die Codeänderungen per Push an Cloud Source Repositories:
git push origin master
Übertragen Sie Ihr benutzerdefiniertes Image schließlich per Push an Container Registry:
cloudshell env push
Link „In Cloud Shell öffnen“ aktualisieren
Wenn Sie Ihr benutzerdefiniertes Image mit einem In Cloud Shell öffnen-Link verwenden möchten, müssen Sie es zuerst veröffentlichen. Wie Sie ein benutzerdefiniertes Image veröffentlichen, erfahren Sie in der Anleitung zur Zugriffssteuerung in Container Registry.
Nachdem Sie die richtigen Zugriffseinstellungen eingerichtet haben, können Sie Ihre
Link In Cloud Shell öffnen, um cloudshell_git_repo
anzugeben
und cloudshell_image
. Um beispielsweise eine Open in Cloud Platform
Schaltfläche "Shell" und bearbeiten Sie die URLs im folgenden Beispiel. Fügen Sie dann einen Link
in Ihre Markdown-Datei einfügen:
[![Open in Cloud Shell](https://gstatic.com/cloudssh/images/open-btn.svg)](https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=REPO_URL&cloudshell_image=DOCKER_IMAGE_URL)
Ersetzen Sie die folgenden Werte:
- REPO_URL: URL zum Speicherort Ihres Repositorys
- DOCKER_IMAGE_URL: URL zum Docker-Image
Weitere Informationen zu diesen und anderen Parametern finden Sie unter In Cloud Shell öffnen
Benutzerdefiniertes Container-Image auf dem neuesten Stand halten
Der benutzerdefinierte Container muss auf der aktuellen öffentlichen Version basieren Cloud Shell-Bild um mit Cloud Shell zu arbeiten. Wir empfehlen, wöchentliche Neuerstellungen durchzuführen um das benutzerdefinierte Image aktuell zu halten.