Cloud Scheduler-Trigger

Mitteilung: Application Integration ist jetzt für Ihr Google Cloud-Projekt verfügbar. Sie können jetzt Apigee Integration und Application Integration im selben Google Cloud-Projekt verwenden. Weitere Informationen

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.

Wichtig: Für die Nutzung der Cloud Scheduler-Dienste in Ihrer Integration fallen gesonderte Gebühren an. Die Kosten hängen von der Anzahl der Cronjobs ab, die in Apigee Integration mit dem Cloud Scheduler-Trigger erstellt wurden. Weitere Informationen zu den Cloud Scheduler-Gebühren finden Sie unter Cloud Scheduler-Preise.

Hinweis

Führen Sie die folgenden Aufgaben in Ihrem Google Cloud-Projekt aus, bevor Sie den Cloud Scheduler-Trigger konfigurieren:

1. Cloud Scheduler API aktivieren (cloudscheduler.googleapis.com).

   Cloud Scheduler API aktivieren

2. 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:

1. Wählen Sie in der Apigee-Benutzeroberfläche Ihre Apigee-Organisation aus.
2. Klicken Sie auf Entwickeln > Integrationen.
3. 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:

   1. Geben Sie im Dialogfeld Integration erstellen einen Namen und eine Beschreibung ein.
   2. Wählen Sie eine Region für die Integration aus der Liste der unterstützten Regionen aus.
   3. Klicken Sie auf Erstellen.

   Dadurch wird die Integration auf der Seite Integrationsdesigner geöffnet.

4. Klicken Sie in der Navigationsleiste Integrationsdesigner auf + Aufgabe/Trigger hinzufügen > Trigger, um die Liste der verfügbaren Trigger aufzurufen.
5. 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:

1. 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.
2. Wählen Sie bei der Option „Einfach“ den Tab Basic aus und gehen Sie folgendermaßen vor:
   1. 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.
   2. 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.
   3. 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.
3. (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:

   1. Minute (0–59)
   2. Stunde (0–23)
   3. Tag des Monats (1–31)
   4. Monat (einer der folgenden Werte):
      • Eine Zahl (1–12)
      • Eine aus drei Buchstaben bestehende monatliche Abkürzung (z. B. Januar, Februar, März)
   5. 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.

4. Region: Wählen Sie die Region aus, in der Ihr Cloud Scheduler-Job bereitgestellt werden soll.
5. 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:

1. Rufen Sie in der Google Cloud Console die Seite Cloud Scheduler auf.

   Zu Cloud Scheduler

2. 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.

Hinweis: Apigee-Integration speichert oder erfasst keine vom Cloud Scheduler-Trigger generierten Logs. Diese Logs werden in Ihrem Google Cloud-Projekt gespeichert und können nur auf der Seite Log-Explorer von Cloud Logging aufgerufen werden.

Cloud Scheduler-Trigger bearbeiten

Apigee Integration

Warnung: Beim Bearbeiten eines Cloud Scheduler-Triggers über Apigee Integration wird Ihr vorhandener Cronjob in einem neuen Cronjob in einer neuen Integrationsversion überschrieben.

So bearbeiten Sie den Cloud Scheduler-Trigger über Apigee Integration:

1. Wählen Sie in der Apigee-Benutzeroberfläche Ihre Apigee-Organisation aus.
2. Klicken Sie auf Entwickeln > Integrationen.
3. Wählen Sie die Integrationen aus, die getestet werden sollen.
4. 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.
5. Heben Sie die Veröffentlichung auf und aktivieren Sie die Bearbeitung, wenn die ausgewählte Integrationsversion veröffentlicht ist (im aktiven Status).
6. Klicken Sie im Integrationseditor auf das Element Cloud Scheduler-Trigger, um den Bereich für die Triggerkonfiguration zu öffnen.
7. Ä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:

1. Rufen Sie in der Google Cloud Console Cloud Scheduler auf.

   Zu Cloud Scheduler

2. Wählen Sie den zu bearbeitenden Cloud Scheduler-Job aus.
3. Klicken Sie auf Bearbeiten.
4. Ändern Sie die Cloud Scheduler-Jobkonfigurationen nach Bedarf.

Hinweis: Wenn Sie einen Cloud Scheduler-Job in Cloud Scheduler bearbeiten, ändert sich der Status der Zielintegrationsversion nicht.

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:

1. Wählen Sie in der Apigee-Benutzeroberfläche Ihre Apigee-Organisation aus.
2. Klicken Sie auf Entwickeln > Integrationen.
3. Wählen Sie die Integrationen aus, die getestet werden sollen.
4. 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.
5. 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:

1. Rufen Sie in der Google Cloud Console Cloud Scheduler auf.

   Zu Cloud Scheduler

2. Wählen Sie den zu löschenden Cloud Scheduler-Job aus.
3. Klicken Sie auf Löschen.

   Der Cloud Scheduler-Job für die entsprechende Integrationsversion wird gelöscht.

Hinweis:

• Wenn Sie einen Cloud Scheduler-Job aus Cloud Scheduler löschen, wird der Cloud Scheduler-Trigger in Ihrer Integration in Apigee Integration nicht gelöscht.
• Der Cloud Scheduler-Trigger in Ihrer Integration gibt im Triggerkonfigurationsbereich einen Fehler aus, wenn ein Cloud Scheduler-Job mit Cloud Scheduler gelöscht wird. Weitere Informationen zu Fehlermeldungen beim Cloud Scheduler-Trigger finden Sie unter Fehlerbehebung bei Cloud Scheduler-Triggern.

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	–