Trigger einbauen AWS CodeBuild - AWS CodeBuild

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.

Trigger einbauen AWS CodeBuild

AWS CodeBuild Trigger erstellen

AWS CodeBuild Trigger erstellen (Konsole)

Sie können einen Auslöser für ein Projekt erstellen, um eine Erstellung pro Stunde, Tag oder Woche zu planen. Sie können einen Trigger auch mithilfe einer benutzerdefinierten Regel mit einem CloudWatch Amazon-Cron-Ausdruck erstellen. Mit einem cron-Ausdruck können Sie beispielsweise eine Erstellung für eine bestimmte Zeit an jedem Wochentag planen.

Anmerkung

Es ist nicht möglich, einen Batch-Build von einem Build-Trigger, einem EventBridge Amazon-Ereignis oder einer AWS Step Functions Aufgabe aus zu starten.

So erstellen Sie einen Auslöser

  1. Öffnen Sie die AWS CodeBuild Konsole unter https://console.aws.amazon.com/codesuite/codebuild/home.

  2. Wählen Sie im linken Navigationsbereich Build projects aus.

  3. Klicken Sie auf den Link des Build-Projekts, dem Sie einen Auslöser hinzufügen möchten, und wählen Sie dann die Registerkarte Build triggers (Auslöser erstellen).

    Anmerkung

    Standardmäßig werden die 100 neuesten Build-Projekte angezeigt. Zur Anzeige von weiteren Build-Projekten wählen Sie das Zahnradsymbol und einen anderen Wert für Projects per page (Projekte je Seite) aus oder verwenden die Vorwärts- und Rückwärtspfeile.

  4. Wählen Sie Create trigger.

  5. Geben Sie unter Trigger name (Auslösername) einen Namen ein.

  6. Wählen Sie in der Dropdown-Liste Frequency (Frequenz) die Frequenz für den Auslöser aus. Wenn Sie mit einem Cron-Ausdruck eine Frequenz erstellen möchten, wählen Sie Custom (Benutzerdefiniert) aus.

  7. Legen Sie die Parameter für die Häufigkeit Ihres Auslösers fest. Sie können die ersten paar Zeichen Ihrer Auswahl in das Textfeld eingeben, um die Elemente des Dropdown-Menüs zu filtern.

    Anmerkung

    Die Startstunden und -minuten basieren auf Null. Die Startminute ist eine Zahl zwischen Null und 59. Die Startstunde ist eine Zahl zwischen Null und 23. Ein täglicher Trigger, der jeden Tag um 12:15 Uhr startet, hat beispielsweise eine Startstunde von 12 und eine Startminute von 15. Ein täglicher Trigger, der jeden Tag um Mitternacht beginnt, hat eine Startstunde von Null und eine Startminute von Null. Ein täglicher Trigger, der jeden Tag um 23:59 Uhr beginnt, hat eine Startstunde von 23 und eine Startminute von 59.

    Häufigkeit Erforderliche Parameter Details
    Stündlich

    Startminute

    Verwenden Sie das Dropdown-Menü Start minute (Startminute).

    Täglich

    Startminute

    Startstunde

    Verwenden Sie das Dropdown-Menü Start minute (Startminute).

    Verwenden Sie das Dropdown-Menü Start hour (Startstunde).

    Wöchentlich

    Startminute

    Startstunde

    Starttag

    Verwenden Sie das Dropdown-Menü Start minute (Startminute).

    Verwenden Sie das Dropdown-Menü Start hour (Startstunde).

    Verwenden Sie das Dropdown-Menü Start day (Starttag).

    Benutzerdefiniert

    Cron-Ausdruck

    Geben Sie unter Cron expression (Cron-Ausdruck) einen Cron-Ausdruck ein. Ein Cron-Ausdruck besitzt sechs durch Leerzeichen voneinander getrennte Pflichtfelder. Die Felder geben einen Startwert für Minute, Stunde, Tag, Tag des Monats, Monat, Tag der Woche und Jahr an. Sie können Platzhalterzeichen verwenden, um einen Bereich, zusätzliche Werte und mehr anzugeben. Der Cron-Ausdruck 0 9 ? * MON-FRI * plant beispielsweise an jedem Wochentag um 9:00 Uhr einen Build. Weitere Informationen finden Sie unter Cron-Ausdrücke im Amazon CloudWatch Events-Benutzerhandbuch.

  8. Wählen Sie Enable this trigger (Diesen Trigger aktivieren) aus.

  9. (Optional) Erweitern Sie den Abschnitt Advanced (Erweitert). Geben Sie in das Feld Source version (Quellversion) eine Version der Quelle ein.

    • Geben Sie für Amazon S3 die Versions-ID ein, die der Version des Eingabeartefakts entspricht, das Sie erstellen möchten. Wenn Sie das Feld Source version (Quellversion) leer lassen, wird die neueste Version verwendet.

    • Geben Sie für AWS CodeCommit eine Commit-ID ein. Wenn das Feld Source version (Quellversion) leer bleibt, wird die HEAD-Commit-ID der Standard-Branch verwendet.

    • Geben Sie für GitHub oder GitHub Enterprise eine Commit-ID, eine Pull-Request-ID, einen Branch-Namen oder einen Tag-Namen ein, der der Version des Quellcodes entspricht, den Sie erstellen möchten. Wenn Sie eine Pull-Anforderungs-ID angeben, muss diese das Format pr/pull-request-ID verwenden (Beispiel: pr/25). Wenn Sie einen Branch-Namen angeben wird, wird die Commit-ID von HEAD verwendet. Wenn das Feld Source version (Quellversion) leer ist, wird die HEAD-Commit-ID für die Standard-Branch verwendet.

    • Für Bitbucket geben Sie eine Commit-ID, einen Verzweigungsnamen oder einen Tag-Namen, die/der der Version des Quellcodes entspricht, den Sie erstellen möchten. Wenn Sie einen Branch-Namen angeben wird, wird die Commit-ID von HEAD verwendet. Wenn das Feld Source version (Quellversion) leer ist, wird die HEAD-Commit-ID für die Standard-Branch verwendet.

  10. (Optional) Geben Sie ein Timeout zwischen 5 Minuten und 2160 Minuten (36 Stunden) an. Dieser Wert gibt an, wie lange ein Build AWS CodeBuild versucht, bevor er beendet wird. Wenn die Felder Hours (Stunden) und Minutes (Minuten) leer bleiben, wird der Timeout-Standardwert im Projekt verwendet.

  11. Wählen Sie Create trigger.

AWS CodeBuild Trigger programmgesteuert erstellen

CodeBuild verwendet EventBridge Amazon-Regeln für Build-Trigger. Sie können die EventBridge API verwenden, um programmgesteuert Build-Trigger für Ihre CodeBuild Projekte zu erstellen. Weitere Informationen finden Sie in der Amazon EventBridge API-Referenz.

AWS CodeBuild Auslöser bearbeiten

AWS CodeBuild Trigger bearbeiten (Konsole)

Sie können einen Auslöser für ein Projekt bearbeiten, um eine Erstellung pro Stunde, Tag oder Woche zu planen. Sie können einen Trigger auch bearbeiten, um eine benutzerdefinierte Regel mit einem CloudWatch Amazon-Cron-Ausdruck zu verwenden. Mit einem cron-Ausdruck können Sie beispielsweise eine Erstellung für eine bestimmte Zeit an jedem Wochentag planen. Weitere Informationen zum Erstellen eines Auslösers finden Sie unter AWS CodeBuild Trigger erstellen.

So bearbeiten Sie einen Auslöser
  1. Öffnen Sie die AWS CodeBuild Konsole unter https://console.aws.amazon.com/codesuite/codebuild/home.

  2. Wählen Sie im linken Navigationsbereich Build projects aus.

  3. Wählen Sie den Link des Build-Projekts aus, das Sie bearbeiten möchten, und anschließend die Registerkarte Build triggers (Build-Auslöser).

    Anmerkung

    Standardmäßig werden die 100 neuesten Build-Projekte angezeigt. Zur Anzeige von weiteren Build-Projekten wählen Sie das Zahnradsymbol und einen anderen Wert für Projects per page (Projekte je Seite) aus oder verwenden die Vorwärts- und Rückwärtspfeile.

  4. Aktivieren Sie das Optionsfeld neben dem Auslöser, den Sie ändern möchten, und klicken Sie dann auf Edit (Bearbeiten).

  5. Wählen Sie in der Dropdown-Liste Frequency (Frequenz) die Frequenz für den Auslöser aus. Wenn Sie mit einem Cron-Ausdruck eine Frequenz erstellen möchten, wählen Sie Custom (Benutzerdefiniert) aus.

  6. Legen Sie die Parameter für die Häufigkeit Ihres Auslösers fest. Sie können die ersten paar Zeichen Ihrer Auswahl in das Textfeld eingeben, um die Elemente des Dropdown-Menüs zu filtern.

    Anmerkung

    Die Startstunden und -minuten basieren auf Null. Die Startminute ist eine Zahl zwischen Null und 59. Die Startstunde ist eine Zahl zwischen Null und 23. Ein täglicher Trigger, der jeden Tag um 12:15 Uhr startet, hat beispielsweise eine Startstunde von 12 und eine Startminute von 15. Ein täglicher Trigger, der jeden Tag um Mitternacht beginnt, hat eine Startstunde von Null und eine Startminute von Null. Ein täglicher Trigger, der jeden Tag um 23:59 Uhr beginnt, hat eine Startstunde von 23 und eine Startminute von 59.

    Häufigkeit Erforderliche Parameter Details
    Stündlich

    Startminute

    Verwenden Sie das Dropdown-Menü Start minute (Startminute).

    Täglich

    Startminute

    Startstunde

    Verwenden Sie das Dropdown-Menü Start minute (Startminute).

    Verwenden Sie das Dropdown-Menü Start hour (Startstunde).

    Wöchentlich

    Startminute

    Startstunde

    Starttag

    Verwenden Sie das Dropdown-Menü Start minute (Startminute).

    Verwenden Sie das Dropdown-Menü Start hour (Startstunde).

    Verwenden Sie das Dropdown-Menü Start day (Starttag).

    Benutzerdefiniert

    Cron-Ausdruck

    Geben Sie unter Cron expression (Cron-Ausdruck) einen Cron-Ausdruck ein. Ein Cron-Ausdruck besitzt sechs durch Leerzeichen voneinander getrennte Pflichtfelder. Die Felder geben einen Startwert für Minute, Stunde, Tag, Tag des Monats, Monat, Tag der Woche und Jahr an. Sie können Platzhalterzeichen verwenden, um einen Bereich, zusätzliche Werte und mehr anzugeben. Der Cron-Ausdruck 0 9 ? * MON-FRI * plant beispielsweise an jedem Wochentag um 9:00 Uhr einen Build. Weitere Informationen finden Sie unter Cron-Ausdrücke im Amazon CloudWatch Events-Benutzerhandbuch.

  7. Wählen Sie Enable this trigger (Diesen Trigger aktivieren) aus.

Anmerkung

Sie können die CloudWatch Amazon-Konsole unter https://console.aws.amazon.com/cloudwatch/ verwenden, um Quellversion, Timeout und andere Optionen zu bearbeiten, die in AWS CodeBuild nicht verfügbar sind.

AWS CodeBuild Trigger programmgesteuert bearbeiten

CodeBuild verwendet EventBridge Amazon-Regeln für Build-Trigger. Sie können die EventBridge API verwenden, um die Build-Trigger für Ihre CodeBuild Projekte programmgesteuert zu bearbeiten. Weitere Informationen finden Sie in der Amazon EventBridge API-Referenz.