Bitbucket リポジトリのミラーリング

このトピックでは、Bitbucket リポジトリを Cloud Source Repositories にミラーリングする方法について説明します。この構成では、Bitbucket リポジトリに push した commit は、Cloud Source Repositories でホストされているリポジトリにコピー(ミラーリング)されます。

Cloud Source Repositories にミラーリングできるのは、Bitbucket Cloud リポジトリと GitHub Cloud リポジトリのみです。セルフホストの Bitbucket および GitHub ミラーリングはサポートされていません。

Bitbucket リポジトリを Cloud Source Repositories にミラーリングして Cloud Build と統合し、他の Cloud Source Repositories 機能を必要としない場合は、Bitbucket Cloud からのリポジトリの作成に関する Cloud Build の手順に沿って操作します。

始める前に

リポジトリをミラーリングするときは、Bitbucket 認証情報を指定する必要があります。この認証情報により、Cloud Source Repositories は Bitbucket リポジトリのコンテンツにアクセスできるようになります。

リポジトリのミラーリングなどの自動化タスク専用の Bitbucket アカウントを作成することをおすすめします。このアカウントにはリポジトリへの管理者権限が必要です。

Bitbucket リポジトリをミラーリングする

このセクションでは、Bitbucket リポジトリを Cloud Source Repositories にミラーリングする方法について説明します。

ミラーリングされたリポジトリを作成する

このプロセスで、Bitbucket リポジトリへの Google Cloud 読み取り権限を付与する際に、Bitbucket マシンのユーザー認証情報が必要になります。

  1. Google Cloud Console で、Cloud Source Repositories を開きます。

    Cloud Source Repositories を開く

  2. [リポジトリを追加] をクリックします。

    [リポジトリの追加] ページが開きます。

  3. [外部リポジトリの接続] を選択し、[続行] をクリックします。

    [外部リポジトリの接続] ページが開きます。

  4. [プロジェクト] プルダウン リストで、ミラーリングされたリポジトリが属する Google Cloud プロジェクトを選択します。

    プロジェクトがない場合は、[プロジェクトを作成] をクリックしてプロジェクトを作成します

  5. [Git プロバイダ] プルダウン リストで Bitbucket を選択します。

  6. チェックボックスをオンにして、Cloud Source Repositories が認証情報を格納することを承認します。

  7. [Bitbucket に接続する] をクリックします。

  8. マシンのユーザー認証情報で Bitbucket にログインします。

  9. [Google Cloud Platform を承認] をクリックします。

    このオプションを指定すると、リポジトリへの Google Cloud 読み取りアクセス権が付与されます。

    承認が完了すると、[外部リポジトリの接続] ページに戻ります。リポジトリのリストが開きます。

  10. リポジトリのリストから、ミラーリングするリポジトリを選択します。

  11. [選択したリポジトリを接続] をクリックします。

    リポジトリのメインページが開きます。このページには、この Google Cloud プロジェクトのリポジトリのリストが表示されます。新規に作成したリポジトリも表示されます。

Bitbucket リポジトリを特定する

Cloud Source Repositories では、Bitbucke リポジトリのミラーであるリポジトリを簡単に特定できます。

  • 各 Bitbucket リポジトリは Bitbucket ロゴで表されます。
  • リポジトリ名の先頭に bitbucket_ が追加されます。

Bitbucket 接続をアップグレードする

以前の GCP Console インターフェースで Bitbucket リポジトリをミラーリングした場合、現在の GCP Console でミラーリングされたリポジトリにアクセスすると、Cloud Source Repositories でのアップグレードを指示するプロンプトが表示されます。アップグレードが完了するまで、リポジトリにアクセスするたびに、このプロンプトが表示されます。

接続をアップグレードするには、Source Repository 管理者の役割が必要です。接続をアップグレードしても、Bitbucket リポジトリでのミラーリングの動作は変わりません。

  1. GCP Console で、Cloud Source Repositories を開きます。

    Cloud Source Repositories を開く

  2. ミラーリングされた Bitbucket リポジトリに移動します。

  3. メッセージが表示されたら、[認証情報をアップグレード] をクリックして接続をアップグレードします。

リポジトリの同期を強制的に行う

ミラーリングを設定すると、ユーザーが変更を commit したときに、Cloud Source Repositories はリポジトリをミラーリング先のリポジトリと自動的に同期します。ミラーリング先のリポジトリが最後に同期された時刻を参照できます。また、必要に応じて手動で強制的に同期を実行することもできます。

  1. GCP Console で、ミラーリングされた Bitbucket リポジトリを参照します。

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

    同期ステータスが表示されます。

    ミラーリングされたリポジトリの同期ステータス

  3. リポジトリの強制同期を手動で行うには、[Sync from Bitbucket] をクリックします。