AWS Batch Aufträge als EventBridge Ziele - AWS Batch
Erstellen eines geplanten AuftragsErstellen einer Regel mit einem EreignismusterEreigniseingabe-Transformator

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

AWS Batch Aufträge als EventBridge Ziele

Amazon EventBridge stellt einen Stream von Systemereignissen in nahezu Echtzeit bereit, der Änderungen an Amazon Web Services-Ressourcen beschreibt. In der Regel sind AWS Batch auf Amazon Elastic Container Service-, Amazon Elastic Kubernetes Service- und AWS Fargate-Aufträgen als EventBridge Ziele verfügbar. Mithilfe einfacher Regeln können Sie Ereignisse abgleichen und als Reaktion darauf AWS Batch Aufträge senden. Weitere Informationen finden Sie unter Was ist EventBridge? im Amazon- EventBridge Benutzerhandbuch.

Sie können auch verwenden, EventBridge um automatisierte Aktionen zu planen, die zu bestimmten Zeiten mithilfe von - cron oder -Ratenausdrücken aufgerufen werden. Weitere Informationen finden Sie unter Erstellen einer Amazon- EventBridge Regel, die nach einem Zeitplan ausgeführt wird im Amazon- EventBridge Benutzerhandbuch.

Informationen zum Erstellen einer Regel, die ausgeführt wird, wenn ein Ereignis einem Ereignismuster entspricht, finden Sie unter Erstellen von Amazon- EventBridge Regeln, die auf Ereignisse reagieren im Amazon- EventBridge Benutzerhandbuch.

Zu den häufigsten Anwendungsfällen für AWS Batch Aufträge als EventBridge Ziel gehören die folgenden Anwendungsfälle:

  • Ein geplanter Auftrag erfolgt in regelmäßigen Zeitintervallen. Beispielsweise tritt ein cron Auftrag nur in Zeiten mit geringer Auslastung auf, wenn Amazon EC2 Spot Instances kostengünstiger sind.

  • Ein - AWS Batch Auftrag wird als Reaktion auf einen API-Vorgang ausgeführt, der in protokolliert ist CloudTrail. Beispielsweise wird ein Auftrag übermittelt, wenn ein Objekt in einen angegebenen Amazon S3-Bucket hochgeladen wird. Jedes Mal, wenn dies geschieht, übergibt der EventBridge Eingabe-Transformator den Bucket und den Schlüsselnamen des Objekts an AWS Batch Parameter.

    Anmerkung

    In diesem Szenario müssen sich alle zugehörigen AWS Ressourcen in derselben Region befinden. Dazu gehören Ressourcen wie der Amazon S3-Bucket, EventBridge die Regel und die CloudTrail Protokolle.

Bevor Sie AWS Batch Aufträge mit EventBridge Regeln und Zielen einreichen können, benötigt der EventBridge Service mehrere Berechtigungen zum Ausführen von AWS Batch Aufträgen. Wenn Sie in der EventBridge Konsole eine Regel erstellen, die einen - AWS Batch Auftrag als Ziel angibt, können Sie diese Rolle auch erstellen. Weitere Informationen über die erforderlichen Service-Prinzipal- und IAM;-Berechtigungen für dies Rolle finden Sie unter EventBridge IAM-Rolle.

Erstellen eines geplanten AWS Batch Auftrags

Im folgenden Verfahren wird beschrieben, wie Sie einen geplanten AWS Batch Auftrag und die erforderliche EventBridge IAM-Rolle erstellen.

So erstellen Sie einen geplanten AWS Batch Auftrag mit EventBridge
Anmerkung

Dieses Verfahren funktioniert für alle AWS Batch auf Amazon-ECS-, Amazon-EKS- und AWS Fargate-Aufträgen.

  1. Öffnen Sie die Amazon- EventBridge Konsole unter https://console.aws.amazon.com/events/.

  2. Wählen Sie in der Navigationsleiste die zu AWS-Region verwendende aus.

  3. Wählen Sie im Navigationsbereich Rules aus.

  4. Wählen Sie Regel erstellen aus.

  5. Geben Sie unter Name einen eindeutigen Namen für Ihre Datenverarbeitungsumgebung an. Der Name kann bis zu 64 Zeichen umfassen. Er kann Groß- und Kleinbuchstaben, Zahlen, Bindestriche (-) und Unterstriche (_) enthalten.

    Anmerkung

    Eine Regel darf nicht denselben Namen wie eine andere Regel in derselben Region und auf demselben Event Bus haben.

  6. (Optional) Geben Sie unter Beschreibung eine Beschreibung für die Regel ein.

  7. Wählen Sie für Event Bus den Event Bus aus, den Sie dieser Regel zuordnen möchten. Wenn Sie möchten, dass diese Regel mit Ereignissen aus Ihrem eigenen Konto übereinstimmt, wählen Sie Standard aus. Wenn ein AWS-Service in Ihrem Konto ein Ereignis ausgibt, wird es immer an den Standard-Event-Bus Ihres Kontos weitergeleitet.

  8. (Optional) Deaktivieren Sie die Regel für den ausgewählten Bus, wenn Sie die Regel nicht sofort ausführen möchten.

  9. Wählen Sie unter Rule type (Regeltyp) die Option Schedule (Zeitplan) aus.

  10. Wählen Sie Weiter, um die Regel zu erstellen, oder Weiter aus.

  11. Gehen Sie bei Schedule pattern (Zeitplanmuster) wie folgt vor:

    • Wählen Sie Ein detaillierter Zeitplan, der zu einer bestimmten Zeit ausgeführt wird, z. B. um 8:00 Uhr aus. PST jeden ersten Montag im Monat und geben Sie dann einen Cron-Ausdruck ein. Weitere Informationen finden Sie unter Cron-Ausdrücke im Amazon- EventBridge Benutzerhandbuch.

    • Wählen Sie Einen Zeitplan aus, der regelmäßig ausgeführt wird, z. B. alle 10 Minuten, und geben Sie dann einen Ratenausdruck ein.

  12. Wählen Sie Weiter aus.

  13. Für Target types (Zieltypen), wählen Sie AWS-Service aus.

  14. Wählen Sie für Ziel auswählen die Option Batch-Auftragswarteschlange aus. Konfigurieren Sie dann Folgendes:

    • Job queue (Auftragswarteschlange): Geben Sie den Amazon-Ressourcennamen (ARN) der Auftragswarteschlange ein, in der Ihr Auftrag eingeplant werden soll.

    • Auftragsdefinition: Geben Sie den Namen und die Revision oder den vollständigen ARN der Auftragsdefinition ein, die für Ihren Auftrag verwendet werden sollen.

    • Job name (Auftragsname): Geben Sie einen Namen für Ihren Auftrag ein.

    • Array-Größe: (Optional) Geben Sie eine Array-Größe für Ihren Auftrag ein, um mehrere Kopien davon auszuführen. Weitere Informationen finden Sie unter Ordnen Sie Jobs an.

    • Auftragsversuche: (Optional) Geben Sie an, wie oft die Ausführung Ihres Auftrags versucht werden soll, bevor festgelegt wird, dass er fehlgeschlagen ist. Weitere Informationen finden Sie unter Automatisierte Auftragswiederholungen.

  15. Bei Batch-Auftragswarteschlangen-Zieltypen EventBridge benötigt die Berechtigung zum Senden von Ereignissen an das Ziel. EventBridge kann die IAM-Rolle erstellen, die für die Ausführung Ihrer Regel erforderlich ist. Führen Sie eine der folgenden Aktionen aus:

    • Um automatisch eine IAM-Rolle zu erstellen, wählen Sie Create a new role for this specific resource (Eine neue Rolle für diese spezifische Ressource erstellen).

    • Um eine bereits erstellte IAM-Rolle zu verwenden, wählen Sie Vorhandene Rolle verwenden aus.

  16. (Optional) Erweitern Sie Additional settings (Zusätzliche Einstellungen).

    1. Wählen Sie unter Zieleingabe konfigurieren aus, wie der Text aus einem Ereignis verarbeitet wird, bevor er an das Ziel übergeben wird.

    2. Geben Sie unter Höchstalter des Ereignisses das Zeitintervall für die Aufbewahrungsdauer unverarbeiteter Ereignisse an.

    3. Geben Sie unter Wiederholungsversuche die Häufigkeit ein, mit der ein Ereignis erneut versucht wird.

    4. Wählen Sie für Warteschlange für unzustellbare Nachrichten eine Option aus, um festzulegen, wie unverarbeitete Ereignisse behandelt werden. Geben Sie bei Bedarf die Amazon SQS-Warteschlange an, die als Warteschlange für unzustellbare Nachrichten verwendet werden soll.

  17. (Optional) Wählen Sie Add another target (Weiteres Ziel hinzufügen) aus, um ein weiteres Ziel für diese Regel hinzuzufügen.

  18. Wählen Sie Weiter aus.

  19. (Optional) Wählen Sie für Tags die Option Neues Tag hinzufügen aus, um eine Ressourcenbezeichnung für die Regel hinzuzufügen. Weitere Informationen finden Sie unter Amazon- EventBridge Tags.

  20. Wählen Sie Weiter aus.

  21. Überprüfen Sie unter Überprüfen und erstellen die Konfigurationsschritte. Wenn Sie Änderungen vornehmen müssen, wählen Sie Edit (Bearbeiten). Wenn Sie fertig sind, wählen Sie Regel erstellen.

Weitere Informationen zum Erstellen von Regeln finden Sie unter Erstellen einer Amazon- EventBridge Regel, die nach einem Zeitplan ausgeführt wird im Amazon- EventBridge Benutzerhandbuch.

Erstellen einer Regel mit einem Ereignismuster

Im folgenden Verfahren wird beschrieben, wie Sie eine Regel mit einem Ereignismuster erstellen.

So erstellen Sie eine Regel, die das Ereignis an ein Ziel sendet, wenn das Ereignis einem definierten Muster entspricht
Anmerkung

Dieses Verfahren funktioniert für alle AWS Batch auf Amazon-ECS-, Amazon-EKS- und AWS Fargate-Aufträgen.

  1. Öffnen Sie die Amazon- EventBridge Konsole unter https://console.aws.amazon.com/events/.

  2. Wählen Sie in der Navigationsleiste die zu AWS-Region verwendende aus.

  3. Wählen Sie im Navigationsbereich Rules aus.

  4. Wählen Sie Regel erstellen aus.

  5. Geben Sie unter Name einen eindeutigen Namen für Ihre Datenverarbeitungsumgebung an. Der Name kann bis zu 64 Zeichen umfassen. Er kann Groß- und Kleinbuchstaben, Zahlen, Bindestriche (-) und Unterstriche (_) enthalten.

    Anmerkung

    Eine Regel darf nicht denselben Namen wie eine andere Regel in derselben Region und auf demselben Event Bus haben.

  6. (Optional) Geben Sie unter Beschreibung eine Beschreibung für die Regel ein.

  7. Wählen Sie für Event Bus den Event Bus aus, den Sie dieser Regel zuordnen möchten. Wenn Sie möchten, dass diese Regel mit Ereignissen aus Ihrem eigenen Konto übereinstimmt, wählen Sie Standard aus. Wenn ein AWS-Service in Ihrem Konto ein Ereignis ausgibt, wird es immer an den Standard-Event-Bus Ihres Kontos weitergeleitet.

  8. (Optional) Deaktivieren Sie die Regel für den ausgewählten Bus, wenn Sie die Regel nicht sofort ausführen möchten.

  9. Bei Rule type (Regeltyp) wählen Sie Rule with an event pattern (Regel mit einem Ereignismuster) aus.

  10. Wählen Sie Weiter aus.

  11. Wählen Sie für Ereignisquelle die Option AWS Ereignis- oder EventBridge Partnerereignisse aus.

  12. (Optional) Für Beispielereignis :

    1. Wählen Sie für Beispielereignistyp die Option AWS Ereignisse aus.

    2. Wählen Sie für Beispielereignisse die Option Statusänderung des Batch-Auftrags aus.

  13. Wählen Sie für Erstellungsmethode die Option Musterformular verwenden aus.

  14. Für Ereignismuster :

    1. Wählen Sie für Ereignisquelle die Option AWS-Services aus.

    2. AWS-ServiceWählen Sie für Batch aus.

    3. Wählen Sie für Ereignistyp die Option Statusänderung des Batch-Auftrags aus.

  15. Wählen Sie Weiter aus.

  16. Für Target types (Zieltypen), wählen Sie AWS-Service aus.

  17. Wählen Sie unter Ziel auswählen einen Zieltyp aus. Wählen Sie beispielsweise Batch-Auftragswarteschlange aus. Geben Sie dann Folgendes an:

    • Job queue (Auftragswarteschlange): Geben Sie den Amazon-Ressourcennamen (ARN) der Auftragswarteschlange ein, in der Ihr Auftrag eingeplant werden soll.

    • Auftragsdefinition: Geben Sie den Namen und die Revision oder den vollständigen ARN der Auftragsdefinition ein, die für Ihren Auftrag verwendet werden sollen.

    • Job name (Auftragsname): Geben Sie einen Namen für Ihren Auftrag ein.

    • Array-Größe: (Optional) Geben Sie eine Array-Größe für Ihren Auftrag ein, um mehrere Kopien davon auszuführen. Weitere Informationen finden Sie unter Ordnen Sie Jobs an.

    • Auftragsversuche: (Optional) Geben Sie an, wie oft die Ausführung Ihres Auftrags versucht werden soll, bevor festgelegt wird, dass er fehlgeschlagen ist. Weitere Informationen finden Sie unter Automatisierte Auftragswiederholungen.

  18. Bei Batch-Auftragswarteschlangen-Zieltypen EventBridge benötigt die Berechtigung zum Senden von Ereignissen an das Ziel. EventBridge kann die IAM-Rolle erstellen, die für die Ausführung Ihrer Regel erforderlich ist. Führen Sie eine der folgenden Aktionen aus:

    • Um automatisch eine IAM-Rolle zu erstellen, wählen Sie Create a new role for this specific resource (Eine neue Rolle für diese spezifische Ressource erstellen).

    • Wenn Sie eine zuvor erstellte IAM-Rolle verwenden möchten, wählen Sie Use existing role (Vorhandene Rolle verwenden).

  19. (Optional) Erweitern Sie Additional settings (Zusätzliche Einstellungen).

    1. Wählen Sie unter Zieleingabe konfigurieren aus, wie Text aus einem Ereignis verarbeitet wird.

    2. Geben Sie unter Höchstalter des Ereignisses das Zeitintervall für die Aufbewahrungsdauer unverarbeiteter Ereignisse an.

    3. Geben Sie für Wiederholungsversuche die Häufigkeit ein, mit der ein Ereignis erneut versucht wird.

    4. Wählen Sie für Warteschlange für unzustellbare Nachrichten eine Option aus, um festzulegen, wie unverarbeitete Ereignisse behandelt werden. Geben Sie bei Bedarf die Amazon SQS-Warteschlange an, die als Warteschlange für unzustellbare Nachrichten verwendet werden soll.

  20. (Optional) Wählen Sie Weiteres Ziel hinzufügen, um ein zusätzliches Ziel hinzuzufügen.

  21. Wählen Sie Weiter aus.

  22. (Optional) Wählen Sie für Tags die Option Neues Tag hinzufügen aus, um eine Ressourcenbezeichnung hinzuzufügen. Weitere Informationen finden Sie unter Amazon- EventBridge Tags im Amazon- EventBridge Benutzerhandbuch.

  23. Wählen Sie Weiter aus.

  24. Überprüfen Sie unter Überprüfen und erstellen die Konfigurationsschritte. Wenn Sie Änderungen vornehmen müssen, wählen Sie Edit (Bearbeiten). Wenn Sie fertig sind, wählen Sie Regel erstellen aus.

    Weitere Informationen zum Erstellen von Regeln finden Sie unter Erstellen von Amazon- EventBridge Regeln, die auf Ereignisse reagieren im Amazon- EventBridge Benutzerhandbuch.

Übergeben von Ereignisinformationen an ein AWS Batch Ziel nach einem Zeitplan mithilfe des EventBridge Eingabe-Transformators

Sie können den EventBridge Eingabe-Transformator verwenden, um Ereignisinformationen an AWS Batch in einer Auftragsübermittlung zu übergeben. Dies kann besonders nützlich sein, wenn Sie Aufträge aufgrund anderer AWS Ereignisinformationen aufrufen. Ein Beispiel ist ein Objekt-Upload in einen Amazon S3-Bucket. Sie können auch eine Auftragsdefinition mit Parameterersetzungswerten im -Befehl des Containers verwenden. Der EventBridge Eingabe-Transformator kann die Parameterwerte basierend auf den Ereignisdaten bereitstellen.

Anschließend erstellen Sie ein AWS Batch Ereignisziel, das Informationen aus dem Ereignis analysiert, das es startet, und es in ein parameters Objekt umwandelt. Wenn der Auftrag ausgeführt wird, werden die Parameter aus dem Auslöserereignis an den Befehl des Auftragscontainers übergeben.

Anmerkung

In diesem Szenario müssen sich alle AWS Ressourcen (wie Amazon S3-Buckets, EventBridge -Regeln und CloudTrail -Protokolle) in derselben Region befinden.

So erstellen Sie ein AWS Batch Ziel, das den Eingabe-Transformator verwendet

  1. Öffnen Sie die Amazon- EventBridge Konsole unter https://console.aws.amazon.com/events/.

  2. Wählen Sie in der Navigationsleiste die zu AWS-Region verwendende aus.

  3. Wählen Sie im Navigationsbereich Rules aus.

  4. Wählen Sie Regel erstellen aus.

  5. Geben Sie unter Name einen eindeutigen Namen für Ihre Datenverarbeitungsumgebung an. Der Name kann bis zu 64 Zeichen umfassen. Er kann Groß- und Kleinbuchstaben, Zahlen, Bindestriche (-) und Unterstriche (_) enthalten.

    Anmerkung

    Eine Regel darf nicht denselben Namen wie eine andere Regel im selben AWS-Region und im selben Event Bus haben.

  6. (Optional) Geben Sie unter Beschreibung eine Beschreibung für die Regel ein.

  7. Wählen Sie für Event Bus den Event Bus aus, den Sie dieser Regel zuordnen möchten. Wenn Sie möchten, dass diese Regel mit Ereignissen aus Ihrem eigenen Konto übereinstimmt, wählen Sie Standard aus. Wenn ein AWS-Service in Ihrem Konto ein Ereignis ausgibt, wird es immer an den Standard-Event-Bus Ihres Kontos weitergeleitet.

  8. (Optional) Deaktivieren Sie die Regel für den ausgewählten Bus, wenn Sie die Regel nicht sofort ausführen möchten.

  9. Wählen Sie unter Rule type (Regeltyp) die Option Schedule (Zeitplan) aus.

  10. Wählen Sie Weiter, um die Regel zu erstellen, oder Weiter aus.

  11. Gehen Sie bei Schedule pattern (Zeitplanmuster) wie folgt vor:

    • Wählen Sie Ein detaillierter Zeitplan, der zu einer bestimmten Zeit ausgeführt wird, z. B. um 8:00 Uhr aus. PST jeden ersten Montag im Monat und geben Sie dann einen Cron-Ausdruck ein. Weitere Informationen finden Sie unter Cron-Ausdrücke im Amazon- EventBridge Benutzerhandbuch.

    • Wählen Sie Ein Zeitplan, der regelmäßig ausgeführt wird, z. B. alle 10 Minuten., und geben Sie dann einen Ratenausdruck ein.

  12. Wählen Sie Weiter aus.

  13. Für Target types (Zieltypen), wählen Sie AWS-Service aus.

  14. Wählen Sie für Ziel auswählen die Option Batch-Auftragswarteschlange aus. Konfigurieren Sie dann Folgendes:

    • Job queue (Auftragswarteschlange): Geben Sie den Amazon-Ressourcennamen (ARN) der Auftragswarteschlange ein, in der Ihr Auftrag eingeplant werden soll.

    • Auftragsdefinition: Geben Sie den Namen und die Revision oder den vollständigen ARN der Auftragsdefinition ein, die für Ihren Auftrag verwendet werden sollen.

    • Job name (Auftragsname): Geben Sie einen Namen für Ihren Auftrag ein.

    • Array-Größe: (Optional) Geben Sie eine Array-Größe für Ihren Auftrag ein, um mehrere Kopien davon auszuführen. Weitere Informationen finden Sie unter Ordnen Sie Jobs an.

    • Auftragsversuche: (Optional) Geben Sie an, wie oft die Ausführung Ihres Auftrags versucht werden soll, bevor festgelegt wird, dass er fehlgeschlagen ist. Weitere Informationen finden Sie unter Automatisierte Auftragswiederholungen.

  15. Bei Batch-Auftragswarteschlangen-Zieltypen EventBridge benötigt die Berechtigung zum Senden von Ereignissen an das Ziel. EventBridge kann die IAM-Rolle erstellen, die für die Ausführung Ihrer Regel erforderlich ist. Führen Sie eine der folgenden Aktionen aus:

    • Um automatisch eine IAM-Rolle zu erstellen, wählen Sie Create a new role for this specific resource (Eine neue Rolle für diese spezifische Ressource erstellen).

    • Um eine bereits erstellte IAM-Rolle zu verwenden, wählen Sie Vorhandene Rolle verwenden aus.

  16. (Optional) Erweitern Sie Additional settings (Zusätzliche Einstellungen).

  17. Wählen Sie im Abschnitt Additional settings (Zusätzliche Einstellungen) unter Configure target input (Zieleingabe konfigurieren) die Option Input Transformer (Eingabetransformator).

  18. Wählen Sie Configure input transformer (Eingabetransformator konfigurieren).

  19. (Optional) Für Beispielereignis :

    1. Wählen Sie für Beispielereignistyp die Option AWS Ereignisse aus.

    2. Wählen Sie für Beispielereignisse die Option Statusänderung des Batch-Auftrags aus.

  20. Geben Sie im Abschnitt Target input transformer (Zieleingabetransformator) für Input path (Eingabepfad) die Werte an, die aus dem auslösenden Ereignis analysiert werden sollen. Verwenden Sie beispielsweise das folgende JSON-Format, um das Ereignis „Batch-Auftragsstatusänderung“ zu analysieren.

    {
    "instance": "$.detail.jobId",
    "state": "$.detail.status"
}

  21. Geben Sie für Vorlage Folgendes ein.

    {
    "instance": <jobId> ,
    "status": <status>
}

  22. Wählen Sie Bestätigen aus.

  23. Geben Sie unter Höchstalter des Ereignisses das Zeitintervall für die Aufbewahrungsdauer unverarbeiteter Ereignisse an.

  24. Geben Sie unter Wiederholungsversuche die Häufigkeit ein, mit der ein Ereignis erneut versucht wird.

  25. Wählen Sie für Warteschlange für unzustellbare Nachrichten eine Option aus, um festzulegen, wie unverarbeitete Ereignisse behandelt werden. Geben Sie bei Bedarf die Amazon SQS-Warteschlange an, die als Warteschlange für unzustellbare Nachrichten verwendet werden soll.

  26. (Optional) Wählen Sie Weiteres Ziel hinzufügen, um ein zusätzliches Ziel hinzuzufügen.

  27. Wählen Sie Weiter aus.

  28. (Optional) Wählen Sie für Tags die Option Neues Tag hinzufügen aus, um eine Ressourcenbezeichnung hinzuzufügen. Weitere Informationen finden Sie unter Amazon- EventBridge Tags im Amazon- EventBridge Benutzerhandbuch.

  29. Wählen Sie Weiter aus.

  30. Überprüfen Sie unter Überprüfen und erstellen die Konfigurationsschritte. Wenn Sie Änderungen vornehmen müssen, wählen Sie Edit (Bearbeiten). Nachdem Sie fertig sind, wählen Sie Regel erstellen aus.