GitHub Enterprise Server 統合

Documentation Index

Fetch the complete documentation index at: https://docs.devin.ai/llms.txt

Use this file to discover all available pages before exploring further.

1. GitHub App (推奨) — 専用の GitHub App を GHES または GHEC インスタンスに登録してインストールします。この方法では、セットアップをスムーズに進められ、パーソナルアクセストークンを管理する必要もありません。
2. パーソナルアクセストークン (PAT) — サービスアカウントを作成し、きめ細かい権限設定が可能なパーソナルアクセストークンを生成します。この方法は、すべての GHES バージョンで利用できます。

1. App Registration — GHES または GHEC インスタンスで GitHub App を登録します。各インスタンスにつき必要な App 登録は 1 つだけです。
2. App Configuration — GHES または GHEC インスタンスで、登録した App を設定します (例: 公開に設定し、トークンの有効期限を無効化します) 。
3. App Installation — Devin がアクセスする必要がある各 GitHub 組織に、登録した App をインストールします。組織ごとに 1 つのインストールが必要です。

• Git 権限の管理権限を持つ Devin ユーザー
• App を登録する GitHub 組織でのオーナーまたは管理者アクセス権

1. Devin アカウントで、Enterprise Settings → 統合 → GitHub に移動します。
2. Advanced セクションを展開して、GitHub Enterprise オプションを表示します。

3. Register App をクリックします。
4. 表示されるモーダルで、GHES または GHEC インスタンスの hostname と、App を登録する 組織 を入力します。

5. GitHub にリダイレクトされます。Register App をクリックして登録を完了します。

6. Devin にリダイレクトされた後、GitHub App は GitHub 組織に登録済みになります。

1. GHES または GHEC インスタンスで、登録時に指定した GitHub 組織に移動します。
2. Settings → Developer Settings → GitHub Apps に移動し、Devin App を選択します。

3. Advanced セクションの Danger zone で、Make public をクリックします。これにより、同じインスタンス上の他の組織でも App をインストールできるようになります。
4. Optional features セクションに移動し、User-to-server token expiration をオフにします。これにより、アクセストークンの有効期限切れを防ぎ、ユーザーが定期的に App を再認可する必要がなくなります。

1. Devin アカウントで、Enterprise Settings → 統合 → GitHub に移動します。
2. Advanced セクションを展開し、Install App をクリックします。
3. モーダルで、GHES または GHEC インスタンスに登録されている GitHub App を選択します。

4. GitHub にリダイレクトされ、そこで GitHub 組織を選択し、Devin へのアクセスを許可するリポジトリを選択できます。すべてのリポジトリへのアクセスを許可することを推奨します。
5. インストールが完了すると、Devin にリダイレクトされます。新しい Git 接続が Settings → 統合 → GitHub に表示されます。

1. GitHub Enterprise 上で、Devin が利用する新しい GitHub アカウントを作成します。これは、Devin のすべてのアクセス権および利用状況を適切に追跡・管理するために重要です。
2. 作成したサービスアカウントを、関連するすべての GitHub Organization に Member として追加します。Devin がアクセスすることを想定しているすべてのリポジトリに、そのアカウントでアクセスできることを確認してください。

1. サービスアカウントにログインした状態で、右上のプロフィール画像をクリックし、 Settings をクリックします。
2. 左サイドバーで Developer settings をクリックします。
3. 左サイドバーの Personal access tokens の下で Fine-grained tokens をクリックします。
4. Generate new token をクリックします。
5. Token name と Expiration を入力します。
   Note: トークンが有効期限切れになると、Devin は直ちに GitHub へのすべてのアクセスを失い、新しいトークンを作成する必要があります。
6. Resource owner で、正しい Organization を選択します。

7. Repository access で、Devin に操作させたいリポジトリを選択します。トークンには常に、GitHub 上のすべてのパブリックリポジトリへの読み取り専用アクセスが含まれます。
8. Devin が正しく動作するために必要な、次の権限がトークンに付与されていることを確認します:

9. Generate Token をクリックし、表示されたトークンを保存します。
   Note: GitHub の設定によっては、Admin の承認が必要になる場合があります。
10. トークンに必要なアクセス権と権限がすべて付与されていることを検証するため、ローカルマシン上で テスト用ブランチを作成して push し、Organization 内のリポジトリに送信します。
11. トークンを生成してテストが完了したら、セットアップ完了のために Cognition の担当窓口に連絡してください。現在チームと直接やり取りをしていない場合は、enterprise@cognition.ai までご連絡ください。

# Authenticate with gh CLI using your token
export GH_TOKEN=your_personal_access_token
export GH_HOST=your-github-enterprise-server.com

# Clone the repository
gh repo clone your-organization/your-repository
cd your-repository

# Create a test branch
git checkout -b test-devin-token-$(date +%s)

# Make a small change
echo "# Test" >> TEST.md
git add TEST.md
git commit -m "Test: Validate Devin token permissions"

# Push the branch (tests contents write permission)
git push origin HEAD

# プルリクエストを作成(プルリクエスト書き込み権限をテスト)
gh pr create --title "Test: Validate Devin token permissions" \
  --body "This is a test PR to validate token permissions." \
  --base main

# Clean up: close the test PR and delete the test branch
gh pr close pr-number --delete-branch

• Devin が変更をマージする前にチェックが必ず実行されるようにするため、master ブランチに対してブランチ保護ルールを有効にすることを推奨します。
• Devin が組織の GitHub アカウントに接続されている場合、GitHub 組織および Devin 組織へのアクセス権を持つ任意のユーザーと同等の権限を持ちます。
• Devin は、Devin とのセッションを実行しているユーザー個別の権限を引き継がず、組織レベルで付与された権限を保持します。
• Devin は、あなたの GitHub アカウント内に新しいリポジトリを作成することはできません。