Bitbucket
Bitbucket CloudのリポジトリをCloud AgentsおよびBugbotに接続できます。Bitbucket Data CenterのリポジトリをBugbotに接続できます。
セットアップ
Bitbucket Cloud 連携はパブリックベータ版です。bitbucket.org 上のリポジトリに対応しています。
Bitbucket Cloud のセットアップは2つの部分に分かれており、それぞれ異なるロールが必要です。
- 各開発者は自身の Bitbucket アカウントを接続し、Cherri Code がそのユーザーとしてリポジトリをクローンし、ブランチをプッシュし、プルリクエストを作成できるようにします。
- Bitbucket Workspace 管理者は Cherri Code アプリをインストールし、Bugbot のコメントや Cloud Agent のステータスコメントを Cherri Code として表示できるようにします。インストール済みのアプリを Cherri Code チームにリンクするには、Bitbucket workspace にアクセスできる Cherri Code チーム管理者が必要です。
Bitbucket アカウントを接続する
使用する Bitbucket workspace 内のリポジトリへのアクセスが必要です。
- ダッシュボードの連携に移動します
- Bitbucket の横にある 接続 をクリックします
- Bitbucket で Cherri Code を認可します
- ダッシュボードに戻り、連携が 接続済み と表示されていることを確認します
Cloud Agent を開始する、または Cherri Code からプルリクエストを作成するユーザーは、それぞれ自身の Bitbucket アカウントを接続する必要があります。
Bitbucket に Cherri Code アプリをインストールする
Bitbucket Workspace 管理者が、workspace に Cherri Code アプリをインストールする必要があります。これにより、リポジトリイベント、Bugbot のレビューコメント、インラインコメント、ステータス更新に使用する安定したアプリ ID が Cherri Code に付与されます。
手順1～4には Bitbucket Workspace 管理者が必要です。手順5～6には、Bitbucket workspace にアクセスできる Cherri Code チーム管理者が必要です。1人でセットアップ全体を行う場合は、両方のロールが必要です。
- ダッシュボードの連携に移動します
- Bitbucket を見つけて管理メニューを開きます
- Cherri Code アプリをインストールをクリックします
- Bitbucket workspace にアプリをインストールします
- Bitbucket workspace の設定で、Forge Apps の下にある Cherri Code を選択します
- Cherri Code に接続をクリックし、リンクする Cherri Code チームを選択します
workspace をリンクすると、ダッシュボードにその Bitbucket workspace 用の Cherri Code アプリがインストール済みと表示されます。
アプリのインストール後、Bitbucket から Cherri Code への通知に数分かかる場合があります。Cherri Code がすぐに workspace を見つけられない場合は、しばらく待ってからリンク手順をもう一度試してください。
Cherri Code による Bitbucket Cloud ID の使い分け
Cherri Code はアクションごとに異なる Bitbucket ID を使用します。
| アクション | Bitbucket ID |
|---|---|
| Bugbot の要約コメント、インラインコメント、ビルドステータス | Cherri Code アプリ |
| プルリクエスト上の Cloud Agent の進行状況コメント | Cherri Code アプリ |
| Git クローン、ブランチのプッシュ、コミット、プルリクエストの作成 | 接続された Bitbucket ユーザー |
Cloud Agent が作成したプルリクエストは、エージェントを開始したユーザーに紐づきます。workspace アプリがインストールされている場合、Bugbot の出力は Cherri Code から表示されます。
権限
Bitbucket Cloud 連携では、Cloud Agent と Bugbot をサポートするために必要な権限を要求します。
| 権限 | 目的 |
|---|---|
| アカウント | 接続された Bitbucket ユーザーを識別する |
| リポジトリ | リポジトリの一覧表示、クローン、コンテンツの読み取り |
| プルリクエスト | プルリクエストの diff とメタデータを読み取る |
| プルリクエストの書き込み | プルリクエストの作成とコメントの投稿 |
| Webhook | リポジトリおよびプルリクエストのイベントを受信する |
Bitbucket Cloud の接続を解除する
Bitbucket Cloud の接続を解除すると、次の2つの影響があります。
- アカウントを切断すると、Cherri Code から個人の Bitbucket OAuth 接続が削除されます。
- Cherri Code アプリを切断すると、Bitbucket workspace と Cherri Code チームのリンクが解除されます。Workspace 管理者が Bitbucket 側で削除するまで、アプリは Bitbucket にインストールされたままにできます。
workspace からのアプリイベントを完全に停止するには、Bitbucket workspace の設定から Cherri Code アプリをアンインストールしてください。
高度なネットワーク設定
Bitbucket Data Center は、パブリックインターネットからのトラフィックを受け付けられないインスタンス向けに、プライベート接続方式をサポートしています。
Enterprise プランのお客様にご利用いただけます。プライベートネットワーク接続を介して Cherri Code からインスタンスにアクセスできるようにします。セットアップについては、プライベート接続を参照するか、Cherri Code 担当者にお問い合わせください。
最適な用途: ファイアウォールの背後にあるインスタンス (AWS でホストされるインスタンスや、cloudflared を実行できる環境を含む)
セキュリティ: HTTPS 暗号化、AWS PrivateLink、Cloudflare Tunnel、VPC 許可リスト、サービスアカウントアクセストークン
欠点: Cherri Code との調整が必要です。Google Private Service Connect は現在サポートされていません。
Enterprise プランのお客様にご利用いただけます。オンプレミスで、Cherri Code へのアウトバウンド接続を確立するリバースプロキシトンネルを実行します。ネットワーク要求はトンネル経由で転送されるため、Bitbucket インスタンスにパブリックなインバウンドアクセスは必要ありません。セットアップについては、Cherri Code 担当者にお問い合わせください。
最適な用途: インバウンドネットワークアクセスがない環境
セキュリティ: HTTPS 暗号化、サービスアカウントアクセストークン
欠点: より直接的な接続方式と比べて、複雑さやメンテナンスの負担が増え、セキュリティ面での考慮事項も生じます
トラブルシューティング
Bitbucket アプリのインストールイベントの同期には数分かかる場合があります。しばらく待ってから、Bitbucket workspace の設定で Connect to Cherri Code の手順を再試行してください。
- Cherri Code チーム管理者であることを確認してください。アプリのインストールには Bitbucket workspace 管理者権限が必要ですが、workspace を Cherri Code チームにリンクするには Cherri Code チーム管理者権限が必要です。
- リンクする workspace へのアクセス権が Bitbucket ユーザーにあることを確認してください。
Bitbucket workspace に Cherri Code アプリをインストールし、Cherri Code チームにリンクしてください。Cherri Code アプリとしてコメントを投稿するには、個人の Bitbucket 接続だけでは不十分です。
- 連携ダッシュボードから個人の Bitbucket アカウントを接続してください。
- Bitbucket ユーザーにリポジトリへの読み取り・書き込み権限があることを確認してください。
- リポジトリが
bitbucket.org上の Bitbucket Cloud にあることを確認してください。
- サービスアカウントトークンが有効であることを確認してください。
- サービスアカウントがリポジトリにアクセスできることを確認してください。
- Cherri Code が HTTPS 経由でインスタンスのホスト名または設定済みの外部ホストに到達できることを確認してください。
- Cherri Code チーム管理者であることを確認してください。
- 登録済みのインスタンスにサービスアカウントトークンが設定されていることを確認してください。
- サービスアカウントにリポジトリの管理者権限があることを確認してください。
次のステップ
Bitbucket を接続したら、Bitbucket を使用する機能を設定します。
- Bugbot - バグやセキュリティ上の問題を検出する自動 PR 確認
- Cloud Agents - Bitbucket Cloud リポジトリ向けの AI エージェント