GitHub Issues の接続: 手順ガイド
失敗したテストごとに GitHub の Issue を1件作成し、再び失敗した場合はコメントを追加し、問題なく成功した場合は閉じます. GitHub へのファイルアップロードには対応していないため、スクリーンショットを添付する代わりに、証跡フォルダーの名前を Issue に記載します. このガイドでは、準備から接続の確認までの手順と、発生しうるエラーの原因および解決方法を説明します.
最終更新日:
認証情報は非公開にしてください。 トークン、キー、パスワード、Webhook URL をチャットに貼り付けないでください。入力先は Studio → 設定 → 連携のみにしてください。認証情報はワークスペースの .env ファイルに保存され、画面上では点で表示されます。AI アシスタントにも同じことが当てはまります。このガイドに沿って手順を案内することはできますが、トークンを伝える必要はありません。
必要なもの
- 対象のリポジトリで Issue を作成できる GitHub アカウント (共同作業者または所有者).
- Issues が有効になっているリポジトリ (リポジトリの設定 → 機能 → Issues).
- 対象のリポジトリに対する Issues → 読み取りと書き込み権限を持つ、きめ細かな個人アクセストークン、または repo スコープを持つ従来型のトークン.
認証情報を取得する
- https://github.com/settings/personal-access-tokens/new を開きます (きめ細かなトークン).
- 名前と有効期限を設定し、リポジトリへのアクセスで選択したリポジトリのみを選び、Issue の作成先となるリポジトリを選択します.
- 権限 → リポジトリの権限で、Issues を読み取りと書き込みに設定します. ほかの権限は必要ありません.
- トークンを生成し、その場でコピーしてください. GitHub での表示は一度限りです. Studio (次の手順) 以外には貼り付けないでください.
Studio で接続する
- Studio で、設定 → 連携 → GitHub Issues に接続を開きます.
- 入力を求められたらトークンを入力し、保存 & 確認を押します. Studio に、トークンの所有者とアクセス可能なリポジトリ数が表示されます.
- "Issue の作成先"でリポジトリを選択します. 一覧には、トークンでアクセスでき、Issues が有効なリポジトリのみが表示されます.
GITHUB_ISSUES_ENABLEDを有効にします.
動作を確認する
- 接続の確認に"<you> としてサインイン済み"および"<owner/repo> で Issue を作成できます"と表示されます. この確認では読み取りのみを行い、Issue は作成しません.
- 設定 → 連携 → チケットを開き、GitHub の作成先でテストチケットを作成を押します. nexus-test ラベルが付いた Issue が1件作成されます.
- GitHub でその Issue を開いてラベルを確認し、確認が済んだら閉じるか削除してください.
よくあるエラー
| 確認できる結果 | 原因 | 解決方法 |
|---|---|---|
| "GitHub がトークンを拒否しました (401)" | トークンが間違っているか、有効期限切れ、失効済み、またはコピーが不完全です. | Issues → 読み取りと書き込み権限を持つ新しいトークンを作成し、再度保存してください. |
| HTTP 403 | トークンに Issues の権限がないか、対象のリポジトリが選択されていないか、リクエスト回数の上限に達しています. | トークンを編集し、Issues を読み取りと書き込みに設定して、リポジトリを選択してください. リクエスト回数の制限が原因の場合は、数分待ってください. |
| HTTP 404 | リポジトリが存在しないか、名前が変更されたか、トークンで参照できません (非公開リポジトリは、きめ細かなトークンの設定で選択する必要があります). | 一覧からリポジトリを選択するか、トークンのアクセス対象にそのリポジトリを追加してください. |
| HTTP 422 | GitHub が Issue の項目を拒否しました. 多くの場合、共同作業者ではない担当者、または GitHub が許可しないタイトルやラベルが原因です. | 設定 → 連携 → チケットで担当者を解除するか、その人を共同作業者として追加してください. |
| "<repo> では Issues が無効になっています" | リポジトリの Issues 機能が無効になっています. | リポジトリの設定 → 機能 → Issues を有効にするか、別のリポジトリを選択してください. |
| "GitHub に接続できませんでした (…)" または "制限時間内に応答がありませんでした" | この PC から api.github.com に接続できません: VPN やプロキシ、またはネットワーク未接続が原因です. | 同じ PC のブラウザーで github.com を開いてから、再度確認してください. |
| 確認はすべて成功するのに、Issue が作成されない | GITHUB_ISSUES_ENABLED が false になっているか、判定が FLAKY または環境に関する判定だったか、サンドボックスでの実行だったか、そのテストに未解決の Issue がすでにあります (再度の失敗では、代わりにコメントが追加されます). | GITHUB_ISSUES_ENABLED を有効にし、テストチケットを作成で接続を確認してください. |
設定キー
| キー | 主な機能 | 有効な値 | 確認方法 |
|---|---|---|---|
GITHUB_ISSUES_ENABLED | 失敗時に GitHub の Issue を作成 | true または false | 「接続を確認」が成功してから有効にし、「テスト用チケットを作成」を実行してください。 |
GITHUB_ISSUES_TOKEN | GitHub アクセストークン (機密情報、このコンピューターにのみ保存) | 1 行で入力、引用符や空白なし | 接続確認: "トークンが拒否されました"は、トークンが正しくないか、有効期限が切れているか、失効していることを意味します。 |
GITHUB_ISSUES_REPO | Issue の作成先 GitHub リポジトリ | owner/repo, 例: acme/web | 一覧から選択してください。Studioでは、トークンでアクセスでき、Issuesが有効になっているリポジトリのみ保存できます。 |
詳細: すべての連携, 設定ガイド, 問題の解決方法. その他のガイド: Jira Cloud, Azure Boards, Slack, Microsoft Teams, Telegram.
まだ解決しませんか? Studioに表示されるエラー行をそのまま添えて、[email protected]までご連絡ください。トークンは記載しないでください。