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

​
概要

このガイドでは、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 接続が作成されます。

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

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

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

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

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

​
Step 7: 手動セットアップの手順を利用する

このフローでは、複数のセットアップオプションが表示される場合があります。手動のUIフローでは、以下の手順に従ってください。
  • GitLabの画面から直接OAuthアプリを作成します
手動でのOAuth設定

​
ステップ 8: GitLab で OAuth アプリ登録を完了する

GitLab で OAuth アプリを作成する際は、次の手順を実行します。
  1. 登録ページを開く
  2. アプリの設定を確認する
  3. 次の必須設定を確認する:
    • Confidential (既定でチェックされている場合)
    • API アクセス / スコープ
  4. アプリケーションを登録する
  5. Application ID をコピーする
  6. Application Secret をコピーする
  7. Devin に戻り、求められた箇所にそれらの値を入力する
これで、ユーザー 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 の操作をそのユーザーとして実行できるようになります。