Verbindung zu Bitbucket Data Center herstellen

Auf dieser Seite wird beschrieben, wie Sie Verbindungen zu Bitbucket Data Center und Links zu Bitbucket Data Center-Repositories erstellen. Sie können diese Aufgaben mit der Google Cloud Console oder der Google Cloud CLI ausführen.

Diese Anleitung richtet sich an Anwendungsentwickler, Plattformadministratoren und Sicherheitsmanager, die Bitbucket Data Center-Quellcode-Repositories mit Google verwenden möchten. Insbesondere können Sie Bitbucket Rechenzentrum-Repositories mit Gemini Code Assist verwenden.

Weitere Informationen finden Sie unter Developer Connect.

Hinweis

  1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  2. Verify that billing is enabled for your Google Cloud project.

  3. Enable the Developer Connect, Secret Manager APIs, if any are not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the APIs

  4. Sie benötigen Zugriff auf ein Konto im Bitbucket Data Center.

    Damit die Arbeit Ihres Teams sicher bleibt, empfehlen wir, die Aufgaben in diesem Leitfaden mit einem Bot-Konto oder einem von Ihrem Team freigegebenen Konto und nicht mit einem privaten Konto auszuführen.

  5. Sie müssen Inhaber eines Bitbucket Data Center-Repositorys sein oder Administratorberechtigungen für ein freigegebenes Repository haben.
  6. Optional: Erstellen Sie einen vom Kunden verwalteten Verschlüsselungsschlüssel (CMEK), um die von Developer Connect erstellten Authentifizierungs-Secrets zu verschlüsseln.
  7. Optional: Wenn Sie die Befehlszeilenanleitungen in diesem Leitfaden verwenden möchten, führen Sie die folgenden Schritte aus:
    1. Installieren Sie die Google Cloud CLI. Wenn Sie die gcloud CLI bereits installiert haben, prüfen Sie, ob Sie die neueste verfügbare Version nutzen. Führen Sie dazu gcloud components update aus.
    2. Erstellen Sie ein Developer Connect-Dienstkonto, indem Sie den folgenden Befehl ausführen, wobei PROJECT_ID Ihre Google Cloud -Projekt-ID ist:
              gcloud beta services identity create \
                  --service=developerconnect.googleapis.com \
                  --project=PROJECT_ID
              

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen von Verbindungen und Verknüpfungen benötigen:

  • Wenn Sie nicht der Project Owner sind: Developer Connect-Administrator (roles/developerconnect.admin) für Ihr Nutzerkonto.
  • Wenn Sie einen CMEK zum Verschlüsseln der von Developer Connect erstellten Secrets verwenden möchten: Cloud KMS CryptoKey-Verschlüsseler/Entschlüsseler (roles/cloudkms.cryptoKeyEncrypterDecrypter) für das Secret Manager-Dienstkonto.
  • Wenn Sie die gcloud CLI verwenden möchten, um die Schritte in dieser Anleitung auszuführen: Secret Manager-Administratorrolle (roles/secretmanager.admin) für das Developer Connect-Dienstkonto.
  • Wenn Sie die Schritte in dieser Anleitung über die Google Cloud Console ausführen möchten: Project IAM Admin (roles/resourcemanager.projectIamAdmin) für Ihr Nutzerkonto.

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Zugriffstokens erstellen

So erstellen Sie persönliche Zugriffstokens in Bitbucket Data Center:

  1. Melden Sie sich im Bitbucket Data Center an.

  2. Folgen Sie der Anleitung in der Bitbucket Rechenzentrum-Dokumentation, um zwei HTTP-Zugriffstokens zu erstellen und die folgenden Bereiche zu gewähren.

    Developer Connect unterstützt Nutzer-, Projekt- und Repository-Zugriffstokens.

    • Erstellen Sie ein Token mit dem Bereich repository admin. In Developer Connect wird dieses Token als Administratorzugriffstoken bezeichnet.
    • Erstellen Sie ein Token mit dem Bereich repository read. In Developer Connect wird dieses Token als Lesezugriffstoken bezeichnet.

    Sie sind für die Verwaltung der Lebensdauer von Bitbucket Data Center-Tokens in Bitbucket Data Center verantwortlich. Zum Schutz Ihres Quellcodes können Sie beim Erstellen des Tokens ein Ablaufdatum festlegen. Wenn Sie kein Ablaufdatum festlegen, bleibt das Token gültig, bis Sie es im Bitbucket Data Center widerrufen.

  3. Kopieren Sie die Zugriffstokens, um sie in den folgenden Verfahren zu verwenden.

Verbindung herstellen

In diesem Abschnitt wird beschrieben, wie Sie eine Verbindung zwischen Developer Connect und Bitbucket Data Center herstellen. Wenn Sie die Google Cloud Console verwenden, können Sie auch Links zu Repositories hinzufügen, während Sie die Verbindung einrichten.

Wählen Sie eine der folgenden Optionen aus, um eine neue Bitbucket Data Center-Verbindung zu erstellen:

Console

Stellen Sie eine Verbindung her. Führen Sie dazu die folgenden Schritte aus:

  1. Öffnen Sie in der Google Cloud Console Developer Connect.

    Zu Developer Connect

    In Developer Connect wird die Seite Git-Repositories angezeigt.

    • Wenn Sie eine Liste der Anbieter für Quellcodeverwaltung sehen: Beginnen Sie mit der Konfiguration Ihrer ersten Verbindung, indem Sie einen Anbieter für Quellcodeverwaltung auswählen. Klicken Sie auf der Bitbucket Rechenzentrum-Karte auf Verbinden.
    • Wenn Sie eine Tabelle mit vorhandenen Verbindungen sehen: Legen Sie den Anbieter für die Quellcodeverwaltung fest, indem Sie auf Verbindung erstellen > Bitbucket Data Center klicken.

      Die Seite Verbindung erstellen wird geöffnet.

  2. Wählen Sie unter Region eine Region für Ihre Verbindungsressourcen aus.

    1. Geben Sie unter Name einen Namen für die neue Verbindung ein.
  3. Geben Sie unter Host-URL die URL für den Bitbucket Rechenzentrum-Host ein, zu dem Sie eine Verbindung herstellen möchten.

  4. Geben Sie im Abschnitt Zugriffstokens Ihre Bitbucket Data Center-Zugriffstokens ein:

    • Administratorzugriffstoken: Geben Sie das Token mit dem Zugriffsbereich „Repository-Administrator“ ein.

    • Lesezugriffstoken: Geben Sie das Token mit dem Bereich „repository read“ ein.

  5. Klicken Sie auf Mehr anzeigen, um optionale Konfigurationseinstellungen aufzurufen.

    1. Optional: Standardmäßig kann Developer Connect als Proxy für Git-Aufrufe an Bitbucket Data Center fungieren. Wenn Sie diese Option deaktivieren möchten, entfernen Sie das Häkchen aus dem Kästchen Developer Connect-Proxy aktivieren.

    2. Optional: Wählen Sie im Abschnitt Verschlüsselung einen CMEK-Schlüssel aus, um Secret Manager-Secrets zu verschlüsseln, die von Developer Connect erstellt werden.

  6. Klicken Sie auf Weiter. Developer Connect erstellt Ihre Verbindung. Dieser Vorgang kann einige Sekunden dauern.

Nachdem die Verbindung erstellt wurde, wird die Seite Repositories verknüpfen angezeigt.

Führen Sie die folgenden Schritte aus, um Repositories mit Ihrer Verbindung zu verknüpfen:

  1. Wählen Sie in der Liste der verfügbaren Repositories die Repositories aus, die Sie verwenden möchten.

  2. Klicken Sie auf OK.

  3. Klicken Sie auf Verknüpfen.

Ihre Verbindung wird der Seite Verbindungen und Ihre Repository-Links der Seite Repositories in der Google Cloud Console hinzugefügt. Sie können jederzeit weitere Links zu bestehenden Verbindungen hinzufügen.

Wenn Sie Gemini Code Assist einrichten, fahren Sie mit den Schritten unter Codeanpassung für Gemini Code Assist konfigurieren und verwenden fort.

gcloud

  1. Erstellen Sie ein Webhook-Secret in Secret Manager, indem Sie den folgenden Befehl ausführen. Dabei ist WEBHOOK_SECRET_NAME ein Name für Ihr Webhook-Secret:

    cat /proc/sys/kernel/random/uuid | tr -d '\n' | gcloud secrets create WEBHOOK_SECRET_NAME
    
  2. Speichern Sie Ihre Zugriffstokens in Secret Manager, indem Sie die folgenden Befehle ausführen:

    gcloud secrets create ADMIN_SECRET_NAME
    
    echo -n ADMIN_SECRET_DATA | gcloud secrets versions add ADMIN_SECRET_NAME --data-file=-
    
    gcloud secrets create READ_SECRET_NAME
    
    echo -n READ_SECRET_DATA | gcloud secrets versions add READ_SECRET_NAME --data-file=-
    

    Ersetzen Sie Folgendes:

    • ADMIN_SECRET_NAME: ein Name für das Secret, in dem Ihr Administratorzugriffstoken gespeichert wird.
    • ADMIN_SECRET_DATA: Ihr Administratorzugriffstoken.
    • READ_SECRET_NAME: ein Name für das Secret, in dem Ihr Lesezugriffstoken gespeichert ist.
    • READ_SECRET_DATA: Ihr Lesezugriffstoken.
  3. Führen Sie den Befehl gcloud developer-connect connections create aus, um eine Verbindung zu Bitbucket Rechenzentrum herzustellen:

    gcloud developer-connect connections create CONNECTION_NAME \
        --location=REGION \
        --bitbucket-data-center-config-host-uri=HOST_URI \
        --bitbucket-data-center-config-authorizer-credential-user-token-secret-version=projects/PROJECT_ID/secrets/ADMIN_SECRET_NAME/versions/VERSION \
        --bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version=projects/PROJECT_ID/secrets/READ_SECRET_NAME/versions/VERSION \
        --bitbucket-data-center-config-webhook-secret-version=projects/PROJECT_ID/secrets/WEBHOOK_SECRET_NAME/versions/VERSION \
        --git-proxy-config-enabled
    

    Ersetzen Sie Folgendes:

    • CONNECTION_NAME: Ein Name für Ihre Verbindung.
    • REGION: die Region, die für Ihre Verbindung verwendet werden soll.
    • HOST_URI: Der URI Ihres Bitbucket Data Center-Hosts, einschließlich des Präfixes https://.
    • PROJECT_ID: Ihre Projekt-ID in Google Cloud.
    • ADMIN_SECRET_NAME: der Name des Secret Manager-Secrets, das Ihr Administrator-Zugriffstoken enthält.
    • READ_SECRET_NAME: der Name des Secret Manager-Secrets, das Ihr Lesezugriffstoken enthält.
    • WEBHOOK_SECRET_NAME: der Name des Secret Manager-Secrets, das Ihr Webhook-Secret enthält.
    • VERSION: Die Versionsnummer des jeweiligen Secrets. Dies kann latest sein, um die neueste Versionsnummer zu verwenden.
    • --git-proxy-config-enabled: ein optionales Flag, mit dem Developer Connect als Proxy für Git-Aufrufe an Bitbucket Data Center fungieren kann.

    Developer Connect stellt die Verbindung zu Bitbucket Data Center her. Verknüpfen Sie als Nächstes Repositories.

Sobald Sie eine Verbindung zu Bitbucket Rechenzentrum hergestellt haben, können Sie eine Verknüpfung zu Repositories herstellen. Sie können diese Schritte später wiederholen, um bei Bedarf weitere Repositories zu verknüpfen.

Wählen Sie eine der folgenden Optionen aus, um Repository-Links für eine vorhandene Bitbucket Rechenzentrum-Verbindung zu erstellen:

Console

So erstellen Sie Links zu Repositories:

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

    Öffnen Sie die Seite Repositories.

  2. Klicken Sie auf Repository verknüpfen.

    Der Bereich Git-Repositories verknüpfen wird geöffnet.

  3. Wählen Sie in der Verbindungsliste eine Verbindung aus.

  4. Klicken Sie auf Weiter.

  5. Wählen Sie in der Liste der Repositories die Repositories aus, die Sie verknüpfen möchten.

    Developer Connect zeigt vorgeschlagene Namen für Ihre Repository-Ressourcen an.

  6. Wählen Sie eine Option für die Benennung von Repository-Ressourcen aus:

    • Generiert: Verwenden Sie die generierten Repository-Ressourcennamen.
    • Manuell: Geben Sie eigene Namen ein.
  7. Klicken Sie auf Erstellen.

    Developer Connect erstellt die Repository-Links und zeigt sie in der Google Cloud Console an.

gcloud

Erstellen Sie mit dem folgenden Befehl einen Link zu Ihrem Bitbucket Data Center-Repository:

gcloud developer-connect connections git-repository-links create REPO_NAME \
    --clone-uri=REPO_URI \
    --connection=CONNECTION_NAME \
    --location=REGION

Ersetzen Sie Folgendes:

  • REPO_NAME: ein Name für die neue Verknüpfung zwischen Developer Connect und Ihrem Bitbucket Rechenzentrum-Repository.
  • REPO_URI: die URL Ihres Repositorys in Bitbucket Rechenzentrum, einschließlich des Präfixes https:// und des Suffixes .git.
  • CONNECTION_NAME: der Name Ihrer Verbindung zu Bitbucket Data Center.
  • REGION: die Region Ihrer Verbindung.

Developer Connect erstellt die Repository-Links.

Führen Sie den Befehl developer-connect connections git-repository-linkslist aus, um verknüpfte Repositories aufzulisten.

Wenn Sie Gemini Code Assist einrichten, fahren Sie mit den Schritten unter Codeanpassung für Gemini Code Assist konfigurieren und verwenden fort.

Nächste Schritte