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

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

GitLab リポジトリと Devin を連携すると、Devin はマージリクエストを作成し、MR コメントを読み取って返信し、チームとの連携を効果的に行えるようになります。これにより、Devin はエンジニアリングチームにとって真のコラボレーターとして機能します。
セルフホスト型の GitLab インスタンスを利用していますか? Enterprise プランのユーザー向けに GitLab Self-Managed (バージョン 16.6 以降) をサポートしています。 “Connect” ボタンのドロップダウンをクリックし、Connect to self-hosted instance を選択するだけです。完全なセットアップ手順については、GitLab Self-Managed Integration ガイド を参照してください。Enterprise プランでは、同じドロップダウンに Connect service account もあり、以下の OAuth フローの代わりに、api スコープを持つパーソナルアクセストークンを用いて GitLab.com のサービスアカウント (Free ティアでは専用のユーザーアカウント) を接続できます。その他のプランでは、以下の OAuth フローで接続してください。

統合のセットアップ

セットアップは簡単です! 次の手順で始めましょう。
  1. Devin 専用の新しい GitLab アカウントを作成します (個人アカウントを作成するのと同じ要領です) 。統合の設定時には、このアカウントを使用し、個人アカウントは使用しません。
  2. Devin アカウントで Settings > Connections > GitLab に移動し、「Connect」をクリックします。
  3. GitLab にリダイレクトされるので、そこで次を実行します:
    • Devin 用に作成した GitLab アカウントでログインします (個人アカウントではありません)
    • Devin がリポジトリを操作できるように、必要な権限を付与します
  4. 完了すると Devin の設定ページに戻り、統合が有効になっていることを確認できます。
GitLab のオンプレミス (セルフホスト型) 環境では、MR (マージリクエスト) のステータス (open、merged、closed) が Devin のセッションへ同期されるのは 1 日に 1 回だけです。次回の同期が行われるまでの間、セッションやセッション一覧に表示される MR ステータスが一時的に実際の状態と異なる場合があります。

Webhook の設定

Webhook を設定すると、GitLab で特定のイベント (マージリクエストの作成や更新、マージリクエストへのコメントなど) が発生した際に、Devin がリアルタイム通知を自動で受信できるようになります。 Webhook を設定するには:
  1. Devin アカウントで Settings > Connections > GitLab に移動します
  2. 設定対象の GitLab 接続をクリックして、詳細パネルを開きます
  3. General タブで、Webhook 行の Configure をクリックします
  4. ダイアログから Webhook の URL と Secret Token をコピーします
  5. ダイアログに表示される Group (推奨) または Project の手順に従って GitLab に Webhook を追加し、トリガーとして Comments、Merge request events、Push events、Issues events、Pipeline events を選択します
GitLab で Webhook を追加するには、プロジェクトの Maintainer ロールが必要です。グループ Webhook の場合は、グループの Owner ロールが必要です (グループ Webhook は GitLab Premium および Ultimate で利用できます)。組織で Webhook の自動設定が利用可能な場合は、Devin の GitLab アカウントが管理権限を持つすべてのプロジェクトとグループに Devin が Webhook を設定する旨がダイアログに表示されます。手動の手順は、Devin がアクセスできないプロジェクトに対してのみ利用してください。
設定が完了すると、Devin は定期的なポーリングに依存せず、GitLab のイベントにリアルタイムで応答できるようになります。

リポジトリの権限

Core および Teams ユーザー向け

統合の設定が完了すると、Devin のWebアプリ内のプロンプトでリポジトリを直接 @メンションできます。

Enterprise ユーザー向け

統合を設定すると、Settings > Repositories から、特定の組織にリポジトリを割り当てることができます。
  1. ページ上部のドロップダウンから組織を選択します
  2. Manage permissions をクリックします
  3. Read & write または Read only のアクセス権で、該当するグループまたはリポジトリを追加します
詳細は リポジトリの権限 を参照してください。
接続後すぐにリポジトリが表示されない場合は、Devin が定期的にリポジトリ一覧を更新します。Devin では、リポジトリ一覧を手動で更新することもできます。

ユーザーのリンク

組織全体の接続に加えて、個々のユーザーが自分の GitLab アカウントを Devin にリンクすることもできます。これにより、GitLab の操作を Devin がそのユーザーの ID で実行できるようになります。たとえば、Settings > Devin > Pull requests で Open PRs as を User または User only に設定している場合、リンクされたユーザーとしてマージリクエストを作成します。 個人の GitLab アカウントをリンクするには:
  1. GitLab 統合が設定済みの Devin 組織のメンバーであることを確認します
  2. 個人のアカウント設定で Settings > Connections を開きます
  3. GitLab の行を探して Link をクリックし、GitLab の認可を完了します
Personal Connections には、ユーザーが所属する組織の統合のみが表示されます。 GitLab の行は、組織に GitLab.com への接続がある場合に表示されます。セルフホスト型の GitLab インスタンス (Enterprise プラン) は、ホスト名がラベルとして付いた別の Self-hosted GitLab の行として表示され、リンク方法は同じです。GitLab の行が表示されない場合は、GitLab 接続のある Devin 組織のメンバーであるかどうかを確認してください。

GitLab 統合での Devin の利用

GitLab を接続したら、Devin’s Machine でリポジトリをセットアップしてください。
Devin が MR コメントに応答する仕組み。 webhook を設定すると、Devin セッションが追跡しているマージリクエストへのコメントが、そのセッションにリアルタイムで配信されます。デフォルトでは、これによってスリープ中のセッションが復帰し、Devin がコメントに応答します。この動作を制限するには、組織の管理者が Settings > Devin > Pull requests で Require @Devin to respond を有効にします。この設定を有効にすると、Devin は @Devin で始まるコメント、または Devin fix this のように独立した単語の Devin で始まるコメントにのみ復帰して応答します (devinai プレフィックスも使用できます) 。マッチングでは大文字と小文字は区別されません。(aside) または !aside を含むコメント、あるいは aside で始まるコメントは、この設定に関わらず常に無視されるため、Devin を復帰させずに MR について議論できます。webhook がない場合、MR コメントはセッションにリアルタイムで配信されません。ただし、セッション内で直接指摘すれば、Devin はそれらに対応できます。

MR コメントから Devin を起動する

GitLab から離れずに Devin に作業を任せられます。Devin に接続されたリポジトリでオープン状態のマージリクエストに、/devin で始まり、その後に依頼内容を続けたコメントを投稿します:
Devin はそのリポジトリで新しいセッションを開始し、MR を前提情報として利用したうえで (必要に応じて MR を引き継ぎます) 、セッションへのリンクを MR に返信します。 要件:
  • Webhook — Devin が MR コメントを受信できるよう、webhook を設定しておく必要があります。
  • コメントの先頭に記述 — コマンドは新しいコメントの先頭に記述する必要があります。大文字・小文字は区別されず、MR のディスカッションコメントとインライン diff コメントのどちらでも機能します。
  • オープン中の MR のみ — クローズ済みまたはマージ済みの MR へのコメントは無視されます。
  • Developer ロール以上 — コメントするユーザーには、プロジェクトで Developer 以上のロールが必要です。
  • アカウントのリンク — コメントするユーザーの GitLab アカウントが Devin アカウントにリンクされており、かつリポジトリへのアクセス権を持つ Devin 組織のメンバーである必要があります。セッションを開始するには、Devin セッションを利用する権限も必要です。
その MR ですでに Devin セッションが作業中の場合、/devin <prompt> コメントは新しいセッションを開始せず、既存のセッションに送信されます。

ベストプラクティス

  • Devin 用の専用 GitLab アカウントを作成する
  • main/master ブランチにブランチ保護を有効にする
  • リアルタイムでイベント通知を受け取れるように webhook を設定する

サポート

  1. app.devin.ai/settings/support で弊社チームとの Slack Connect チャンネルを作成してください
  2. 問題を報告する際はセッションのリンクを共有し、スクリーンショットを添付してください