Oracle Cloud Infrastructure-Dokumentation

Build-Ausführung auslösen

In Oracle Cloud Infrastructure (OCI) DevOps kann eine Build-Ausführung automatisch ausgelöst werden, wenn Sie Ihre Änderungen in einem Code-Repository festschreiben.

Im DevOps-Service können Sie eigene private Code-Repositorys erstellen oder eine Verbindung zu externen Code-Repositorys herstellen. Damit können Sie den Build auslösen. Weitere Informationen finden Sie unter Externe Verbindung erstellen.

Sie können die Triggeraktion steuern, indem Sie die geänderten Dateien in Ihrem Repository angeben, die während der Build-Ausführung ein- oder ausgeschlossen werden sollen. Die Aktion dateibasierter Trigger gilt nur für das Push-Ereignis.

Bevor Sie einen Trigger in DevOps erstellen, benötigen Sie ein DevOps-Projekt, eine Build-Pipeline und ein Code-Repository, das mit dem Projekt verknüpft ist.

Informationen zum manuellen Ausführen eines Builds finden Sie unter Build ausführen.

Informationen zum Zugriff auf DevOps über die Oracle Cloud-Konsole, die REST-API und die CLI finden Sie unter Auf DevOps zugreifen.

    1. Öffnen Sie das Navigationsmenü, und klicken Sie auf Entwicklerservices. Klicken Sie unter DevOps auf Projekte.
    2. Wählen Sie auf der Seite DevOps Projects ein Projekt aus.
    3. Klicken Sie auf der Detailseite des Projekts auf der linken Seite auf Trigger.
    4. Klicken Sie auf Trigger erstellen.
    5. Geben Sie einen Namen für den Trigger ein, und wählen Sie eine vorhandene Quellverbindung aus:
      • OCI-Code-Repository
      • GitHub
      • GitLab
      • Bitbucket Cloud
      • Visual Builder Studio
      • Bitbucket Server
      • GitLab Server
    6. Wenn Sie die Option OCI-Code-Repository auswählen, müssen Sie ein Code-Repository auswählen, in dem die Änderungen festgeschrieben werden sollen.
    7. (Optional) Wählen Sie für Bitbucket Cloud und Visual Builder Studio eine Verbindung mit den Authentifizierungszugangsdaten und der Basis-URL aus.

      Für dateibasierte Trigger mit Push-Ereignis ist eine Verbindung erforderlich.

    8. Klicken Sie auf Aktion hinzufügen.
    9. Wählen Sie eine Build-Pipeline aus, die ausgelöst werden soll.
    10. (Optional) Wählen Sie ein Ereignis aus den folgenden Optionen aus, um die Build-Ausführung auszulösen:
      • Push
      • Pull-Anforderung erstellt
      • Pull-Anforderung aktualisiert
      • Pull-Anforderung zusammengeführt
      • Pull-Anforderung erneut geöffnet
      Hinweis

      Die Ereignisverfügbarkeit variiert je nach Typ des Code-Repositorys. Bei Bitbucket Cloud und Bitbucket Server wird das Ereignis "Pull-Anforderung erneut geöffnet" nicht unterstützt.
    11. Wählen Sie Build-Ausführungsbedingungen aus.
      Für das Push-Ereignis können Sie die Build-Ausführung auslösen, indem Sie den Namen der Quellverzweigung und die Dateien angeben, die in die Build-Ausführung aufgenommen oder daraus ausgeschlossen werden sollen.
      • (Optional) Geben Sie die Quell-Repository-Verzweigung ein, für die das ausgewählte Ereignis die Build-Ausführung auslöst.

        Wenn Sie eines der Pull-Anforderungsereignisse auswählen, können Sie auch die Code-Repository-Zielverzweigung auswählen.

      • (Optional) Geben Sie die Dateien ein, die für die Triggeraktion aufgenommen werden sollen. Dateien werden mit Glob-Mustern angegeben.

        Beispiel: src/**/*.txt umfasst alle Textdateien im Ordner "src". Weitere Beispiele und Details finden Sie unter Glob-Muster.

      • (Optional) Geben Sie die Dateien ein, die für die Triggeraktion ausgeschlossen werden sollen. Dateien werden mit Glob-Mustern angegeben.

        Beispiel: **.HTML schließt alle HTML-Dateien aus. Weitere Beispiele und Details finden Sie unter Glob-Muster.

    12. Speichern Sie die Änderungen.
    13. Klicken Sie auf Erstellen, um den Trigger zu erstellen.
    14. Kopieren Sie im Dialogfeld Trigger-Secret die Trigger-URL und das Trigger-Secret, weil diese in der Konsole nicht erneut abgerufen werden können.

      Das Trigger-Secret gilt nur für GitHub, GitLab und Visual Builder Studio. Bei Bitbucket Cloud ist das Secret in der Trigger-URL enthalten. Um über diese Repositorys auf den DevOps-Service zuzugreifen, müssen Sie in den externen Code-Repositorys einen Webhook und ein Secret einrichten.

      Informationen zum Einrichten von Webhooks für die verschiedenen externen Repositorys finden Sie unter den folgenden Links:

    15. Klicken Sie auf Schließen.

  • Um einen OCI-Code-Repository-Trigger zu erstellen, führen Sie den Befehl create-devops-code-repo-trigger aus:

    oci devops trigger create-devops-code-repo-trigger --actions, --project-id

    Um einen GitHub-Trigger zu erstellen, führen Sie den Befehl create-github-trigger aus:

    oci devops trigger create-github-trigger --actions, --project-id

    Um einen GitLab-Trigger zu erstellen, führen Sie den Befehl create-gitlab-trigger aus:

    oci devops trigger create-gitlab-trigger --actions, --project-id

    Um einen Bitbucket Cloud-Trigger zu erstellen, führen Sie den Befehl create-bitbucket-cloud-trigger aus:

    oci devops trigger create-bitbucket-cloud-trigger --actions, --project-id

    Um einen Visual Builder Studio-Trigger zu erstellen, führen Sie den Befehl create-vbs-trigger aus:

    oci devops trigger create-vbs-trigger --actions, --project-id

    Um einen Bitbucket Server-Trigger zu erstellen, führen Sie den Befehl create-bitbucket-server-trigger aus:

    oci devops trigger create-bitbucket-server-trigger --actions, --project-id

    Um einen GitLab Server-Trigger zu erstellen, führen Sie den Befehl create-gitlab-server-trigger aus:

    oci devops trigger create-gitlab-server-trigger --actions, --project-id

    So rufen Sie alle Befehle für trigger ab:

    oci devops trigger -h

  • Um einen Trigger zu erstellen, verwenden Sie den Vorgang CreateTrigger.