Verbindung zu einem Bitbucket-Server-Repository herstellen

Auf dieser Seite wird beschrieben, wie Sie eine Verbindung zu einem Bitbucket Server-Repository mit Cloud Build herstellen.

Hinweise

  • Enable the Cloud Build, Secret Manager, and Compute Engine APIs.

    Enable the APIs

Verbindung zu einem Bitbucket Server-Repository herstellen

Console

So verbinden Sie ein Bitbucket Server-Repository über die Google Cloud -Console mit Cloud Build:

  1. Öffnen Sie in der Google Cloud -Konsole die Seite Repositories.

    Zur Seite „Repositories“

  2. Wählen Sie oben auf der Seite den Tab 1. Generation aus.

  3. Klicken Sie auf Repository verbinden.

  4. Wählen Sie Bitbucket Server aus.

    Das Feld Repository verbinden wird angezeigt. Führen Sie die folgenden Schritte aus, um eine Verbindung zu Ihrem Bitbucket Server-Repository herzustellen:

    1. Region: Wählen Sie die Region aus, in der sich Ihre Verbindung befindet.

    2. Wählen Sie unter Anbieter für Quellcodeverwaltung auswählen die Option Bitbucket Server aus.

    3. Hostverbindung: Wählen Sie im Drop-down-Menü den Namen Ihrer Hostverbindung aus.

    4. Klicken Sie auf Weiter.

    5. Wählen Sie unter Repository auswählen die Bitbucket Server-Repositories aus, die Sie mit Cloud Build verbinden möchten.

    6. Lesen Sie nach dem Auswählen des Bitbucket-Serverkontos und der Repositories den Haftungsausschluss und klicken Sie anschließend das Kästchen daneben an, um die Nutzungsbedingungen zu akzeptieren.

    7. Klicken Sie auf Verbinden, um Ihre Repositories zu verbinden.

    Wenn ein Repository verbunden ist, konfiguriert Cloud Build einen Webhook für das Repository in Ihrer Bitbucket Server-Instanz. Das Repository sendet dann Webhooks, um die entsprechenden Bitbucket-Server-Trigger aufzurufen, wenn Sie Änderungen an Ihrem Repository vornehmen. Ein Repository kann auch mehrmals mit mehreren Hostverbindungen verbunden werden. Informationen zum Verwalten von Webhooks finden Sie unter Webhooks verwalten.

    Um den Webhook zu finden, benötigen Sie die Webhook-ID. Die Webhook-ID für jedes verbundene Repository finden Sie in der BitbucketServerConfig.

    Geben Sie den folgenden Befehl ein, um die Webhook-ID abzurufen:

      gcloud alpha builds enterprise-config bitbucketserver describe CONFIG_NAME  --region=REGION

    Wobei:

    • CONFIG_NAME ist der Name der Bitbucket-Serverkonfiguration.
    • REGION ist die Region der Bitbucket Server-Hostverbindung.

  5. Klicken Sie auf Fertig. Optional können Sie auf Trigger erstellen klicken, um einen Trigger zu erstellen.

API

So verbinden Sie Ihr Bitbucket Server-Repository über die API mit Cloud Build:

  1. Verwenden Sie die folgende JSON-Vorlage, um eine Verbindung zu Ihrem Repository herzustellen:

    {
  "parent": "projects/PROJECT_NUMBER/locations/REGION/bitbucketServerConfigs/BITBUCKET_SERVER_CONFIG_NAME",
  "requests": {
    "parent": "projects/PROJECT_NUMBER/locations/REGION/bitbucketServerConfigs/BITBUCKET_SERVER_CONFIG_NAME",
   "bitbucketServerConnectedRepository": {
      "parent": "projects/PROJECT_NUMBER/locations/REGION/bitbucketServerConfigs/BITBUCKET_SERVER_CONFIG_NAME",
      "repo": {
        "projectKey": "PROJECT_KEY",
        "repoSlug": "REPO_SLUG"
       }
     }
  }
}

    Wobei:

    • PROJECT_NUMBER ist die Projektnummer Ihres Cloud-Projekts.
    • REGION ist die Region, die mit Ihrer Bitbucket Server-Konfiguration verknüpft ist.
    • BITBUCKET_SERVER_CONFIG_NAME ist der Name Ihrer Bitbucket-Serverkonfiguration.
    • PROJECT_KEY ist der Schlüssel Ihres Bitbucket Server-Projekts. Wenn Sie eine Verbindung zu einem privaten Repository herstellen möchten, muss Ihr Projektschlüssel vor Ihrem Nutzernamen das Tildesymbol (~) enthalten. Beispiel: ~${USERNAME}. Die vollständige URL für ein Host-Repository könnte so aussehen: https://${HOST_URI}/projects/~${USER_NAME}/repos/${REPO_SLUG}.
    • REPO_SLUG ist der Slug Ihres Bitbucket Server-Repositories.

  2. Geben Sie den folgenden curl-Befehl in Ihr Terminal ein:

    curl -X POST -H "Authorization: Bearer "$(gcloud auth print-access-token) -H "Content-Type: application/json; charset=utf-8" -H "x-goog-user-project: PROJECT_NUMBER" https://cloudbuild.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/bitbucketServerConfigs/BITBUCKET_SERVER_CONFIG_NAME/connectedRepositories:batchCreate -d @requests.json

    Wobei:

    • PROJECT_NUMBER ist die Nummer Ihres Cloud-Projekts.
    • PROJECT_ID ist die ID Ihres Cloud-Projekts.
    • REGION ist die Region, die mit Ihrer Bitbucket Server-Konfiguration verknüpft ist.
    • BITBUCKET_SERVER_CONFIG_NAME ist der Name Ihrer Bitbucket-Serverkonfiguration.

    Bei erfolgreicher Ausführung enthält der Antworttext eine neu erstellte Operation-Instanz.

  3. Geben Sie den folgenden curl-Befehl in Ihr Terminal ein:

    curl -X GET -H "Authorization: Bearer "$(gcloud auth print-access-token) -H "Content-Type: application/json; charset=utf-8"  -H "x-goog-user-project: PROJECT_NUMBER" https://cloudbuild.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/operations/OPERATION_ID

    Wobei:

    • PROJECT_NUMBER ist die Nummer Ihres Cloud-Projekts.
    • PROJECT_ID ist die ID Ihres Cloud-Projekts.
    • REGION ist die Region, die mit Ihrer Bitbucket Server-Konfiguration verknüpft ist.
    • OPERATION_ID ist die ID des Vorgangs zum Erstellen der Bitbucket Server-Konfiguration. Die Vorgangs-ID finden Sie im Feld name der Antwort. Das Format des Felds name in Ihrer Antwort sieht so aus: projects/project-id/locations/region/operations/operation-id.

    Möglicherweise müssen Sie den GetOperation API-Befehl so lange ausführen, bis die Antwort done: true enthält, was bedeutet, dass der Vorgang abgeschlossen ist. Wenn die Verbindung zum Bitbucket-Server-Repository hergestellt wurde, wird das verbundene Repository im Feld response.bitbucketServerConnectedRepositories angezeigt. Andernfalls finden Sie im Feld error einen detaillierten Fehlerbericht.

Nächste Schritte