Bitbucket データセンターに接続する

このページでは、Bitbucket データセンターへの接続を作成し、Bitbucket データセンター リポジトリへのリンクを作成する方法について説明します。これらのタスクは、 Google Cloud コンソールまたは Google Cloud CLI を使用して完了できます。

これらの手順は、Google で Bitbucket Data Center ソースコード リポジトリを使用するアプリケーション デベロッパー、プラットフォーム管理者、セキュリティ管理者を対象としています。具体的には、Gemini Code Assist で Bitbucket データセンター リポジトリを使用できます。

Developer Connect の詳細については、Developer Connect の概要をご覧ください。

始める前に

  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. Bitbucket データセンターのアカウントにアクセスできることを確認します。

    チームの作業を安全に保つため、このガイドのタスクは、個人アカウントではなく、bot アカウントまたはチームで共有するアカウントを使用して完了することをおすすめします。

  5. Bitbucket Data Center リポジトリを所有しているか、共有リポジトリに対する管理者レベルの権限があることを確認します。
  6. 省略可: Developer Connect が作成する認証シークレットを暗号化するための顧客管理の暗号鍵(CMEK)を作成します。
  7. 省略可: このガイドのコマンドラインの手順を使用するには、次の操作を行います。
    1. Google Cloud CLI をインストールする。 すでに gcloud CLI をインストールしている場合は、gcloud components update を実行して、最新のバージョンがインストールされていることを確認してください。
    2. 次のコマンドを実行して、Developer Connect サービス アカウントを作成します。ここで、PROJECT_ID は Google Cloud プロジェクト ID です。
              gcloud beta services identity create \
                  --service=developerconnect.googleapis.com \
                  --project=PROJECT_ID
              

必要なロール

接続とリンクの作成に必要な権限を取得するには、管理者に次の IAM ロールを付与するよう依頼してください。

  • プロジェクト オーナーでない場合: ユーザー アカウントの Developer Connect 管理者(roles/developerconnect.admin)。
  • CMEK を使用して Developer Connect が作成するシークレットを暗号化する場合: Secret Manager サービス アカウントに対する Cloud KMS CryptoKey の暗号化 / 復号(roles/cloudkms.cryptoKeyEncrypterDecrypter)。
  • gcloud CLI を使用してこのガイドの手順を完了する予定がある場合: Developer Connect サービス アカウントの Secret Manager 管理者ロール(roles/secretmanager.admin)。
  • Google Cloud コンソールを使用してこのガイドの手順を完了する予定の場合: ユーザー アカウントに対するプロジェクト IAM 管理者(roles/resourcemanager.projectIamAdmin)。

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

アクセス トークンを作成する

次の手順で、Bitbucket データセンターに個人用アクセス トークンを作成します。

  1. Bitbucket データセンターにログインします。

  2. Bitbucket データセンターのドキュメントの手順に沿って 2 つの HTTP アクセス トークンを作成し、次のスコープを付与します。

    Developer Connect は、ユーザー、プロジェクト、リポジトリのアクセス トークンをサポートしています。

    • repository admin スコープで 1 つのトークンを作成します。Developer Connect では、このトークンは管理者アクセス トークンと呼ばれます。
    • repository read スコープで 1 つのトークンを作成します。Developer Connect では、このトークンは読み取りアクセス トークンと呼ばれます。

    Bitbucket データセンターのトークンの有効期間は、Bitbucket データセンターで管理する必要があります。ソースコードを保護するため、トークンの作成時に有効期限を設定できます。有効期限を設定しない場合、トークンは Bitbucket データセンターで取り消すまで有効です。

  3. 次の手順で使用するためにアクセス トークンをコピーします。

接続を作成する

このセクションでは、Developer Connect と Bitbucket Data Center の間に接続を作成する方法について説明します。 Google Cloud コンソールを使用している場合は、接続の設定が完了すると、リポジトリへのリンクの追加を開始することもできます。

新しい Bitbucket データセンター接続を作成するには、次のいずれかのオプションを選択します。

コンソール

次の手順で接続を開始します。

  1. Google Cloud コンソールで Developer Connect を開きます。

    Developer Connect に移動

    Developer Connect に [Git リポジトリ] ページが表示されます。

    • ソースコード管理プロバイダのリストが表示された場合: ソースコード管理プロバイダを選択して、最初の接続の構成を開始します。[Bitbucket Data Center] カードの [接続] をクリックします。
    • 既存の接続を一覧表示するテーブルが表示されている場合: [接続を作成] > [Bitbucket Data Center] をクリックして、ソースコード管理プロバイダを設定します。

      [接続を作成] ページが開きます。

  2. [リージョン] で、接続リソースのリージョンを選択します。

    1. [名前] に、新しい接続の名前を入力します。
  3. [ホスト URL] に、接続する Bitbucket データセンター ホストの URL を入力します。

  4. [アクセス トークン] セクションで、Bitbucket データセンターのアクセス トークンを入力します。

    • 管理者アクセス トークン: リポジトリ管理者スコープ アクセスを持つトークンを入力します。

    • 読み取りアクセス トークン: リポジトリ読み取りスコープ アクセスを持つトークンを入力します。

  5. [Show more] をクリックして、オプションの構成設定を表示します。

    1. 省略可: デフォルトでは、Developer Connect は Bitbucket Data Center への Git 呼び出しのプロキシとして機能します。このオプションを無効にするには、[Developer Connect プロキシを有効にする] チェックボックスをオフにします。

    2. 省略可: [暗号化] セクションで、Developer Connect が作成する Secret Manager のシークレットを暗号化する CMEK 鍵を選択します。

  6. [続行] ボタンをクリックします。Developer Connect が接続を作成します。この処理には数秒かかることがあります。

接続が作成されると、[リポジトリをリンク] ページが表示されます。

リポジトリを接続にリンクする手順は次のとおりです。

  1. 使用可能なリポジトリのリストで、使用するリポジトリを選択します。

  2. [OK] をクリックします。

  3. [リンク] をクリックします。

接続が [接続] ページに追加され、リポジトリ リンクが Google Cloud コンソールの [リポジトリ] ページに追加されます。既存の接続にリンクを追加することはいつでも可能です。

Gemini Code Assist を設定する場合は、Gemini Code Assist のコードのカスタマイズを構成して使用するの手順に沿ってプロセスを続行します。

gcloud

  1. 次のコマンドを実行して、Secret Manager で Webhook シークレットを作成します。ここで、WEBHOOK_SECRET_NAME は Webhook シークレットの名前です。

    cat /proc/sys/kernel/random/uuid | tr -d '\n' | gcloud secrets create WEBHOOK_SECRET_NAME
    
  2. 次のコマンドを実行して、Secret Manager にアクセス トークンを保存します。

    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=-
    

    次のように置き換えます。

    • ADMIN_SECRET_NAME: 管理者権限アクセス トークンを保存するシークレットの名前。
    • ADMIN_SECRET_DATA: 管理者アクセス トークン。
    • READ_SECRET_NAME: 読み取りアクセス トークンを保存する Secret の名前。
    • READ_SECRET_DATA: 読み取りアクセス トークン。
  3. gcloud developer-connect connections create コマンドを実行して、Bitbucket データセンターへの接続を作成します。

    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
    

    次のように置き換えます。

    • CONNECTION_NAME: 接続の名前。
    • REGION: 接続に使用するリージョン。
    • HOST_URI: https:// 接頭辞を含む Bitbucket データセンター ホストの URI。
    • PROJECT_ID: Google Cloudのプロジェクト ID。
    • ADMIN_SECRET_NAME: 管理者アクセス トークンを含む Secret Manager の Secret の名前。
    • READ_SECRET_NAME: 読み取りアクセス トークンを含む Secret Manager の Secret の名前。
    • WEBHOOK_SECRET_NAME: Webhook シークレットを含む Secret Manager のシークレットの名前。
    • VERSION: 各シークレットのバージョン番号。最新のバージョン番号を使用するには、latest を指定します。
    • --git-proxy-config-enabled: Developer Connect が Bitbucket Data Center への Git 呼び出しのプロキシとして機能できるようにするオプションのフラグ。

    Developer Connect が Bitbucket データセンターへの接続を完了します。次に、リポジトリにリンクします。

Bitbucket データセンターへの接続を確立したら、リポジトリにリンクできます。必要に応じて、後でこれらの手順を繰り返して追加のリポジトリをリンクできます。

既存の Bitbucket データセンター接続にリポジトリ リンクを作成するには、次のいずれかのオプションを選択します。

コンソール

リポジトリへのリンクを作成するには、次の手順を完了します。

  1. Google Cloud コンソールで [リポジトリ] ページを開きます。

    [リポジトリ] ページを開く

  2. [リポジトリをリンクする] をクリックします。

    [Git リポジトリをリンク] ペインが開きます。

  3. 接続リストで接続を選択します。

  4. [続行] をクリックします。

  5. リポジトリ リストで、リンクするリポジトリを選択します。

    Developer Connect に、リポジトリ リソースの推奨名が表示されます。

  6. リポジトリ リソースの命名オプションを選択します。

    • 生成済み: 生成されたリポジトリのリソース名を使用します。
    • 手動: 独自の名前を入力します。
  7. [作成] をクリックします。

    Developer Connect がリポジトリ リンクを作成し、 Google Cloud コンソールに表示します。

gcloud

次のコマンドを実行して、Bitbucket データセンター リポジトリへのリンクを作成します。

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

次のように置き換えます。

  • REPO_NAME: Developer Connect と Bitbucket データセンター リポジトリ間の新しいリンクの名前。
  • REPO_URI: Bitbucket データセンター内のリポジトリの URL(https:// 接頭辞と .git 接尾辞を含む)。
  • CONNECTION_NAME: Bitbucket データセンターへの接続の名前。
  • REGION: 接続のリージョン。

Developer Connect がリポジトリ リンクを作成します。

リンクされたリポジトリを一覧表示するには、developer-connect connections git-repository-linkslist コマンドを実行します。

Gemini Code Assist を設定する場合は、Gemini Code Assist のコードのカスタマイズを構成して使用するの手順に沿ってプロセスを続行します。

次のステップ