リポジトリをフォークする

上流リポジトリへの変更を提案するために、プロジェクトをフォークする場合があります。 この場合、自分のフォークを上流のリポジトリと定期的に同期させるとよいでしょう。 これには、コマンドラインで Git を使用する必要があります。 フォークしたのと同じ octocat/Spoon-Knife リポジトリを使用して、アップストリーム リポジトリの設定を練習できます。

1. GitHub で、octocat/Spoon-Knife リポジトリに移動します。

2. ページの右上隅の [フォーク] を選択します。

   

3. [所有者] の下のドロップダウン メニューを選び、フォークされたリポジトリの所有者をクリックします。

4. 既定では、フォークの名前はその上流リポジトリと同じです。 必要に応じて、[リポジトリ名] フィールドに名前を入力すると、フォークをさらに区別できます。

5. 必要に応じて、[説明] フィールドにフォークの説明を入力します。

6. 必要に応じて、 [DEFAULT ブランチのみをコピーする] を選びます。

   オープンソース プロジェクトへのコントリビューションなど、多くのフォーク シナリオでは、既定のブランチのみをコピーする必要があります。 このオプションを選ばないと、すべてのブランチが新しいフォークにコピーされます。

7. [フォークの作成] をクリックします。

1. GitHub で、Spoon-Knife リポジトリの自分のフォークに移動します。

2. ファイルの一覧の上にある [コード] をクリックします。

   

3. リポジトリの URL をコピーします。

   • HTTPS を使ってリポジトリをクローンするには、[HTTPS] の下の をクリックします。

   • Organization の SSH 認証機関から発行された証明書などの SSH キーを使ってリポジトリをクローンするには、 [SSH] をクリックしてから、 をクリックします。

   • GitHub CLI を使ってリポジトリをクローンするには、 [GitHub CLI] をクリックしてから、 をクリックします。

     

4. [ターミナル][ターミナル][Git Bash] を開きます。

5. カレントワーキングディレクトリを、ディレクトリをクローンしたい場所に変更します。

6. 「git clone」と入力し、既にコピーした URL を貼り付けます。 次のようになるはずです。YOUR-USERNAME を自分の GitHub のユーザー名に置き換えてください。

   git clone https://github.com/YOUR-USERNAME/Spoon-Knife
   

7. Enter キーを押します。 これで、ローカルにクローンが作成されます。

   $ git clone https://github.com/YOUR-USERNAME/Spoon-Knife
   > Cloning into `Spoon-Knife`...
   > remote: Counting objects: 10, done.
   > remote: Compressing objects: 100% (8/8), done.
   > remote: Total 10 (delta 1), reused 10 (delta 1)
   > Unpacking objects: 100% (10/10), done.
   

1. GitHub で、octocat/Spoon-Knife リポジトリに移動します。

2. ファイルの一覧の上にある [コード] をクリックします。

   

3. リポジトリの URL をコピーします。

   • HTTPS を使ってリポジトリをクローンするには、[HTTPS] の下の をクリックします。

   • Organization の SSH 認証機関から発行された証明書などの SSH キーを使ってリポジトリをクローンするには、 [SSH] をクリックしてから、 をクリックします。

   • GitHub CLI を使ってリポジトリをクローンするには、 [GitHub CLI] をクリックしてから、 をクリックします。

     

4. [ターミナル][ターミナル][Git Bash] を開きます。

5. 複製したフォークの場所にディレクトリを変更します。

   • ホーム ディレクトリに移動するには、他のテキストを含めずに「cd」と入力します。
   • 現在のディレクトリのファイルとフォルダーを一覧表示するには、「ls」と入力します。
   • 一覧表示されているディレクトリのいずれかに移動するには、「cd YOUR-LISTED-DIRECTORY」と入力します。
   • 1 つ上のディレクトリに移動するには、「cd ..」と入力します。

6. 「git remote -v」と入力して Enter キーを押します。 フォーク用に現在構成されているリモート リポジトリが表示されます。

   $ git remote -v
   > origin  https://github.com/YOUR-USERNAME/YOUR-FORK.git (fetch)
   > origin  https://github.com/YOUR-USERNAME/YOUR-FORK.git (push)
   

7. 「git remote add upstream」と入力し、手順 3 でコピーした URL を貼り付け、Enter キーを押します。 次のようになります。

   git remote add upstream https://github.com/ORIGINAL-OWNER/Spoon-Knife.git
   

8. フォーク用に指定した新しい上流リポジトリを検証するには、再度「git remote -v」と入力します。 フォークの URL は origin のように表示され、上流リポジトリの URL は upstream のように表示されます。

   $ git remote -v
   > origin    https://github.com/YOUR-USERNAME/YOUR-FORK.git (fetch)
   > origin    https://github.com/YOUR-USERNAME/YOUR-FORK.git (push)
   > upstream  https://github.com/ORIGINAL-OWNER/ORIGINAL-REPOSITORY.git (fetch)
   > upstream  https://github.com/ORIGINAL-OWNER/ORIGINAL-REPOSITORY.git (push)
   

これで、いくつかの Git コマンドでフォークと上流リポジトリの同期を維持できます。 詳しくは、「フォークを同期する」を参照してください。