Mit dem Cloud Scheduler-Trigger können Sie die Integrationsausführungen für definierte Zeiträume oder regelmäßige Intervalle in mehreren Regionen planen.
Cloud Scheduler-Trigger nutzen die Cloud Scheduler-Dienste, um einen vollständig verwalteten Cronjob-Planer für Unternehmen in Apigee Integration bereitzustellen. Mit diesem Trigger können Sie jetzt alle in Ihrer Integration erstellten Cronjobs verwalten, sowohl über die Apigee Integration-UI als auch über das Cloud Scheduler-Dashboard. Darüber hinaus können Sie mit dem Cloud Scheduler-Trigger auch regionenübergreifende Cronjobs bereitstellen, um die Integrationsausführungen zu planen.
Wenn Sie beispielsweise die Integration in us-central1
bereitgestellt haben, können Sie mit dem Cloud Scheduler-Trigger einen Cronjob in asia-east1
(oder einem der unterstützten Google Cloud-Regionen für Cloud Scheduler) bereitstellen, um den Endpunkt Ihrer Integration unter us-central1
aufzurufen.
Hinweis
Führen Sie die folgenden Aufgaben in Ihrem Google Cloud-Projekt aus, bevor Sie den Cloud Scheduler-Trigger konfigurieren:
- Cloud Scheduler API aktivieren (
cloudscheduler.googleapis.com
). - Prüfen Sie, ob Sie ein Google-Dienstkonto mit der Rolle Aufrufer von Apigee-Integrationen haben. Wenn Sie noch kein Dienstkonto haben, müssen Sie ein neues erstellen und ihm die Rolle Aufrufer von Apigee-Integrationen zuweisen.
Informationen zum Erstellen und Verwalten von Dienstkonten finden Sie unter Dienstkonten erstellen und verwalten.
Informationen zu den vordefinierten Apigee Integration-Rollen finden Sie unter Vordefinierte IAM-Rollen.
Cloud Scheduler-Trigger hinzufügen
Führen Sie folgende Schritte aus, um der Integration einen Cloud Scheduler-Trigger hinzuzufügen:
- Wählen Sie in der Apigee-Benutzeroberfläche Ihre Apigee-Organisation aus.
- Klicken Sie auf Entwickeln > Integrationen.
- Wählen Sie eine vorhandene Integration aus oder erstellen Sie eine neue Integration, indem Sie auf Integration erstellen klicken.
Wenn Sie eine neue Integration erstellen, gehen Sie so vor:
- Geben Sie im Dialogfeld Integration erstellen einen Namen und eine Beschreibung ein.
- Wählen Sie eine Region für die Integration aus der Liste der unterstützten Regionen aus.
- Klicken Sie auf Erstellen.
Dadurch wird die Integration auf der Seite Integrationsdesigner geöffnet.
- Klicken Sie in der Navigationsleiste Integrationsdesigner auf + Aufgabe/Trigger hinzufügen > Trigger, um die Liste der verfügbaren Trigger aufzurufen.
- Klicken Sie auf das Element Cloud Scheduler-Trigger und platzieren Sie es im Integrationseditor.
Cloud Scheduler-Trigger konfigurieren
Führen Sie die folgenden Schritte aus, um einen Cloud Scheduler-Trigger zu konfigurieren:
- Klicken Sie im Integrationseditor auf das Element Cloud Scheduler-Trigger, um den Bereich für die Triggerkonfiguration zu öffnen.
Geben Sie den Zeitplan des Cloud Scheduler-Triggers mit einer der folgenden Optionen an:
- Basic: Verwenden Sie die Benutzeroberfläche, um den Cronjob-Zeitplan zu konfigurieren.
- Erweitert: Verwenden Sie einen unix-cron-Ausdruck, um den Cronjob-Zeitplan zu konfigurieren.
-
Wählen Sie bei der Option „Einfach“ den Tab Basic aus und gehen Sie folgendermaßen vor:
- Zeiten: Wählen Sie die Zeitintervalle aus, in denen die Integration ausgeführt werden muss.
- Ausführung zu einem bestimmten Zeitpunkt: Wählen Sie diese Option aus, um die Integration zu einem bestimmten Zeitpunkt auszuführen.
- Wiederholung nach Stunde: Wählen Sie diese Option aus, um die Integration wiederholt pro Stunde auszuführen.
- Wiederholung nach Minute: Wählen Sie diese Option aus, um die Integration gemäß der angegebenen Anzahl von Minuten wiederholt auszuführen.
- Tage: Wählen Sie die Tage, an denen die Integration ausgeführt werden soll. Sie können die Integration täglich, an bestimmten Wochentagen oder an einem bestimmten Tag im Monat ausführen.
- Monate: Wählen Sie den/die Monat(e), in dem/denen die Integration ausgeführt werden muss. Sie können die Integration jeden Monat oder nur in bestimmten Monaten ausführen.
- Zeiten: Wählen Sie die Zeitintervalle aus, in denen die Integration ausgeführt werden muss.
-
(Für die Option „Erweitert“) Wählen Sie den Tab Erweitert aus und geben Sie mit einem Cron-Ausdruck den Zeitplan des Cronjobs an.
Der Cron-Ausdruck umfasst fünf Werte, die in der folgenden Reihenfolge angegeben werden müssen:
- Minute (0–59)
- Stunde (0–23)
- Tag des Monats (1–31)
- Monat (einer der folgenden Werte):
- Eine Zahl (1–12)
- Eine aus drei Buchstaben bestehende monatliche Abkürzung (z. B. Januar, Februar, März)
- Wochentag (einer der folgenden Werte):
- Zahl von 0–6, beginnend mit Sonntag als 0
- Eine Abkürzung aus drei Buchstaben (z. B. Mon, Die, Mit usw.)
Wenn Sie beispielsweise die Integration am ersten Tag jedes Monats ausführen möchten, verwenden Sie den Cron-Ausdruck
* * 1 * *
.Weitere Informationen finden Sie unter Zeitpläne für Cronjobs konfigurieren.
- Region: Wählen Sie die Region aus, in der Ihr Cloud Scheduler-Job bereitgestellt werden soll.
- E-Mail-Adresse des Dienstkontos: Geben Sie die E-Mail-Adresse des erstellten Google-Dienstkontos ein.
Trigger-Ausgabe
Für jeden Cloud Scheduler-Trigger, der in Ihrer Integrationsversion konfiguriert und veröffentlicht ist, erstellt Apigee Integration einen neuen Cloud Scheduler-Job in Ihrem Google Cloud-Projekt.
Ein Cloud Scheduler-Job wird mit der folgenden Namenskonvention erstellt, um Fehler bei der Jobduplizierung zu vermeiden:
INTEGRATION_NAME__VINTEGRATION_VERSION__CLOUD_SCHEDULER_TRIGGER_NUMBER
Beispiel: DemoIntegration__V1__1
Trigger-Logs
Ein Cloud Scheduler-Trigger generiert am Anfang und Ende jeder Integrationsausführung Logs. Sie können die Logs des Cloud Scheduler-Triggers auf der Seite Log-Explorer von Cloud Logging aufrufen:
- Rufen Sie in der Google Cloud Console die Seite Cloud Scheduler auf.
- Suchen Sie Ihren Cloud Scheduler-Job und klicken Sie in der Spalte Logs auf Ansehen.
Auf der Seite Cloud Logging-Log-Explorer werden die vom Cloud Scheduler-Trigger generierten Logs angezeigt.
Cloud Scheduler-Trigger bearbeiten
Apigee Integration
So bearbeiten Sie den Cloud Scheduler-Trigger über Apigee Integration:
- Wählen Sie in der Apigee-Benutzeroberfläche Ihre Apigee-Organisation aus.
- Klicken Sie auf Entwickeln > Integrationen.
- Wählen Sie die Integrationen aus, die getestet werden sollen.
- Klicken Sie im Integrationseditor auf das Drop-down-Menü Version und wählen Sie die Integrationsversion aus, die den Cloud Scheduler-Trigger enthält, den Sie bearbeiten möchten.
- Heben Sie die Veröffentlichung auf und aktivieren Sie die Bearbeitung, wenn die ausgewählte Integrationsversion veröffentlicht ist (im aktiven Status).
- Klicken Sie im Integrationseditor auf das Element Cloud Scheduler-Trigger, um den Bereich für die Triggerkonfiguration zu öffnen.
- Ändern Sie die Cloud Scheduler-Jobkonfigurationen nach Bedarf.
Cloud Scheduler
Sie können Ihren Cloud Scheduler-Trigger bearbeiten, indem Sie die Konfiguration Ihres Cloud Scheduler-Jobs in Cloud Scheduler ändern:
- Rufen Sie in der Google Cloud Console Cloud Scheduler auf.
- Wählen Sie den zu bearbeitenden Cloud Scheduler-Job aus.
- Klicken Sie auf Bearbeiten.
- Ändern Sie die Cloud Scheduler-Jobkonfigurationen nach Bedarf.
Anhalten, Fortsetzen, Kopieren eines Cloud Scheduler-Jobs
Apigee Integration unterstützt keine Vorgänge zum Anhalten, Fortsetzen und Kopieren für einen Cloud Scheduler-Job, der mit dem Cloud Scheduler-Trigger erstellt wurde.
Der Cloud Scheduler-Trigger gibt im Triggerkonfigurationsbereich einen Fehler aus, wenn Sie die Ausführung eines Cloud Scheduler-Jobs über Cloud Scheduler manuell pausieren.
Weitere Informationen zu Fehlermeldungen beim Cloud Scheduler-Trigger finden Sie unter Fehlerbehebung bei Cloud Scheduler-Triggern. Informationen zum Anhalten und Fortsetzen eines Cronjobs mit Cloud Scheduler finden Sie unter Job anhalten oder fortsetzen.
Cloud Scheduler-Job löschen
Sie können einen Cloud Scheduler-Job entweder über Ihre Integration in Apigee Integration oder aus Cloud Scheduler löschen.
Apigee Integration
So löschen Sie einen Cloud Scheduler-Job aus Apigee Integration:
- Wählen Sie in der Apigee-Benutzeroberfläche Ihre Apigee-Organisation aus.
- Klicken Sie auf Entwickeln > Integrationen.
- Wählen Sie die Integrationen aus, die getestet werden sollen.
- Klicken Sie im Integrationseditor auf das Drop-down-Menü Version und wählen Sie die Integrationsversion aus, die den Cloud Scheduler-Trigger enthält, den Sie löschen möchten.
- Heben Sie die Veröffentlichung der ausgewählten Integrationsversion auf.
Der Cloud Scheduler-Job für die entsprechende Integrationsversion wird gelöscht.
Cloud Scheduler
So löschen Sie einen Cloud Scheduler-Job aus Cloud Scheduler:
- Rufen Sie in der Google Cloud Console Cloud Scheduler auf.
- Wählen Sie den zu löschenden Cloud Scheduler-Job aus.
- Klicken Sie auf Löschen.
Der Cloud Scheduler-Job für die entsprechende Integrationsversion wird gelöscht.
Best Practices
Als Best Practice sollten Sie die Veröffentlichung aller Cloud Scheduler-Trigger aufheben, wenn sie nicht mehr benötigt werden. Wenn Sie einen redundanten Cloud Scheduler-Trigger veröffentlicht lassen, ruft der Trigger die Integration weiterhin automatisch auf, was zu zusätzlichen Abrechnungsgebühren führen kann.
Fehlerbehebung beim Cloud Scheduler-Trigger
In der folgenden Tabelle werden die Fehler beschrieben, die beim Cloud Scheduler-Trigger auftreten können, und die zugehörigen Ursachen.
Fehlerposition | Vorkommen des Fehlers | Fehlermeldung | Mögliche Ursachen | Lösung |
---|---|---|---|---|
Bereich für die Triggerkonfiguration > Fehlermeldung | Wenn der Cloud Scheduler-Job die Ausführung Ihrer Integration beendet |
The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB doesn’t exist. It might be deleted from your Google Cloud project.
|
Der Cloud Scheduler-Job wird mit Cloud Scheduler gelöscht. | Erstellen Sie eine neue Integrationsversion, um den vorhandenen Cloud Scheduler-Job zu überschreiben. |
The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB is PAUSED. You must RESUME the job from your Google Cloud project.
|
Der Cloud Scheduler-Job wird mit Cloud Scheduler pausiert. | Fortsetzen des Cloud Scheduler-Jobs über Cloud Scheduler. | ||
The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB is DISABLED due to an internal system error. |
Prüfen Sie die Triggerlogs, um das Problem zu identifizieren. | Erstellen Sie eine neue Integrationsversion, um den vorhandenen Cloud Scheduler-Job zu überschreiben. | ||
The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB is in an UPDATE_FAILED state due to a failed CloudScheduler.UpdateJob operation. |
Das angegebene Dienstkonto hat nicht die erforderlichen IAM-Berechtigungen. | Zum Wiederherstellen eines Jobs aus diesem Status wiederholen Sie den CloudScheduler.UpdateJob-Vorgang, bis eine erfolgreiche Antwort empfangen wird. | ||
The last execution of the Cloud Scheduler job CLOUD_SCHEDULER_JOB failed due to CLOUD_SCHEDULER_JOB_ISSUE. Learn more. |
CLOUD_SCHEDULER_JOB_ISSUE | – |