Repositories aus GitLab erstellen

Mit Cloud Build können Sie Trigger erstellen, Auf GitLab gehostete Repositories, sodass Sie Builds als Reaktion auf Ereignisse wie Commit-Push-Vorgänge oder Zusammenführungsanfragen ausführen können, die mit Ihrem GitLab-Repository verknüpft sind.

Auf dieser Seite wird erläutert, wie Sie die Triggerfunktion GitLab-Instanz. Weitere Informationen zu Cloud Build-Triggern und Cloud Build-Repositories

Hinweise

  • Cloud Build and Secret Manager APIs aktivieren.

    Aktivieren Sie die APIs

GitLab-Trigger erstellen

Console

So erstellen Sie einen GitLab-Trigger mit der Google Cloud Console:

  1. Seite "Trigger" aufrufen

    Seite "Trigger" aufrufen

  2. Wählen Sie oben auf der Seite Ihr Google Cloud-Projekt aus und klicken Sie auf Öffnen.

  3. Klicken Sie auf Trigger erstellen.

  4. Geben Sie die folgenden Triggereinstellungen ein:

    • Name: Ein Name für Ihren Trigger

    • Region: Wählen Sie die Region für den Trigger aus.

      • Wenn die mit dem Trigger verknüpfte Build-Konfigurationsdatei einen privaten Pool angibt, verwendet Cloud Build den privaten Pool zur Ausführung Ihres Builds. In diesem Fall muss die im Trigger angegebene Region mit der Region übereinstimmen, in der Sie den privaten Pool erstellt haben.
      • Wenn die mit dem Trigger verknüpfte Build-Konfigurationsdatei keinen privaten Pool angibt. Cloud Build verwendet die Standardeinstellung Pool, um den Build in derselben Region auszuführen als Trigger festlegen.

    • Beschreibung Optional: Eine Beschreibung für Ihren Trigger.

    • Ereignis: Wählen Sie das Repository-Ereignis aus, das den Trigger auslösen soll.

      • Push zu Zweig: Legen Sie den Trigger so fest, dass ein Build für Commits zu einem bestimmten Zweig gestartet wird.

      • Neues Tag mit Push übertragen: Legen Sie den Trigger so fest, dass ein Build für Commits gestartet wird, die ein bestimmtes Tag enthalten.

      • Pull-Anfrage: Legen Sie den Trigger so fest, dass ein Build für Commits zu einem Anfrage zur Zusammenführung.

    • Quelle: Wählen Sie 2nd gen als Quelle aus.

      • Repository: Wählen Sie aus der Liste der verfügbaren Repositories das gewünschte Repository aus. Informationen zum Verbinden eines neuen Repositorys finden Sie unter Verbindung zu einem GitLab-Repository herstellen.

      • Zweig oder Tag: Geben Sie einen regulären Ausdruck mit dem abzugleichenden Zweig- oder Tag-Wert an. Informationen zur zulässigen Syntax für reguläre Ausdrücke finden Sie unter RE2-Syntax.

      • Kommentarsteuerung: Wenn Sie Pull-Anfrage ausgewählt haben als Ereignis festgelegt haben, wählen Sie eine der folgenden Optionen aus, steuern, ob ein Build automatisch vom Trigger ausgeführt wird:

        • Erforderlich außer für Eigentümer und Mitbearbeiter: bei einer Zusammenführung von einem Repository-Inhaber oder -Mitbearbeiter erstellt oder aktualisiert wird, Builds werden automatisch vom Trigger ausgeführt. Wenn ein externer Contributor die Aktion initiiert, werden Builds erst ausgeführt, nachdem Ein Eigentümer oder Mitbearbeiter kommentiert /gcbrun zur Zusammenführungsanfrage.

        • Erforderlich: Wenn eine Zusammenführungsanfrage von einem beliebigen Beitragender, werden Builds erst ausgeführt, nachdem ein Inhaber oder Ein Mitbearbeiter kommentiert /gcbrun zur Zusammenführungsanfrage. Kreationen werden jedes Mal ausgeführt, wenn eine Änderung an einer Zusammenführungsanfrage vorgenommen wird.

        • Nicht erforderlich: Wenn eine Zusammenführungsanfrage von einem Contributor verwenden, werden Builds automatisch durch Trigger ausgeführt.

    • Konfiguration: Wählen Sie die Build-Konfigurationsdatei aus, die sich im Ihr Repository oder konfigurieren Sie Ihren Build inline den Trigger.

    • Typ: Wählen Sie den Konfigurationstyp aus, der für Ihren Build verwendet werden soll.

      • Cloud Build-Konfigurationsdatei (YAML oder JSON): Verwenden Sie eine Build-Konfigurationsdatei für Ihre Konfiguration.
      • Dockerfile: Verwenden Sie für Ihre Konfiguration eine Dockerfile.

    • Speicherort: Geben Sie den Speicherort für Ihre Konfiguration an.

      • Repository: Wenn sich die Konfigurationsdatei in der Repository, geben Sie den Speicherort Ihres Build-Konfigurationsdatei oder Dockerfile Verzeichnis und einen Namen für das resultierende Image. Wenn Ihre Konfiguration eine Dockerfile ist, können Sie optional ein Zeitlimit für Ihren Build angeben. Wenn Sie Dockerfile und den Image-Namen angegeben haben, sehen Sie eine Vorschau des Befehls docker build, den Ihr Build ausführen wird.

      • Inline: Wenn Sie die Cloud Build-Konfigurationsdatei (YAML oder JSON) als Konfigurationsoption ausgewählt haben, können Sie die Build-Konfiguration inline angeben. Klicken Sie auf Editor öffnen, um die Build-Konfigurationsdatei in den Google Cloud Console mit YAML- oder JSON-Syntax Klicken Sie auf Fertig, um die Build-Konfiguration zu speichern.

  5. Klicken Sie auf Create (Erstellen), um den GitLab-Trigger zu erstellen.

gcloud

Führen Sie folgenden Befehl aus, um GitLab-Trigger mit gcloud-Befehlen zu erstellen Befehl:

gcloud builds triggers create gitlab \
  --name=TRIGGER_NAME \
  --repository=projects/PROJECT_ID/locations/REGION/connections/CONNECTION_NAME/repositories/REPO_NAME \
  --branch-pattern=BRANCH_PATTERN # or --tag-pattern=TAG_PATTERN \
  --build-config=BUILD_CONFIG_FILE \
  --region=REGION

Wobei:

  • TRIGGER_NAME ist der Name des Triggers.
  • PROJECT_ID ist Ihre Google Cloud-Projekt-ID.
  • REGION ist die Region Ihres Triggers.
  • CONNECTION_NAME ist der Name Ihrer GitLab-Verbindung.
  • REPO_NAME ist der Name Ihres Repositorys
  • BRANCH_PATTERN ist der Zweigname in Ihrem Repository, für den der Build aufgerufen werden soll.
  • TAG_PATTERN ist der Tag-Name in Ihrem Repository, in dem der Build ausgelöst werden soll.
  • BUILD_CONFIG_FILE ist der Pfad zu Ihrer Build-Konfigurationsdatei.

Datenfreigabe

Mit den von Cloud Build an GitLab gesendeten Daten können Sie Trigger anhand des Namens identifizieren und Build-Ergebnisse in Ihren GitLab-Repositories aufrufen.

Die folgenden Daten werden derzeit von Cloud Build und Ihrem GitLab-Host gemeinsam verwendet:

  • Google Cloud-Projekt-ID
  • Triggername

Nächste Schritte