In dieser Anleitung erfahren Sie, wie Sie Cloud Scheduler und Cloud Functions verwenden, um Compute Engine-Instanzen mithilfe von Ressourcenlabels automatisch nach einem regelmäßigen Zeitplan zu starten und zu beenden.
Lernziele
- Erstellen und Bereitstellen einer Reihe von Funktionen mit Cloud Functions, die Instanzen von Compute Engine starten und stoppen.
- Erstellen Sie mit Cloud Scheduler eine Reihe von Jobs, die Instanzen mit einem Ressourcenlabel
dev
so planen, dass sie montags bis freitags von 09:00 bis 17:00 Uhr ausgeführt werden und den typischen Geschäftszeiten entsprechen.
Kosten
In diesem Dokument verwenden Sie die folgenden kostenpflichtigen Komponenten von Google Cloud:
- Cloud Scheduler
- Cloud Functions
- Pub/Sub
- Compute Engine
Mit dem Preisrechner können Sie eine Kostenschätzung für Ihre voraussichtliche Nutzung vornehmen.
Hinweise
- Richten Sie Ihre Umgebung für Cloud Scheduler ein.
-
Cloud Functions, Pub/Sub, and Compute Engine APIs aktivieren.
Anwendungsarchitektur
Diese Lösung umfasst die folgenden Google Cloud-Komponenten:
- Compute Engine-Instanz, die nach einem Zeitplan ausgeführt werden soll.
- Cloud Functions zum Starten und Beenden der zu planenden Instanz.
- Pub/Sub-Nachrichten, die für jedes Start- und Stoppereignis gesendet und empfangen werden.
- Cloud Scheduler-Jobs, um Aufrufe nach einem festgelegten Zeitplan zum Starten und Beenden der Instanz auszuführen.
Standortanforderungen
Einige Komponenten werden nur in bestimmten Regionen unterstützt:
- Compute Engine-Instanz: Wird in allen unter Regionen und Zonen aufgeführten Regionen unterstützt.
- Cloud Functions: Wird in den unter Standorte aufgeführten Regionen unterstützt.
- Pub/Sub-Nachrichten: Sie werden global unterstützt, da Pub/Sub ein globaler Dienst ist.
- Cloud Scheduler-Jobs mit Pub/Sub-Zielen, die an allen Google Cloud-Standorten unterstützt werden.
Warum nicht HTTP statt Pub/Sub?
Wenn Sie diese Architektur vereinfachen möchten, können Sie HTTP-Trigger von Cloud Functions anstelle von Pub/Sub-Triggern verwenden.
In dieser Anleitung wird Pub/Sub als Cloud Functions-Trigger verwendet, da diese Methode früher sicherer als HTTP war. HTTP ist jedoch auch eine gute Wahl und kann jetzt durch eine Authentifizierung abgesichert werden.
Weitere Informationen zum Sichern von Cloud Functions finden Sie in der Übersicht zur Sicherheit von Cloud Functions. Einen Vergleich zwischen HTTP- und Pub/Sub-Triggern finden Sie in der Dokumentation zu Cloud Functions-Triggern.
Compute Engine-Instanz einrichten
Console
- Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf.
Zur Seite "VM-Instanzen". - Klicken Sie auf Instanz erstellen.
- Legen Sie als Name
dev-instance
fest. - Klicken Sie unter Labels auf Labels hinzufügen.
- Klicken Sie auf Label hinzufügen.
- Geben Sie
env
für Schlüssel unddev
für Wert ein. - Wählen Sie als Region us-west1 aus.
- Wählen Sie als Zone us-west1-b aus.
- Klicken Sie auf Speichern.
- Klicken Sie unten auf der Seite auf Erstellen.
gcloud
gcloud compute instances create dev-instance \ --network default \ --zone us-west1-b \ --labels=env=dev
Funktionen bereitstellen, die von Pub/Sub über Cloud Functions ausgelöst werden
Funktionen erstellen und implementieren
Console
Erstellen Sie die Startfunktion.
- Rufen Sie in der Google Cloud Console die Seite Cloud Functions auf.
Zur Seite "Cloud Functions". - Klicken Sie auf Funktion erstellen.
- Wählen Sie für Umgebung die Option 1. Generation aus.
- Legen Sie als Funktionsnamen
startInstancePubSub
fest. - Behalten Sie für Region den Standardwert bei.
- Wählen Sie als Triggertyp die Option Cloud Pub/Sub aus.
- Klicken Sie unter Cloud Pub/Sub-Thema auswählen auf Thema erstellen.
- Das Dialogfeld Thema erstellen sollte angezeigt werden.
- Geben Sie unter Themen-ID
start-instance-event
ein. - Klicken Sie auf Erstellen, um das Dialogfeld abzuschließen.
- Geben Sie unter Themen-ID
- Klicken Sie unten im Kästchen Trigger auf Speichern.
- Klicken Sie unten auf der Seite auf Weiter.
- Wählen Sie als Laufzeit Node.js 16 oder höher aus.
- Geben Sie als Einstiegspunkt
startInstancePubSub
ein. - Wählen Sie links im Code-Editor index.js aus.
Ersetzen Sie den Startcode durch den folgenden Code:
Wählen Sie links im Code-Editor package.json aus.
Ersetzen Sie den Startcode durch den folgenden Code:
Klicken Sie unten auf der Seite auf Deploy (Bereitstellen).
Erstellen Sie die Stoppfunktion.
- Sie sollten sich in der Google Cloud Console auf der Seite Cloud Functions befinden.
- Klicken Sie auf Funktion erstellen.
- Wählen Sie für Umgebung die Option 1. Generation aus.
- Legen Sie als Funktionsnamen
stopInstancePubSub
fest. - Behalten Sie für Region den Standardwert bei.
- Wählen Sie als Triggertyp die Option Cloud Pub/Sub aus.
- Klicken Sie unter Cloud Pub/Sub-Thema auswählen auf Thema erstellen.
- Das Dialogfeld Thema erstellen sollte angezeigt werden.
- Geben Sie unter Themen-ID
stop-instance-event
ein. - Klicken Sie auf Erstellen, um das Dialogfeld abzuschließen.
- Geben Sie unter Themen-ID
- Klicken Sie unten im Kästchen Trigger auf Speichern.
- Klicken Sie unten auf der Seite auf Weiter.
- Wählen Sie als Laufzeit Node.js 16 oder höher aus.
- Geben Sie als Einstiegspunkt
stopInstancePubSub
ein. - Wählen Sie links im Code-Editor index.js aus.
Ersetzen Sie den Startcode durch den folgenden Code:
Wählen Sie links im Code-Editor package.json aus.
Ersetzen Sie den Startcode durch den folgenden Code:
Klicken Sie unten auf der Seite auf Deploy (Bereitstellen).
gcloud
Erstellen Sie die Pub/Sub-Themen.
gcloud pubsub topics create start-instance-event
gcloud pubsub topics create stop-instance-event
Code abrufen
Laden Sie den Code herunter.
git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples.git
Sie können auch das Beispiel als ZIP-Datei herunterladen und extrahieren.
Wechseln Sie in das richtige Verzeichnis.
cd nodejs-docs-samples/functions/scheduleinstance/
Erstellen Sie die Start- und Stoppfunktionen.
Sie sollten sich im Verzeichnis nodejs-docs-samples/functions/scheduleinstance/
befinden.
gcloud functions deploy startInstancePubSub \ --trigger-topic start-instance-event \ --runtime nodejs18 \ --allow-unauthenticated
gcloud functions deploy stopInstancePubSub \ --trigger-topic stop-instance-event \ --runtime nodejs18 \ --allow-unauthenticated
(Optional) Prüfen Sie, ob die Funktionen ordnungsgemäß funktionieren
Console
Instanz beenden
- Rufen Sie in der Google Cloud Console die Seite Cloud Functions auf.
Zur Seite "Cloud Functions". - Klicken Sie auf die Funktion
stopInstancePubSub
. - Sie sollten eine Reihe von Tabs sehen: Allgemein, Trigger, Quelle, Berechtigungen und Testen. Klicken Sie auf den Tab Testen.
Geben Sie als Auslösendes Ereignis Folgendes ein:
{"data":"eyJ6b25lIjoidXMtd2VzdDEtYiIsICJsYWJlbCI6ImVudj1kZXYifQo="}
Dies ist einfach der String mit base64-Codierung für
{"zone":"us-west1-b", "label":"env=dev"}
.Wenn Sie Ihren eigenen String codieren möchten, können Sie ein beliebiges Base64-Codierungstool verwenden, das online zur Verfügung steht.
Klicken Sie auf Funktion testen.
Wenn die Ausführung abgeschlossen ist, sollte unter Ausgabe
Successfully stopped instance dev-instance
angezeigt werden. Es kann bis zu 60 Sekunden dauern, bis der Vorgang abgeschlossen ist.Wenn stattdessen
error: 'Error: function failed to load.'
angezeigt wird, warten Sie etwa 10 Sekunden, bis die Bereitstellung der Funktion abgeschlossen ist, und versuchen Sie es noch einmal.Wenn stattdessen
error: 'Error: function execution attempt timed out.'
angezeigt wird, fahren Sie einfach mit dem nächsten Schritt fort, um zu kontrollieren, ob das Herunterfahren der Instanz lange dauert.Wenn die Instanz stattdessen anhält, aber nichts angezeigt wird, wurde wahrscheinlich das Zeitlimit überschritten. Fahren Sie einfach mit dem nächsten Schritt fort, um zu sehen, ob lediglich das Herunterfahren der Instanz lange dauert.
Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf.
Zur Seite "VM-Instanzen".Prüfen Sie, ob die Instanz mit dem Namen
dev-instance
neben dem Namen ein graues Quadrat aufweist, um anzuzeigen, dass sie gestoppt wurde. Es kann bis zu 30 Sekunden dauern, bis das Herunterfahren beendet ist.- Wenn es wesentlich länger dauert, klicken Sie oben auf der Seite auf Aktualisieren.
Instanz starten
- Rufen Sie in der Google Cloud Console die Seite Cloud Functions auf.
Zur Seite "Cloud Functions". - Klicken Sie auf die Funktion
startInstancePubSub
. - Sie sollten eine Reihe von Tabs sehen: Allgemein, Trigger, Quelle, Berechtigungen und Testen. Klicken Sie auf den Tab Testen.
Geben Sie als Auslösendes Ereignis Folgendes ein:
{"data":"eyJ6b25lIjoidXMtd2VzdDEtYiIsICJsYWJlbCI6ImVudj1kZXYifQo="}
- Auch dieser ist einfach der base64-codierte String für
{"zone":"us-west1-b", "label":"env=dev"}
.
- Auch dieser ist einfach der base64-codierte String für
Klicken Sie auf Funktion testen.
Wenn die Ausführung abgeschlossen ist, sollte unter Ausgabe
Successfully started instance dev-instance
angezeigt werden.Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf.
Zur Seite "VM-Instanzen".Prüfen Sie, ob die Instanz mit dem Namen
dev-instance
neben ihrem Namen ein grünes Häkchen hat, das angibt, dass sie ausgeführt wird. Es kann bis zu 30 Sekunden dauern, bis der Startvorgang abgeschlossen ist.
gcloud
Stoppen Sie die Instanz:
Rufen Sie die Funktion auf, um die Instanz zu stoppen.
gcloud functions call stopInstancePubSub \ --data '{"data":"eyJ6b25lIjoidXMtd2VzdDEtYiIsICJsYWJlbCI6ImVudj1kZXYifQo="}'
Dies ist einfach der String mit base64-Codierung für
{"zone":"us-west1-b", "label":"env=dev"}
.Wenn Sie Ihren eigenen String codieren möchten, können Sie ein beliebiges Tool verwenden. Hier ein Beispiel mit dem
base64
-Befehlszeilentool:echo '{"zone":"us-west1-b", "label":"env=dev"}' | base64
eyJ6b25lIjoidXMtd2VzdDEtYiIsICJsYWJlbCI6ImVudj1kZXYifQo=
Wenn die Funktion beendet ist, sollten Sie Folgendes sehen:
result: Successfully stopped instance dev-instance
Es kann bis zu 60 Sekunden dauern, bis der Vorgang abgeschlossen ist.
Wenn Sie stattdessen folgenden Fehler erhalten:
error: 'Error: function failed to load.`
Warten Sie einfach einen Moment, bis die Funktion abgeschlossen ist, und versuchen Sie es noch einmal.
Wenn Sie stattdessen folgenden Fehler erhalten:
error: `Error: function execution attempt timed out.`
Fahren Sie einfach mit dem nächsten Schritt fort, um zu sehen, ob lediglich das Herunterfahren der Instanz lange dauert.
Wenn Sie stattdessen kein Ergebnis erhalten, wurde wahrscheinlich nur das Zeitlimit für die Funktion überschritten. Fahren Sie einfach mit dem nächsten Schritt fort, um zu sehen, ob lediglich das Herunterfahren der Instanz lange dauert.
Prüfen Sie, ob die Instanz den Status
TERMINATED
hat. Es kann bis zu 30 Sekunden dauern, bis das Herunterfahren abgeschlossen ist.gcloud compute instances describe dev-instance \ --zone us-west1-b \ | grep status
status: TERMINATED
Instanz starten
Rufen Sie die Funktion auf, um die Instanz zu starten.
gcloud functions call startInstancePubSub \ --data '{"data":"eyJ6b25lIjoidXMtd2VzdDEtYiIsICJsYWJlbCI6ImVudj1kZXYifQo="}'
- Auch dieser ist einfach der base64-codierte String für
{"zone":"us-west1-b", "label":"env=dev"}
.
Wenn die Funktion beendet ist, sollten Sie Folgendes sehen:
result: Successfully started instance dev-instance
- Auch dieser ist einfach der base64-codierte String für
Prüfen Sie, ob die Instanz den Status
RUNNING
hat. Es kann bis zu 30 Sekunden dauern, bis der Startvorgang abgeschlossen ist.gcloud compute instances describe dev-instance \ --zone us-west1-b \ | grep status
status: RUNNING
Cloud Scheduler-Jobs für den Aufruf von Pub/Sub einrichten
Jobs erstellen
Console
Erstellen Sie den Startjob.
- Rufen Sie in der Google Cloud Console die Seite Cloud Scheduler auf.
Zur Seite "Cloud Scheduler". - Klicken Sie auf Job erstellen.
- Behalten Sie die Standardregion bei.
- Legen Sie als Name
startup-dev-instances
fest. - Geben Sie als Häufigkeit
0 9 * * 1-5
ein.- Diese wird Mo-Fr um 9:00 Uhr ausgeführt.
- Wählen Sie für die Zeitzone das gewünschte Land und die gewünschte Zeitzone aus. In diesem Beispiel werden
United States
undLos Angeles
verwendet. - Klicken Sie auf Weiter.
- Wählen Sie für Zieltyp die Option
Pub/Sub
aus. - Wählen Sie im Drop-down-Menü für Themen
start-instance-event
aus. - Geben Sie unter Message (Nachricht) Folgendes ein:
{"zone":"us-west1-b","label":"env=dev"}
- Klicken Sie auf Erstellen.
Erstellen Sie den Stoppjob.
- Sie sollten sich in der Google Cloud Console auf der Seite Cloud Scheduler befinden.
- Klicken Sie auf Job erstellen.
- Übernehmen Sie die Standardregion und klicken Sie unten auf der Seite auf Weiter.
- Legen Sie als Name
shutdown-dev-instances
fest. - Geben Sie als Häufigkeit
0 17 * * 1-5
ein.- Diese wird Mo-Fr um 17:00 Uhr ausgeführt.
- Wählen Sie für die Zeitzone das gewünschte Land und die gewünschte Zeitzone aus. In diesem Beispiel werden
United States
undLos Angeles
verwendet. - Klicken Sie auf Weiter.
- Wählen Sie für Zieltyp die Option
Pub/Sub
aus. - Wählen Sie im Drop-down-Menü für Themen
stop-instance-event
aus. - Geben Sie unter Message (Nachricht) Folgendes ein:
{"zone":"us-west1-b","label":"env=dev"}
- Klicken Sie auf Erstellen.
gcloud
Erstellen Sie den Startjob.
gcloud scheduler jobs create pubsub startup-dev-instances \ --schedule '0 9 * * 1-5' \ --topic start-instance-event \ --message-body '{"zone":"us-west1-b", "label":"env=dev"}' \ --time-zone 'America/Los_Angeles' \ --location us-central1
Erstellen Sie den Stoppjob.
gcloud scheduler jobs create pubsub shutdown-dev-instances \ --schedule '0 17 * * 1-5' \ --topic stop-instance-event \ --message-body '{"zone":"us-west1-b", "label":"env=dev"}' \ --time-zone 'America/Los_Angeles' \ --location us-central1
(Optional) Überprüfen Sie, ob die Jobs ordnungsgemäß funktionieren.
Console
Instanz beenden
- Rufen Sie in der Google Cloud Console die Seite Cloud Scheduler auf.
Zur Seite "Cloud Scheduler". - Klicken Sie für den Job mit dem Namen
shutdown-dev-instances
auf Jetzt ausführen ganz rechts auf der Seite. - Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf.
Zur Seite "VM-Instanzen". - Prüfen Sie, ob die Instanz mit dem Namen
dev-instance
neben dem Namen ein graues Quadrat aufweist, um anzuzeigen, dass sie gestoppt wurde. Es kann bis zu 30 Sekunden dauern, bis das Herunterfahren beendet ist.
Instanz starten
- Rufen Sie in der Google Cloud Console die Seite Cloud Scheduler auf.
Zur Seite "Cloud Scheduler". - Klicken Sie für den Job mit dem Namen
startup-dev-instances
auf Jetzt ausführen ganz rechts auf der Seite. - Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf.
Zur Seite "VM-Instanzen". - Prüfen Sie, ob die Instanz mit dem Namen
dev-instance
neben ihrem Namen ein grünes Häkchen hat, das angibt, dass sie ausgeführt wird. Es kann bis zu 30 Sekunden dauern, bis der Startvorgang abgeschlossen ist.
gcloud
Stoppen Sie die Instanz:
Führen Sie den Scheduler-Job aus, um die Instanz zu stoppen.
gcloud beta scheduler jobs run shutdown-dev-instances
Prüfen Sie, ob die Instanz den Status
TERMINATED
hat. Es kann bis zu 30 Sekunden dauern, bis es vollständig heruntergefahren ist.gcloud compute instances describe dev-instance \ --zone us-west1-b \ | grep status
status: TERMINATED
Instanz starten
Führen Sie den Scheduler-Job aus, um die Instanz zu starten.
gcloud beta scheduler jobs run startup-dev-instances
Prüfen Sie, ob die Instanz den Status
RUNNING
hat. Es kann bis zu 30 Sekunden dauern, bis der Startvorgang abgeschlossen ist.gcloud compute instances describe dev-instance \ --zone us-west1-b \ | grep status
status: RUNNING
Bereinigen
Nachdem Sie die Anleitung abgeschlossen haben, können Sie die erstellten Ressourcen bereinigen, damit sie keine Kontingente mehr nutzen und keine Gebühren mehr anfallen. In den folgenden Abschnitten erfahren Sie, wie Sie diese Ressourcen löschen oder deaktivieren.
Cloud Scheduler-Jobs löschen
Rufen Sie in der Google Cloud Console die Seite Cloud Scheduler auf.
Klicken Sie die Kästchen neben Ihren Jobs an.
Klicken Sie oben auf der Seite auf Löschen und bestätigen Sie den Löschvorgang.
Pub/Sub-Themen löschen
Rufen Sie in der Google Cloud Console die Seite Pub/Sub auf.
Klicken Sie die Kästchen neben Ihren Themen an.
Klicken Sie oben auf der Seite auf Löschen und bestätigen Sie den Löschvorgang.
Über Cloud Functions bereitgestellte Funktionen löschen
Rufen Sie in der Google Cloud Console die Seite Cloud Functions auf.
Klicken Sie die Kästchen neben Ihren Funktionen an.
Klicken Sie oben auf der Seite auf Löschen und bestätigen Sie den Löschvorgang.
Compute Engine-Instanz löschen
So löschen Sie eine Compute Engine-Instanz:
- Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf.
- Klicken Sie auf das Kästchen für die Die Instanz, die Sie löschen möchten.
- Klicken Sie zum Löschen der Instanz auf Weitere Aktionen, dann auf Löschen, und folgen Sie dann der Anleitung.
Projekt löschen
Am einfachsten vermeiden Sie weitere Kosten durch Löschen des für die Anleitung erstellten Projekts.
So löschen Sie das Projekt:
- Wechseln Sie in der Google Cloud Console zur Seite Ressourcen verwalten.
- Wählen Sie in der Projektliste das Projekt aus, das Sie löschen möchten, und klicken Sie dann auf Löschen.
- Geben Sie im Dialogfeld die Projekt-ID ein und klicken Sie auf Shut down (Beenden), um das Projekt zu löschen.
Nächste Schritte
- Referenzarchitekturen, Diagramme und Best Practices zu Google Cloud kennenlernen. Weitere Informationen zu Cloud Architecture Center