メインコンテンツへスキップ

なぜ Devin を Bitbucket と連携するのか?

Devin を Bitbucket リポジトリと連携すると、Devin はプルリクエストを作成し、PR コメントを読み取って返信し、チームと効果的に協働できるようになります。これにより、Devin はエンジニアリングチームの真のコラボレーターとして活躍できます。

前提条件

Bitbucket 連携をセットアップする前に、次の準備を行うことをお勧めします。
  • 専用のサービスアカウント - 既存のユーザーアカウントではなく、Devin 専用の新しい Bitbucket アカウント (例: devin@yourcompany.com) を作成し、アクセス管理と監査証跡をより明確に保つ
専用のサービスアカウントを使用することで、Devin のアクティビティを追跡しやすくなり、権限管理を行いやすくなり、組織全体でセキュリティのベストプラクティスを維持しやすくなります。

インテグレーションの設定

Bitbucket Cloud

Bitbucket Cloud の接続には2種類あります。Devin に何をさせたいかに応じて選択してください。 「Devin 自身による書き込み」とは、Devin が作成するプルリクエスト、および Devin Review が投稿する検出結果や説明の更新を指します。Devin Review であなた自身が行う操作 (コメント、返信、プルリクエストの却下) は、どちらの接続方式でも、あなたがリンクした Bitbucketアカウントからあなたの名前で投稿されます。詳しくは Devin Review を参照してください。
Devin Review の自動レビューに必要な Webhook は、どちらの接続方式でも Devin が自動でインストールします。ただし、接続にリポジトリの管理権限がある場合に限ります。具体的には、Webhooks: Read and write と Repositories: Admin の権限を持つアクセストークン、またはリンクした Bitbucketアカウントがリポジトリ管理者である OAuth 接続が必要です。管理権限がない場合、そのリポジトリは接続の Webhook ステータスに Bitbucket が示す理由とともに Skipped と表示され、レビューはあなたが Devin Review でプルリクエストを自分で開いたときにのみ実行されます。

アクセストークンで接続する

  1. Bitbucket で、Devin に作業させるワークスペースの ワークスペースアクセストークン を作成し、次のスコープを付与します。
    • Repositories: Admin
    • Pull requests: Write
    • Webhooks: Read and write
    これより狭いスコープでは、Devin はマージ状態の読み取りや Webhook のインストールを行えません。
  2. Devinアカウントで 設定 > 接続 > Bitbucket に移動し、Connect ボタンの横にあるドロップダウンを開いて、Connect with access token を選択します。
  3. ワークスペース ID (bitbucket.org/my-workspace の my-workspace の部分) とトークンを入力し、Connect をクリックします。
Devin はこのワークスペースでこのトークンを利用し、あなたではなくトークンの名義で投稿します。接続がアクティブになると、Devin がワークスペースのリポジトリに Webhook を自動でインストールします。接続の詳細パネルには、リポジトリごとの結果と、インストールを再実行するための Refresh ボタンが表示されます。

OAuth で接続する

ワークスペースが Bitbucket Cloud Premium でない場合は、OAuth を使用します。OAuth 接続は、リンクしたアカウント自体の Bitbucket 認可に基づきます。そのため、Devin 自身による書き込み (Devin が作成するプルリクエストや、Devin Review が投稿する検出結果および説明の更新) はそのアカウントによるものとして表示されます。また、Webhook はそのアカウントが管理者権限を持つリポジトリにのみインストールされます。以下の手順で最初に専用の Bitbucket アカウントを作成するのはこのためです。組織用の接続に、個人のアカウントを決してリンクしないでください。Devin の Bitbucket アプリが Webhook を管理できるようになる前にリンクされた接続では、その接続を置き換えるまで、リポジトリが Skipped と表示されます。
  1. Devin 専用の新しい Bitbucket アカウントを作成します (個人アカウントを作成するのと同じ要領です) 。統合の設定中は、個人アカウントではなく、このアカウントを使用します。
  2. Devin アカウントで Settings > 接続 > Bitbucket にアクセスし、「Connect」をクリックします。
Bitbucket Cloud を接続
  1. Bitbucket にリダイレクトされるので、そこで次を行います:
    • Devin 用に作成した Bitbucket アカウントでログインします (個人アカウントではないことを確認)
    • Devin がリポジトリを操作できるように、必要な権限を付与します
  2. 完了すると、Devin の設定ページに戻り、統合が有効になっていることを確認できます。

古いOAuth接続を置き換える

OAuth接続は、リンクした時点の権限をそのまま保持します。そのため、DevinのBitbucketアプリがwebhookを管理できるようになる前にリンクされた接続では、リポジトリが Skipped と表示され、webhookのステータスに再接続を求めるメッセージが表示されます。既存の接続をそのまま再接続することはできません。もう一度接続すると同じ名前の接続がもう1つ追加され、元の接続は Skipped のままになります。代わりに、次の手順で古い接続を置き換えてください。
  1. 接続の詳細パネルを開き、リポジトリの権限や Manage access など、その接続で変更した設定を控えておきます。これらの設定は新しい接続には引き継がれません。
  2. General タブで Disconnect connection をクリックします。次のステップが完了するまで、Devinはこれらのリポジトリにアクセスできなくなります。
  3. Settings > 接続 > Bitbucket で Connect with access token の横にあるドロップダウンを開き、Connect with OAuth (any Bitbucket plan) を選択して、同じBitbucketアカウントでログインします。
  4. ステップ1で控えた設定を再度適用します。新しい接続には、リンクしたアカウントが参照できるすべてのワークスペースへのアクセス権が最初から付与されます。エンタープライズアカウントの場合は組織へのアクセス権がない状態で作成されるため、改めて組織に権限付与してください。
その後、Devinがwebhookを自動でインストールし、新しい接続の詳細パネルに各リポジトリの結果が表示されます。 すでにもう一度接続してしまった場合は、同じ名前の接続が2つ存在しています。両方の設定を控えてから両方とも切断し、ステップ3と4の手順で一度だけ接続し直してください。

Bitbucket Data Center

Bitbucket Data Center (セルフホスト) を利用している組織の場合は、次の手順に従ってください。
  1. Bitbucket Data Center インスタンス内に、Devin 用の専用サービスアカウントを作成します。
  2. Devin アカウントで Settings > Connections > Bitbucket に移動し、Connect ボタンの横にあるドロップダウンを開いて、Connect with Bitbucket Data Center を選択します。
Bitbucket Data Center を接続
  1. 接続設定で、次の情報を入力します。
    • Bitbucket Host: Bitbucket Data Center のドメイン (例: bitbucket.mycompany.com)
    • Bitbucket Username: サービスアカウントのユーザー名
    • Bitbucket HTTP Access Token: サービスアカウント用に作成した HTTP アクセストークン。後から接続の詳細パネルにある Rotate access token で差し替えることもできます。
Bitbucket Data Center の構成
  1. Bitbucket Data Center インスタンス内で、そのサービスアカウントに適切なプロジェクトおよびリポジトリ権限を付与します。
  2. 設定が完了すると、Devin の設定画面で統合ステータスが有効として表示されます。

Webhook の設定 (Bitbucket Data Center)

Webhook を設定すると、Devin が Bitbucket Data Center からプルリクエストのイベントをリアルタイムに受信できるようになり、PR のステータスやコメントが、その PR に取り組んでいる Devin セッションに届きます。
  1. Devin アカウントで Settings > 接続 > Bitbucket を開き、Bitbucket Data Center の接続をクリックして詳細パネルを表示します。
  2. General タブで、Webhook の行にある Configure をクリックします。ダイアログに Webhook URL とシークレットトークンが表示されます。トークンは一度しか表示されないため、ここでコピーしておいてください (後から同じダイアログで再生成できます) 。
  3. Bitbucket Data Center でリポジトリまたはプロジェクトの設定を開き、Webhooks に移動します。
  4. Webhook を作成し、Webhook URL を貼り付けます。
  5. Pull request イベントから、Opened、Source branch updated、Merged、Declined、Comment added を選択します。
  6. Authentication では Basic を選択し、ユーザー名には任意の値を入力して、パスワードにシークレットトークンを貼り付けます。
Bitbucket Cloud の接続には Webhook のダイアログはありません。アクセストークンによる接続の場合、またはリンクされた Bitbucket アカウントがリポジトリの管理者である OAuth 接続の場合は、Devin が Webhook を自動でインストールします。
デフォルトでは、Devin が Bitbucket Data Center 上で行うすべての操作はサービスアカウントによるものとして記録されます。自身のアカウントをリンクすると、Devin Review から自分の名義でコメントの投稿、レビュアーの追加・削除、PR の承認・却下を行えます。 管理者によるセットアップ (Bitbucket Data Center ホストごとに 1 回) :
  1. Devin で Settings > Connections > Bitbucket に移動し、Bitbucket Data Center user OAuth の下にある Register app をクリックします。ダイアログに、使用するリダイレクト URL と権限が表示されます。
  2. Bitbucket Data Center で Administration > Application links に移動し、Create link を選択して、External application と Incoming を選びます。リダイレクト URL を貼り付け、Repositories: Write 権限を付与します。
  3. アプリケーションのクライアント ID とクライアントシークレットを Devin のダイアログに貼り付け、Register をクリックします。
各ユーザー: Devin Review でリンクを求められた際に、またはプロフィールのリンク済みアカウントから、Bitbucket アカウントをリンクします。
Devin で登録済みのアプリケーションを削除すると、そのホスト上のすべてのユーザーの Bitbucket Data Center アカウントのリンクが解除されます。

Bitbucket 統合で Devin を使う

Bitbucket を接続したら、Devin’s Machine でリポジトリをセットアップしてください。
Devin が PR コメントにどう応答するか
  • Bitbucket Cloud: Devin は自身のプルリクエストへのコメントでは自動的に起動しません。セッション内で直接伝えれば、Devin はそのコメントに対応できます。Cloud 接続で Devin がインストールする webhook は、セッションではなく Devin Review で使用されます。
  • Bitbucket Data Center: webhook を設定すると、Devin セッションが追跡しているプルリクエストへのコメントがそのセッションに配信され、Devin が応答します。組織の管理者は Settings > Devin > Pull requests の Require @Devin to respond でこれを制限でき、その場合 Devin は @Devin で始まるコメント、または Devin fix this のように独立した単語の Devin で始まるコメントにのみ応答します (devinai プレフィックスも使用できます) 。(aside) または !aside を含むコメント、あるいは aside で始まるコメントは常に無視されます。webhook を設定していない場合、Data Center の動作は Bitbucket Cloud と同じです。

ベストプラクティス

  • Devin 専用の Bitbucket アカウントを作成する
  • main/master ブランチに対してブランチ保護を有効にする
  • サービス アカウントに適切なワークスペースおよびリポジトリ権限を付与する
  • Bitbucket Cloud では、OAuth で接続する際に Devin 用に作成した Bitbucket アカウント (リポジトリ管理者) をリンクする。Devin はリンクしたアカウントとしてコメントなどを投稿する
  • Bitbucket Data Center では、Devin が PR イベントをリアルタイムに受信できるように Webhook を設定する