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

​
概要

このガイドでは、GitLab インスタンスを Devin と統合するための完全なセットアップ手順について、管理者向けセットアップとエンドユーザー向けセットアップの両方を含めて説明します。 この統合は 2 つのパートで構成されています。
  1. Admin setup
    • 組織のセルフホスト型 GitLab インスタンスを Devin に接続する
    • サービスアカウントを設定する
    • リポジトリへのアクセスを構成する
    • ユーザーが個人の GitLab アカウントをリンクできるように OAuth を登録する
  2. User setup
    • 各ユーザーの GitLab アカウントを、そのユーザーの Devin アカウントにリンクする
いずれのユーザーも GitLab アカウントをリンクする前に、管理者向けセットアップを完了しておく必要があります。管理者向けセットアップの手順を実行できるのは Enterprise Admin のみです。

​
パート1: 管理者の設定

​
Step 1: GitLabでサービスアカウントを作成する

GitLabで以下を行います。
  1. 該当するGitLabグループに移動します
  2. 設定に移動します
  3. Service Accountsを開きます
  4. 新しいサービスアカウントを作成します
Devinはこのサービスアカウントを使用して、GitLabのリポジトリにアクセスします。
GitLabでサービスアカウントを作成する

​
ステップ 2: サービスアカウントをグループメンバーとして追加する

引き続き、GitLab で操作します。
  1. グループのメンバーページを開きます
GitLab グループのメンバーページ
  1. サービスアカウントをグループメンバーとして追加します
  2. Developer ロールを付与します
これは、サービスアカウントがリポジトリに適切にアクセスするために必要です。

​
ステップ 3: サービスアカウント用のパーソナルアクセストークンを生成する

サービスアカウントを作成したら、次の手順を実行します。
  1. 新しく作成したサービスアカウントを見つけます
  2. 三点メニュー > アクセストークンを管理 > 新しいパーソナルアクセストークンを生成 の順にクリックし、アクセ ススコープで api を選択します
  3. そのトークンをコピーして、安全に保管します
ユーザー設定にあるご自身のパーソナルアクセストークンではなく、サービスアカウントのトークンを選択していることを確認してください。Devin にはご自身ではなくサービスアカウントとして動作させる必要があります。このトークンは、Devin で GitLab 接続を追加する際に利用します。

​
ステップ4: Devin に GitLab 接続を追加する

Devin で:
  1. Enterprise Settings に移動します
  2. Connections を開きます
  3. 新しい接続を追加します
  4. 次を入力します:
    • セルフホスト型 GitLab の URL (該当する場合)
GitLab 接続 URL を追加
  • サービスアカウント用に作成したパーソナルアクセストークン
これで、エンタープライズレベルの GitLab 接続が作成されます。

​
ステップ 5: Webhook を設定する

Webhook を設定すると、GitLab で特定のイベントが発生したとき (たとえば、マージリクエストの作成や更新、マージリクエストへのコメントなど) に、Devin がリアルタイム通知を自動で受け取れるようになります。 Webhook を設定するには、次の手順に従います。
  1. Enterprise Settings > Connections で、先ほど追加した GitLab インスタンスを探します
  2. Manage ドロップダウンをクリックします
  3. Configure Webhook を選択します
  4. 表示されるコマンドに従って設定を完了します
Webhook を設定する
設定が完了すると、Devin は定期的なポーリングではなく、GitLab のイベントにリアルタイムで応答できるようになります。

​
Step 6: リポジトリへのアクセスを確認する

接続を追加したら、次の点を確認します。
  1. サービスアカウントが、利用したいリポジトリにアクセスできることを確認します
  2. Devin でリポジトリがすぐに表示されない場合は、リポジトリ一覧を手動で更新します
  3. Enterprise Repositories に移動します
  4. 正しい組織を選択します
Enterprise Repositories
  1. Manage Permissions を開きます
  2. 該当するリポジトリを、適切な read/write 権限で追加します
Manage repository permissions
リポジトリが表示されない場合、Devin はリポジトリ一覧を即時ではなく定期的に更新するため、反映までに時間がかかっている可能性があります。

​
パート2: セルフホスト型GitLabでユーザー連携を有効にする

​
ステップ 7: セルフホスト型 GitLab インスタンスで OAuth アプリケーションを登録する

各ユーザーが自分の GitLab アカウントを Devin に連携できるようにするには、管理者がそのセルフホスト型 GitLab インスタンス用の OAuth アプリを登録する必要があります。 Devin で次を実行します:
  1. Enterprise の GitLab 接続画面に移動します
  2. Advanced を開きます
  3. セルフホスト型 GitLab セクションに移動します
  4. register an OAuth application のフローを開始します
OAuth アプリケーションを登録する

​
Step 8: GitLab で OAuth App Registration を完了する

登録モーダル内のリンクから GitLab のアプリケーション登録フォームを開きます。以下のとおりに各項目を入力してください。
  1. Name と Redirect URI を、Devin のモーダルに表示されているとおり正確に設定します
  2. Confidential チェックボックスを有効にします
  3. api スコープを選択します
  4. Save application をクリックします
GitLab OAuth アプリ設定
  1. GitLab で Application ID と Application Secret をコピーします
  2. Devin に戻り、それらの値を登録モーダルに貼り付けます
  3. Register をクリックします
これで、ユーザーの ID 連携に必要な管理者側の設定は完了です。

​
パート3: 組織への所属要件

​
ステップ 9: ユーザーが正しい Devin 組織に所属していることを確認する

ユーザーが GitLab アカウントをリンクするには、事前に GitLab リポジトリ権限を持つ Devin 組織のメンバーである必要があります。 Devin で、次の操作を行います。
  1. 組織への所属画面に移動する
  2. ユーザーが GitLab リポジトリ権限を持つ Devin 組織に所属していることを確認する
  3. 所属していない場合は、先に追加する
Personal Connections には、ユーザーが所属している組織の統合のみが表示されます。 ユーザーが GitLab リポジトリ権限を持つ Devin 組織に所属していない場合、GitLab 統合がまったく表示されないことがあります。

​
パート4：エンドユーザーの設定

​
ステップ 10: Personal Connections を開く

Devin のエンドユーザーとして、次の操作を行います。
  1. Personal Connections に移動します
  2. セルフホスト型 GitLab 統合を探します
表示されない場合は、まず組織への所属を確認してください。
統合が表示されたら、次の操作を行います。
  1. セルフホスト型 GitLab 接続を選択します
  2. 連携フローを完了します
  3. ユーザーの GitLab アカウント をその Devin アカウント に連携します
これで、Devin は GitLab の操作をそのユーザーとして実行できるようになります。