1. Hinweis
Websites zu betreiben kann mit dem Aufwand zum Erstellen und Verwalten von VM-Instanzen, Clustern, Pods, Diensten und mehr schwierig sein. Das ist bei größeren, mehrstufigen Anwendungen in Ordnung, aber wenn Sie nur versuchen, Ihre Website bereitzustellen und sichtbar zu machen, ist das viel Aufwand.
Mit Cloud Run, der Google Cloud-Implementierung von Knative, können Sie Ihre Website ohne den Aufwand für VM- oder Kubernetes-basierte Bereitstellungen verwalten und bereitstellen. Dies ist nicht nur aus Verwaltungsperspektive ein einfacherer Ansatz, sondern bietet Ihnen auch die Möglichkeit, auf null zu skalieren, wenn keine Anfragen an Ihre Website eingehen.
Cloud Run ermöglicht nicht nur die serverlose Entwicklung für Container, sondern kann auch in Ihren eigenen GKE-Clustern (Google Kubernetes Engine) oder auf einer vollständig verwalteten PaaS-Lösung (Platform as a Service) von Cloud Run ausgeführt werden. In diesem Codelab testen Sie das zweite Szenario.
Das folgende Diagramm veranschaulicht den Ablauf der Bereitstellung und des Cloud Run-Hostings. Sie beginnen mit einem über Cloud Build erstellten Docker-Image, das Sie in Cloud Shell auslösen. Anschließend stellen Sie dieses Image mit einem Befehl in Cloud Shell in Cloud Run bereit.
Vorbereitung
- Allgemeine Vertrautheit mit Docker (siehe Abschnitt Erste Schritte auf der Docker-Website.)
Lerninhalte
- Docker-Image mit Cloud Build erstellen und auf gcr.io hochladen
- Docker-Images in Cloud Run bereitstellen
- Cloud Run-Deployments verwalten
- Endpunkt für eine Anwendung in Cloud Run einrichten
Aufgaben
- Eine statische Website, die in einem Docker-Container ausgeführt wird
- Eine Version dieses Containers, die in Container Registry gespeichert ist
- Eine Cloud Run-Bereitstellung für Ihre statische Website
Voraussetzungen
- Ein Google-Konto mit Administratorzugriff zum Erstellen von Projekten oder ein Projekt mit der Rolle „Projektinhaber“
2. Umgebung einrichten
Umgebung zum selbstbestimmten Lernen einrichten
Wenn Sie noch kein Google-Konto haben, müssen Sie ein Konto erstellen. Melden Sie sich dann in der Google Cloud Console an und klicken Sie auf Projekt > Projekt erstellen
Notieren Sie sich die Projekt-ID, die automatisch unter dem Projektnamen eingefügt wird. Die Projekt-ID ist ein eindeutiger Name, der in allen Google Cloud-Projekten eindeutig ist. Der Name auf dem Screenshot wurde also bereits erstellt und funktioniert nicht bei Ihnen. Sie wird später als PROJECT_ID bezeichnet.
Als Nächstes müssen Sie in der Cloud Console die Abrechnung aktivieren, um Google Cloud-Ressourcen und die Cloud Run API zu aktivieren.
Cloud Run API aktivieren
Klicke auf das Navigationsmenü ☰ > APIs und Dienste > Dashboard > APIs und Dienste aktivieren .
Suchen Sie nach „Cloud Run API“ Klicken Sie dann auf Cloud Run API > Aktivieren:
Dieses Codelab sollte nicht mehr als ein paar Euro kosten. Wenn Sie jedoch mehr Ressourcen verwenden oder diese weiter ausführen, kann es mehr sein. Weitere Informationen finden Sie unter Bereinigen am Ende. Weitere Informationen finden Sie unter Preise.
Neue Google Cloud-Nutzer haben Anspruch auf eine kostenlose Testversion mit 300$Guthaben.
Cloud Shell
Während Sie Google Cloud und Cloud Run über Ihren Laptop aus der Ferne bedienen können, verwenden Sie dafür Cloud Shell, eine Befehlszeilenumgebung, die in Google Cloud ausgeführt wird. Die Umgebung ist mit allen Clientbibliotheken und Frameworks vorkonfiguriert, die Sie benötigen.
Diese Debian-basierte virtuelle Maschine verfügt über alle erforderlichen Entwicklungstools. Es bietet ein Basisverzeichnis mit 5 GB nichtflüchtigem Speicher und wird in Google Cloud ausgeführt. Dadurch werden die Netzwerkleistung und die Authentifizierung erheblich verbessert. Für dieses Codelab benötigen Sie also nur einen Browser – ja, er funktioniert auf Chromebooks.
- Klicken Sie einfach auf Cloud Shell aktivieren
, um Cloud Shell über die Cloud Console zu aktivieren. Die Bereitstellung und Verbindung mit der Umgebung dauert einen Moment.
Sobald Sie mit Cloud Shell verbunden sind, sollten Sie sehen, dass Sie bereits authentifiziert sind und dass das Projekt bereits auf Ihre PROJECT_ID eingestellt ist.
gcloud auth list
Befehlsausgabe
Credentialed accounts: - <myaccount>@<mydomain>.com (active)
gcloud config list project
Befehlsausgabe
[core] project = <PROJECT_ID>
Sollte das Projekt aus irgendeinem Grund nicht eingerichtet sein, geben Sie einfach den folgenden Befehl ein:
gcloud config set project <PROJECT_ID>
Du suchst dein Gerät (PROJECT_ID)? Sehen Sie nach, welche ID Sie bei den Einrichtungsschritten verwendet haben, oder rufen Sie sie im Dashboard der Cloud Console auf:
Cloud Shell legt außerdem standardmäßig einige Umgebungsvariablen fest, die bei der Ausführung zukünftiger Befehle nützlich sein können.
echo $GOOGLE_CLOUD_PROJECT
Befehlsausgabe
<PROJECT_ID>
- Legen Sie schließlich die Standardzone und die Projektkonfiguration fest.
gcloud config set compute/zone us-central1-f
Sie können verschiedene Zonen auswählen. Weitere Informationen finden Sie unter Regionen und Zonen.
3. Quell-Repository klonen
Da Sie eine vorhandene Website bereitstellen, müssen Sie nur die Quelle aus Ihrem Repository klonen, sodass Sie sich auf die Erstellung von Docker-Images und die Bereitstellung in Cloud Run konzentrieren können.
Führen Sie die folgenden Befehle aus, um das Repository in Ihre Cloud Shell-Instanz zu klonen und in das entsprechende Verzeichnis zu wechseln. Außerdem installieren Sie die Node.js-Abhängigkeiten, damit Sie Ihre Anwendung vor der Bereitstellung testen können.
cd ~ git clone https://github.com/googlecodelabs/monolith-to-microservices.git cd ~/monolith-to-microservices ./setup.sh
Dadurch wird Ihr Repository geklont, das Verzeichnis gewechselt und die Abhängigkeiten installiert, die für die lokale Ausführung Ihrer Anwendung erforderlich sind. Es kann einige Minuten dauern, bis das Skript ausgeführt wird.
Gehen Sie mit der Due-Diligence-Prüfung vor und testen Sie Ihre App. Führen Sie den folgenden Befehl aus, um den Webserver zu starten:
cd ~/monolith-to-microservices/monolith npm start
Ausgabe:
Monolith listening on port 8080!
Sie können sich eine Vorschau Ihrer App ansehen, indem Sie auf Webvorschau
klicken und Vorschau auf Port 8080 auswählen.
Dadurch wird ein neues Fenster geöffnet, in dem Sie Ihren Fancy Store in Aktion sehen können.
Sie können dieses Fenster schließen, nachdem Sie die Website aufgerufen haben. Drücken Sie im Terminalfenster CONTROL+C (Command+C auf einem Macintosh), um den Webserverprozess zu beenden.
4. Docker-Container mit Cloud Build erstellen
Da Ihre Quelldateien nun bereit sind, können Sie nun die Docker-Datei für Ihre Anwendung erstellen.
Normalerweise müssen Sie einen zweistufigen Ansatz verfolgen. Dieser besteht darin, einen Docker-Container zu erstellen und ihn per Push in eine Registry zu übertragen, um das Image zu speichern, aus dem GKE abgerufen werden kann. Sie können das Leben jedoch einfacher gestalten, wenn Sie mit Cloud Build den Docker-Container mit einem einzigen Befehl erstellen und das Image in Container Registry ablegen. Wie Sie ein Dockerfile manuell erstellen und per Push übertragen, erfahren Sie unter Schnellstart für Container Registry.
Cloud Build komprimiert die Dateien aus dem Verzeichnis und verschiebt sie in einen Cloud Storage-Bucket. Beim Build-Prozess werden dann alle Dateien aus dem Bucket abgerufen und das Dockerfile verwendet, das sich im selben Verzeichnis zum Ausführen des Docker-Build-Prozesses befindet. Wenn Sie das Flag --tag mit dem Host als gcr.io für das Docker-Image angegeben haben, wird das resultierende Docker-Image per Push in Container Registry übertragen.
Prüfen Sie zuerst, ob die Cloud Build API aktiviert ist. Führen Sie dazu folgenden Befehl aus:
gcloud services enable cloudbuild.googleapis.com
Führen Sie nach der Aktivierung der API den folgenden Befehl in Cloud Shell aus, um den Build-Prozess zu starten:
gcloud builds submit --tag gcr.io/${GOOGLE_CLOUD_PROJECT}/monolith:1.0.0 .
Dieser Vorgang dauert einige Minuten. Nach Abschluss des Vorgangs wird im Terminal in etwa folgende Ausgabe angezeigt:
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- ID CREATE_TIME DURATION SOURCE IMAGES STATUS 1ae295d9-63cb-482c-959b-bc52e9644d53 2019-08-29T01:56:35+00:00 33S gs://<PROJECT_ID>_cloudbuild/source/1567043793.94-abfd382011724422bf49af1558b894aa.tgz gcr.io/<PROJECT_ID>/monolith:1.0.0 SUCCESS
Wenn Sie Ihren Build-Verlauf ansehen oder den Prozess in Echtzeit verfolgen möchten, öffnen Sie die Cloud Console und klicken Sie auf das Navigationsmenü Ђ. Cloud Build > Verlauf: Dort sehen Sie eine Liste aller vorherigen Builds, es sollte jedoch nur derjenige vorhanden sein, den Sie erstellt haben.
Wenn Sie auf die Build-ID klicken, sehen Sie alle Details für diesen Build, einschließlich der Logausgabe. Sie können das erstellte Container-Image anzeigen, indem Sie auf den Link neben Image klicken.
5. Container in Cloud Run bereitstellen
Nachdem Sie Ihre Website in einen Container verlagert und per Push-Befehl an Container Registry übertragen haben, können Sie sie in Cloud Run bereitstellen.
Dazu haben Sie zwei Möglichkeiten:
- Cloud Run (vollständig verwaltet) ist das PaaS-Modell, bei dem der gesamte Lebenszyklus eines Containers verwaltet wird. Sie nutzen diesen Ansatz für dieses Codelab.
- Cloud Run for Anthos ist Cloud Run mit einer zusätzlichen Steuerungsebene, mit der Sie Ihre Cluster und Pods aus GKE importieren können. Weitere Informationen finden Sie unter Cloud Run for Anthos in Google Cloud einrichten.
Befehlszeilenbeispiele befinden sich in Cloud Shell unter Verwendung der Umgebungsvariablen, die Sie zuvor eingerichtet haben.
Befehlszeile
Stellen Sie die Anwendung mit dem folgenden Befehl bereit:
gcloud run deploy --image=gcr.io/${GOOGLE_CLOUD_PROJECT}/monolith:1.0.0 --platform managed
Sie werden aufgefordert, die Region anzugeben, in der Sie Anzeigen schalten möchten. Wählen Sie die Region aus, die Ihnen am nächsten ist, und übernehmen Sie dann den vorgeschlagenen Standarddienstnamen (monolith).
Lassen Sie zu Testzwecken nicht authentifizierte Anfragen an die App zu. Geben Sie y in die Eingabeaufforderung ein.
Deployment prüfen
Führen Sie den folgenden Befehl aus, um zu prüfen, ob die Bereitstellung erfolgreich erstellt wurde. Es kann einen Moment dauern, bis Pod status zu Running wird:
gcloud run services list
Wählen Sie [1] Cloud Run (vollständig verwaltet) aus.
Ausgabe:
SERVICE REGION URL LAST DEPLOYED BY LAST DEPLOYED AT ✔ monolith us-east1 <your url> <your email> 2019-09-16T21:07:38.267Z
Die Ausgabe zeigt verschiedene Dinge. Sie sehen Ihre Bereitstellung, den Nutzer, der sie bereitgestellt hat (Ihre E-Mail-Adresse), und die URL, über die Sie auf die Anwendung zugreifen können. Es wurde alles erstellt.
Öffnen Sie die URL in der Liste der Dienste in Ihrem Webbrowser. Sie sollten dieselbe Website sehen, die Sie lokal in der Vorschau angezeigt haben.
6. Neue Überarbeitung mit niedrigerem Gleichzeitigkeitswert erstellen
Stellen Sie Ihre Anwendung nun wieder bereit, aber passen Sie diesmal einen der Parameter an.
Standardmäßig hat eine Cloud Run-Anwendung einen Gleichzeitigkeitswert von 80. Das bedeutet, dass jede Containerinstanz bis zu 80 Anfragen gleichzeitig verarbeitet. Das ist eine erhebliche Abweichung vom FaaS-Modell (Function as a Service), bei dem eine Instanz immer nur eine Anfrage verarbeitet.
Stellen Sie dasselbe Container-Image mit einem Gleichzeitigkeitswert von 1 noch einmal bereit (nur zu Testzwecken) und sehen Sie sich an, was passiert.
gcloud run deploy --image=gcr.io/${GOOGLE_CLOUD_PROJECT}/monolith:1.0.0 --platform managed --concurrency 1
Beantworten Sie die nachfolgenden Fragen wie beim ersten Mal. Wenn der Befehl erfolgreich ausgeführt wurde, sehen Sie sich das Ergebnis in der Cloud Console an.
Klicken Sie im Cloud Run-Dashboard auf den Dienst monolith, um die Details aufzurufen.
Klicken Sie auf den Tab Überarbeitungen. Sie sollten zwei erstellte Versionen sehen. Klicken Sie auf monolith-00002 und überprüfen Sie die Details. Der Wert für die Gleichzeitigkeit sollte auf 1 reduziert werden.
]
Obwohl diese Konfiguration für Tests ausreicht, haben Sie in den meisten Produktionsszenarien Container, die mehrere Anfragen gleichzeitig unterstützen.
Stellen Sie nun die ursprüngliche Nebenläufigkeit ohne eine erneute Bereitstellung wieder her. Sie können den Gleichzeitigkeitswert auf den Standardwert 80 oder 0 festlegen. Dadurch werden alle Einschränkungen für die Nebenläufigkeit entfernt und der Wert auf den Standardwert – zum Zeitpunkt der Erstellung dieses Dokuments – gesetzt.
Führen Sie in Cloud Shell den folgenden Befehl aus, um die aktuelle Version zu aktualisieren:
gcloud run deploy --image=gcr.io/${GOOGLE_CLOUD_PROJECT}/monolith:1.0.0 --platform managed --concurrency 80
Beachten Sie, dass eine weitere Überarbeitung erstellt wurde, dass der Traffic weitergeleitet wurde und die Gleichzeitigkeit wieder auf 80 zurücksteigt.
7. Website ändern
Ihr Marketingteam hat Sie gebeten, die Startseite der Website Ihres Unternehmens zu ändern. Es sollte mehr Informationen über das Angebot und die Angebote des Unternehmens enthalten. In diesem Abschnitt fügen Sie der Startseite Text hinzu, um das Marketingteam zufriedenzustellen.
Offenbar hat einer Ihrer Entwickler die Änderungen bereits unter dem Dateinamen index.js.new erstellt. Kopieren Sie diese Datei einfach nach index.js. Ihre Änderungen werden dann übernommen. Folgen Sie der Anleitung, um die entsprechenden Änderungen vorzunehmen.
Führen Sie die folgenden Befehle aus, kopieren Sie die aktualisierte Datei in den richtigen Dateinamen und geben Sie den Inhalt aus, um die Änderungen zu prüfen:
cd ~/monolith-to-microservices/react-app/src/pages/Home mv index.js.new index.js cat ~/monolith-to-microservices/react-app/src/pages/Home/index.js
Der Code sollte dann in etwa so aussehen:
/*
Copyright 2019 Google LLC
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
https://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/
import React from "react";
import { makeStyles } from "@material-ui/core/styles";
import Paper from "@material-ui/core/Paper";
import Typography from "@material-ui/core/Typography";
const useStyles = makeStyles(theme => ({
root: {
flexGrow: 1
},
paper: {
width: "800px",
margin: "0 auto",
padding: theme.spacing(3, 2)
}
}));
export default function Home() {
const classes = useStyles();
return (
<div className={classes.root}>
<Paper className={classes.paper}>
<Typography variant="h5">
Fancy Fashion & Style Online
</Typography>
<br />
<Typography variant="body1">
Tired of mainstream fashion ideas, popular trends and societal norms?
This line of lifestyle products will help you catch up with the Fancy trend and express your personal style.
Start shopping Fancy items now!
</Typography>
</Paper>
</div>
);
}
Sie haben die React-Komponenten aktualisiert, müssen aber noch die React-Anwendung erstellen, um die statischen Dateien zu generieren. Führen Sie den folgenden Befehl aus, um die React-Anwendung zu erstellen und in das öffentliche monolith-Verzeichnis zu kopieren:
cd ~/monolith-to-microservices/react-app npm run build:monolith
Nachdem der Code aktualisiert wurde, müssen Sie den Docker-Container neu erstellen und in Container Registry veröffentlichen. Sie können denselben Befehl wie zuvor verwenden, nur dass Sie dieses Mal das Versionslabel aktualisieren.
Führen Sie den folgenden Befehl aus, um ein neues Cloud Build mit der aktualisierten Image-Version 2.0.0 auszulösen:
cd ~/monolith-to-microservices/monolith
#Feel free to test your application
npm start
gcloud builds submit --tag gcr.io/${GOOGLE_CLOUD_PROJECT}/monolith:2.0.0 .
Im nächsten Abschnitt verwenden Sie dieses Bild, um Ihre Anwendung ohne Ausfallzeiten zu aktualisieren.
8. Website ohne Ausfallzeit aktualisieren
Die Änderungen wurden durchgeführt und das Marketingteam ist mit dem Ergebnis sehr zufrieden. Es ist an der Zeit, die Website ohne Unterbrechung für die Nutzer zu aktualisieren.
In Cloud Run wird jede Bereitstellung als neue Version behandelt. Diese wird online gestellt und der Traffic wird an sie weitergeleitet.
Aktualisieren Sie Ihre Website anhand der folgenden Anleitung.
Befehlszeile
Sie können den Dienst über die Befehlszeile noch einmal bereitstellen, um das Image mit dem folgenden Befehl auf eine neue Version zu aktualisieren:
gcloud run deploy --image=gcr.io/${GOOGLE_CLOUD_PROJECT}/monolith:2.0.0 --platform managed
Deployment prüfen
Prüfen Sie die Aktualisierung der Bereitstellung mit dem folgenden Befehl:
gcloud run services describe monolith --platform managed
Sie erhalten folgende Ausgabe:
apiVersion: serving.knative.dev/v1alpha1
kind: Service
metadata:
annotations:
client.knative.dev/user-image: gcr.io/my-cloudrun-codelab/monolith:2.0.0
...
Sie werden feststellen, dass Ihr Dienst jetzt die neueste Version Ihres Images verwendet, die in einer neuen Version bereitgestellt wurde.
Rufen Sie die externe URL Ihres Cloud Run-Dienstes noch einmal auf, um Ihre Änderungen zu prüfen, und sehen Sie nach, dass der App-Titel aktualisiert wurde.
Führen Sie den folgenden Befehl aus, um die Dienste aufzulisten und die IP-Adresse aufzurufen, falls Sie sie vergessen haben:
gcloud run services list
Ihre Website sollte jetzt den Text anzeigen, den Sie der Homepage-Komponente hinzugefügt haben!
9. Bereinigen
Container Registry-Images löschen
# Delete the container image for version 1.0.0 of our monolith
gcloud container images delete gcr.io/${GOOGLE_CLOUD_PROJECT}/monolith:1.0.0 --quiet
# Delete the container image for version 2.0.0 of our monolith
gcloud container images delete gcr.io/${GOOGLE_CLOUD_PROJECT}/monolith:2.0.0 --quiet
Cloud Build-Artefakte aus Cloud Storage löschen
# The following command will take all source archives from all builds and delete them from cloud storage
# Run this command to print all sources:
# gcloud builds list | awk 'NR > 1 {print $4}'
gcloud builds list | awk 'NR > 1 {print $4}' | while read line; do gsutil rm $line; done
Cloud Run-Dienst löschen
gcloud run services delete monolith --platform managed
10. Glückwunsch
Sie haben Ihre Website mit Cloud Run bereitgestellt, skaliert und aktualisiert.