Skip to main content

pull request の作成

リポジトリへの変更の提案や共同作業を行うには、pull request を作成します。 これらの変更は "ブランチ" を介して提案され、既定のブランチには完成していて、かつ承認された作業のみが確実に含まれるようにします。

Who can use this feature

Anyone with read access to a repository can create a pull request.

pull request 用に新しいブランチを作成する必要があり、リポジトリへの書き込みアクセス許可がない場合は、まずリポジトリをフォークできます。 詳細については、「フォークから pull request を作成する」と「フォークについて」を参照してください。

プルリクエストを作成するとき、変更をどのブランチにマージするかを指定できます。 2 つのブランチ間で違いがある場合にのみ、プルリクエストをオープンできます。

pull request をイシューにリンクして、修正が進行中であることを示し、誰かが pull request をマージしたときイシューを自動的にクローズすることができます。 詳細については、「pull request を Issue にリンクする」を参照してください。

ブランチの範囲と宛先リポジトリの変更

デフォルトでは、プルリクエストは親リポジトリのデフォルトブランチに基づいています。 詳細については、ブランチについてのページを参照してください。

デフォルトの親リポジトリが正しくない場合、親リポジトリとブランチをどちらもドロップダウンリストで変更できます。 また、基準点間の差分を確認するために、ドロップダウンリストで head ブランチと base ブランチを入れ替えることもできます。 ここで言う基準は GitHub リポジトリにあるブランチ名でなければなりません。

プルリクエスト編集ブランチ

ブランチについて考えるときは、"base ブランチ" が変更を適用する "場所" であり、"head ブランチ" には適用する "内容" が含まれていることに注意してください。

base リポジトリを変更するとき、プルリクエストの通知も変更します。 base リポジトリにプッシュできる人は誰でもメール通知を受信し、次回サインインすると自分のダッシュボードで新しいプルリクエストを確認できます。

ブランチの範囲にある何らかの情報を変更すると、[Commits] と [Files changed] プレビュー領域は更新されて新しい範囲を表示します。

ヒント:

  • 比較ビューを使用して、どの時間枠であっても比較対象として設定できます。 詳細については、「コミットを比較する」を参照してください。
  • プロジェクトメンテナーはプルリクエストテンプレートをリポジトリに追加できます。 テンプレートにはプルリクエスト本文にある情報のプロンプトが含まれます。 詳細については、「Issue と pull request テンプレートについて」を参照してください。

プルリクエストの作成

  1. On your GitHub Enterprise Server instance, navigate to the main page of the repository.
  2. [Branch] メニューで、自分のコミットが含まれるブランチを選択します。 [Branch] ドロップダウン メニュー 1. ファイルの一覧の上にある [pull request] をクリックします。 ファイルの一覧の上にある [pull request] のリンク
  3. 変更をマージする対象のブランチを [base] ブランチ ドロップダウン メニューで選択し、次に [compare] ブランチ ドロップダウン メニューを使用して、変更を行ったトピック ブランチを選択します。 [base] ブランチと [compare] ブランチを選択するためのドロップダウン メニュー 1. プルリクエストのタイトルと説明を入力します。 pull request のタイトルと説明フィールド 1. レビューの準備が完了している pull request を作成するには、 [pull request の作成] をクリックします。 ドラフトの pull request を作成するには、ドロップダウンを使用して、 [ドラフトの pull request の作成] を選択し、 [ドラフトの pull request] をクリックします。 ドラフトの pull request の詳細については、「pull requests について」を参照してください。[pull request の作成] ボタン

ヒント: pull request を作成したら、提案された変更のレビューを特定の人に依頼できます。 詳細については、「Pull Request レビューをリクエストする」を参照してください。

pull request が確認されたら、リポジトリにマージできます。

GitHub CLI の詳細については、「GitHub CLI について」を参照してください。

pull request を作成するには、gh pr create サブコマンドを使用します。

gh pr create

pull request を個人に割り当てるには、--assignee または -a フラグを使用します。 pull request を自己割り当てするために @me を使用できます。

gh pr create --assignee "@octocat"

pull request をマージするブランチを指定するには、--base または -B フラグを使用します。 pull request のコミットを含むブランチを指定するには、--head または -H フラグを使用します。

gh pr create --base my-base-branch --head my-changed-branch

新しい pull request のタイトルと本文を含めるには、--title--body フラグを使用します。

gh pr create --title "The bug is fixed" --body "Everything works again"

pull request をドラフトとしてマークするには、--draft フラグを使用します。

gh pr create --draft

新しい pull request にラベルまたはマイルストーンを追加するには、--label--milestone フラグを使用します。

gh pr create --label "bug,help wanted" --milestone octocat-milestone

特定のプロジェクトに新しい pull request を追加するには、--project フラグを使用します。

gh pr create --project octocat-project

個人またはチームをレビュー担当者として割り当てるには、--reviewer フラグを使用します。

gh pr create --reviewer monalisa,hubot  --reviewer myorg/team-name

既定の Web ブラウザーで pull request を作成するには、--web フラグを使用します。

gh pr create --web
  1. プルリクエストを作成するブランチに切り替えます。 詳細については、「ブランチ間で切り替える」を参照してください。
  2. [pull request の作成] をクリックします。 GitHub Desktop はデフォルトのブラウザを開いて GitHub に移動します。 [Create pull request](pull request の作成) ボタン
  3. GitHub で、 [base:] ドロップダウン メニューのブランチが変更をマージするブランチであることを確認します。 [compare:] ドロップダウン メニューのブランチが、変更を加えたトピック ブランチであることを確認します。 [base] ブランチと [compare] ブランチを選択するためのドロップダウン メニュー 1. プルリクエストのタイトルと説明を入力します。 pull request のタイトルと説明フィールド 1. レビューの準備が完了している pull request を作成するには、 [pull request の作成] をクリックします。 ドラフトの pull request を作成するには、ドロップダウンを使用して、 [ドラフトの pull request の作成] を選択し、 [ドラフトの pull request] をクリックします。 ドラフトの pull request の詳細については、「pull requests について」を参照してください。[pull request の作成] ボタン
  1. プルリクエストを作成するブランチに切り替えます。 詳細については、「ブランチ間で切り替える」を参照してください。
  2. [pull request の作成] をクリックします。 GitHub Desktop はデフォルトのブラウザを開いて GitHub に移動します。 [Create pull request](pull request の作成) ボタン
  3. GitHub で、 [base:] ドロップダウン メニューのブランチが変更をマージするブランチであることを確認します。 [compare:] ドロップダウン メニューのブランチが、変更を加えたトピック ブランチであることを確認します。 [base] ブランチと [compare] ブランチを選択するためのドロップダウン メニュー 1. プルリクエストのタイトルと説明を入力します。 pull request のタイトルと説明フィールド 1. レビューの準備が完了している pull request を作成するには、 [pull request の作成] をクリックします。 ドラフトの pull request を作成するには、ドロップダウンを使用して、 [ドラフトの pull request の作成] を選択し、 [ドラフトの pull request] をクリックします。 ドラフトの pull request の詳細については、「pull requests について」を参照してください。[pull request の作成] ボタン

参考資料