리포지토리 포크

업스트림 리포지토리에 대한 변경 내용을 제안하기 위해 프로젝트를 포크할 수 있습니다. 이 경우 정기적으로 포크를 업스트림 리포지토리와 동기화하는 것이 좋습니다. 이렇게 하려면 명령줄에서 Git을 사용해야 합니다. 방금 포크한 것과 동일한 octocat/Spoon-Knife 리포지토리를 사용하여 업스트림 리포지토리를 설정하는 방법을 연습할 수 있습니다.

1. GitHub에서 octocat/Spoon-Knife 리포지토리로 이동하세요.

2. 페이지의 오른쪽 상단에서 Fork(포크)를 클릭합니다.

   

3. "소유자"에서 드롭다운 메뉴를 선택하고 포크된 리포지토리의 소유자를 선택합니다.

4. 기본적으로 포크의 이름은 업스트림 리포지토리와 동일합니다. 필요에 따라 포크를 더 구분하려면, "리포지토리 이름" 필드에 이름을 입력합니다.

5. 필요에 따라 ‘설명’ 필드에 포크 설명을 입력합니다.

6. 필요에 따라 DEFAULT 분기만 복사를 선택합니다.

   오픈 소스 프로젝트에 기여하는 것과 같은 많은 포크 시나리오의 경우 기본 분기만 복사하면 됩니다. 이 옵션을 선택하지 않으면, 모든 분기가 새 포크로 복사됩니다.

7. 포크 만들기를 클릭합니다.

1. GitHub에서 Spoon-Knife 리포지토리의 포크로 이동하세요.

2. 파일 목록 위에서 코드를 클릭합니다.

   

3. 리포지토리의 URL을 복사합니다.

   • HTTPS를 사용하여 리포지토리를 복제하려면 "HTTPS"에서 을 클릭합니다.

   • 조직의 SSH 인증 기관에서 발급한 인증서를 포함하여 SSH 키를 사용하여 리포지토리를 복제하려면 SSH를 클릭한 다음, 을 클릭합니다.

   • GitHub CLI를 사용하여 리포지토리를 복제하려면 GitHub CLI 를 클릭한 다음, 을 클릭합니다.

     

4. Terminal(터미널)Terminal(터미널)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"에서 을 클릭합니다.

   • 조직의 SSH 인증 기관에서 발급한 인증서를 포함하여 SSH 키를 사용하여 리포지토리를 복제하려면 SSH를 클릭한 다음, 을 클릭합니다.

   • GitHub CLI를 사용하여 리포지토리를 복제하려면 GitHub CLI 를 클릭한 다음, 을 클릭합니다.

     

4. Terminal(터미널)Terminal(터미널)Git Bash를 엽니다.

5. 디렉터리를 복제한 포크의 위치로 변경합니다.

   • 홈 디렉터리로 이동하려면 다른 텍스트 없이 cd를 입력합니다.
   • 현재 디렉터리의 파일 및 폴더를 나열하려면 ls를 입력합니다.
   • 나열된 디렉터리 중 하나로 이동하려면 cd YOUR-LISTED-DIRECTORY를 입력합니다.
   • 디렉터리를 하나 위로 이동하려면 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 명령을 사용하여 포크를 업스트림 리포지토리와 동기화된 상태로 유지할 수 있습니다. 자세한 내용은 "포크 동기화" 항목을 참조하세요.