Skip to main content

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

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

​
前提条件

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

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

​
Bitbucket Cloud

セットアップは簡単です！ 次の手順で始めましょう。
  1. Devin 専用の新しい Bitbucket アカウントを作成します (個人アカウントを作成するのと同じ要領です) 。統合の設定中は、個人アカウントではなく、このアカウントを使用します。
  2. Devin アカウントで Settings > Connections > Bitbucket にアクセスし、「Connect」をクリックします。
Bitbucket Cloud を接続
  1. Bitbucket にリダイレクトされるので、そこで次を行います：
    • Devin 用に作成した Bitbucket アカウントでログインします (個人アカウントではないことを確認)
    • Devin がリポジトリを操作できるように、必要な権限を付与します
  2. 完了すると、Devin の設定ページに戻り、統合が有効になっていることを確認できます。

​
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 > Connections > 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 を選択し、ユーザー名には任意の値を入力して、パスワードにシークレットトークンを貼り付けます。
Webhook は Bitbucket Data Center の接続でのみ利用できます。Bitbucket Cloud の接続に 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 はそのコメントに対応できます。
  • 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 Data Center では、Devin が PR イベントをリアルタイムに受信できるように Webhook を設定する