Pull RequestをIssueにリンクする

リンクされたIssueとPull Requestについて

手動か、pull request の説明でサポートされているキーワードを使い、pull request に issue にリンクできます。

Pull Requestが対処するIssueにそのPull Requestをリンクすると、コラボレータは、誰かがそのIssueに取り組んでいることを確認できます。

リンクされたPull Requestをリポジトリのデフォルトブランチにマージすると、それにリンクされているIssueは自動的にクローズされます。 既定のブランチについて詳しくは、「既定ブランチの変更」を参照してく� さい。

キーワードを使用してPull RequestをIssueにリンクする

pull request の説明またはコミットメッセージでサポートされているキーワードを使用して、pull request に issue にリンクできます。 pull request は、既定のブランチに存在する 必要があります。

• 閉じる
• closes
• closed
• 解決策
• fixes
• 固定
• resolve
• resolves
• resolved

他のPull RequestでPull Requestのコメントを参照するためにキーワードを使用すると、Pull Requestはリンクされます。 参照元の pull request をマージすると、参照先の pull request もクローズされます。

クローズするキーワードの構文は、IssueがPull Requestと同じリポジトリにあるかどうかによって異なります。

リンクするIssue	構文	例
Issueが同じリポジトリにある	キーワード #issue 番号	Closes #10
Issueが別のリポジトリにある	キーワード 所有者/リポジトリ#issue 番号	Fixes octo-org/octo-repo#100
複数の Issue	Issueごとに完全な構文を使用	Resolves #10, resolves #123, resolves octo-org/octo-repo#100

手動でリンクされた pull request のみを手動でリンク解除できます。 キーワードを使用してリンクした issue のリンクを解除するには、pull request の説明を編集してそのキーワードを削除する必要があります。

クローズするキーワードは、コミットメッセージでも使用できます。 デフォルトブランチにコミットをマージするとIssueはクローズされますが、そのコミットを含むPull Requestは、リンクされたPull Requestとしてリストされません。

Pull Request を Issue に Pull Request サイドバーを使用して手動でリンクする

リポジトリへの書き込み権限があるユーザーなら誰でも、Pull Request サイドバーから Pull Request を手動で Issue にリンクできます。

手動で1つのPull Requestごとに最大10個のIssueをリンクできます。 IssueとPull Requestは同じリポジトリになければなりません。

1. で、リポジトリのメイン ページへ移動します。 1. リポジトリ名の下にある [pull request] をクリックします。

2. Pull Requestのリストで、IssueにリンクしたいPull Requestをクリックします。

3. 右側のサイドバーで、 [リンクされた issue] をクリックします。

4. Pull RequestにリンクするIssueをクリックします。

参考資料

• 「自動リンクされた参照と URL」