Weitere Informationen finden Sie unter Unterstützte Connectors für Application Integration.

Cloud Scheduler-Trigger

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 der Anwendungsintegration bereitzustellen. Mit diesem Trigger können Sie jetzt alle Cronjobs, die in Ihrer Integration erstellt wurden, sowohl über die Application Integration-UI als auch über das Cloud Scheduler-Dashboard verwalten. 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:

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

   Cloud Scheduler API aktivieren

2. Prüfen Sie, ob Sie ein Google-Dienstkonto mit der zugewiesenen Rolle Application Integration Invoker haben. Wenn Sie kein Dienstkonto haben, müssen Sie ein neues erstellen und ihm die Rolle Application Integration Invoker zuweisen.

   Informationen zum Erstellen und Verwalten von Dienstkonten finden Sie unter Dienstkonten erstellen und verwalten.

   Informationen zu den vordefinierten Application 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. Rufen Sie in der Google Cloud Console die Seite Application Integration auf.

   Zu Application Integration

2. Klicken Sie im Navigationsmenü auf Integrations (Integrationen).

   Auf der Seite Integrationsliste werden alle im Google Cloud-Projekt verfügbaren Integrationen aufgeführt.

3. Wählen Sie eine vorhandene Integration aus oder klicken Sie auf Integration erstellen, um eine neue zu erstellen.

   Wenn Sie eine neue Integration erstellen, gehen Sie so vor:

   1. Geben Sie im Bereich Create Integration (Integration erstellen) einen Namen und eine Beschreibung ein.
   2. Wählen Sie eine Region für die Integration aus.
   3. Wählen Sie ein Dienstkonto für die Integration aus. Sie können die Dienstkontodetails einer Integration jederzeit in der Symbolleiste der Verknüpfung im Bereich Integrationsübersicht info ändern oder aktualisieren.
   4. Klicken Sie auf Erstellen.

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

4. Klicken Sie in der Navigationsleiste des Integrationseditors auf 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 mit der 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 wird, erstellt Application Integration in Ihrem Google Cloud-Projekt einen neuen Cloud Scheduler-Job.

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.

Cloud Scheduler-Trigger bearbeiten

Anhalten, Fortsetzen, Kopieren eines Cloud Scheduler-Jobs

Application Integration unterstützt keine Vorgänge zum Anhalten, Fortsetzen oder Kopieren von Cloud Scheduler-Jobs, die mit dem Cloud Scheduler-Trigger erstellt wurden.

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 Application Integration oder über Cloud Scheduler löschen.

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.

SLA-Ausschlüsse

Der Cloud Scheduler-Trigger ist von Cloud Scheduler abhängig Produkt. Da diese Abhängigkeit außerhalb von Application Integration liegt, ist die Application Integration Service Level Agreement (SLA) gelten nur, wenn die Die Ausführung wurde für eine active-Integration geplant.