GitHub Guide - Fork a repo(GitHub CLI)

레포지토리 나누기

fork(갈래, 분기점)은 레포지토리의 복제본입니다. 레포지토리의 갈래를 내는 것은 당신이 원본에 영향을 주지 않고 자유롭게 내용에 변화를 줄 수 있는 경험을 선사합니다.

---

** Windows 기준입니다.

 

 

 

1. GitHub CLI

---

 

 

포크(fork, 갈래)에 대하여

---

분기점은 대부분 당신이 쓰기 권한이 없는 누군가의 프로젝트에 변화를 제안하거나 누군가의 프로젝트를 당신의 아이디어의 시작점으로 사용할 때 사용됩니다. 당신은 레포지토리를 나누어 레포지토리의 복제본을 만들고 기존의 올라가있는 레포지토리에 영향이 가지 않게 변화를 줄 수 있습니다. 더 많은 정보를 원하신다면 "Working with forks"를 살펴보세요.

 

 

누군가의 프로젝트에 변화를 제안하기

예를 들면, 당신은 버그 픽스와 관련된 내용을 제안하기 위해 포크를 사용할 수 있습니다. 찾아낸 버그 이슈를 기록하는 대신 당신은 다음과 같은 것들을 할 수 있습니다:

• 레포지토리 갈래 만들기.
• 수정본 만들기.
• 프로젝트 소유자에게 pull 요청 제출하기.

 

 

다른 이의 프로젝트를 당신 아이디어의 시작점으로 사용해보세요.

오픈 소스 소프트웨어는 코드를 공유한다는 아이디어에 기반을 두고있으며, 우리는 더 낫고 신뢰할 수 있는 소프트웨어를 만들 수 있습니다. 더 많은 정보를 알고싶다면 "About the Open Source Initiative"를 살펴보세요.

 

GitHub.com에서 귀사의 개발업무에 오픈 소스 원칙을 적용하기 위해서 더 많은 정보가 필요하다면 GitHub의 백지 "An introduction to innersource"를 살펴보세요.

 

누군가의 프로젝트로부터 포크해서 당신의 공개 레포지토리를 만들 때, 당신의 프로젝트를 다른이들과 어떤식으로 공유하고 싶은 지를 결정해주는 라이센스 파일을 포함해야 합니다. 더 많은 정보를 알고싶다면, choosealicense.com에서 "Choose an open source license"를 확인하세요.

 

오픈 소스, 특히 오픈 소스 프로젝트를 어떻게 생성하고 성장시키는 지에 대해 더 자세히 알고 싶다면, 우리가 만든 Open Source Guides가 당신의 오픈 소스 프로젝트 유지, 생성을 위한 모범사례를 추천하여 당신이 건강한 오픈 소스 커뮤니티를 조성하도록 도와줄 것입니다. 당신은 또한 오픈 소스 커뮤니티에 대한 GitHub Learning Lab 강의를 무료로 수강할 수 있습니다.

 

 

 

사전 조건

---

만약 당신이 아직 Git을 설정하지 않았다면, Git 설정를 해야합니다. 그리고 Git에서 GitHub.com을 인증하는 것을 잊지마세요.

 

 

 

레포지토리 포크(fork, 갈래)하기

---

GitHub CLI에 대해 더 알고싶다면 "About GitHub CLI"를 참고하세요.

 

레포지토리 갈래를 생성하려면  gh repo fork  서브커맨드를 사용하면 됩니다.

gh repo fork repository

 

기관에서 갈래를 생성하려면  --org  플래그를 사용하세요.

gh repo fork repository --org "octo-org"

 

 

 

포크(fork, 갈래)한 레포지토리 복제하기

---

지금 당신은 Spoon-Knife 포크된 레포지토리를 가지고 있지만 당신은 해당 레포지토리의 파일들은 당신의 로컬 컴퓨터에 있진 않습니다.

 

당신의 포크의 클론을 생성하려면,  --clone 플래그를 사용하세요.

gh repo fork repository --clone=true

 

 

 

당신의 갈래와 기존 레포지토리를 동기화시키기 위해 Git 구성하기

---

당신이 기존 레포지토리에 변경 사항을 제안하기 위해 프로젝트에 갈래를 낼 때, 당신은 기존 레포지토리 또는 업스트림 레포지토리에서 변경 사항을 포크의 로컬 복제본으로 가져올 수 있게 Git을 구성할 수 있습니다.

 

포크된 레포지토리를 위해 원격 레포지토리를 구성하고 싶다면,  --remote 플래그를 사용하세요.

gh repo fork repository --remote=true

 

원격 레포지토리의 이름을 지정하고 싶다면,  --remote-name 플래그를 사용하세요.

gh repo fork repository --remote-name "main-remote-repo"

 

 

포크 편집하기

당신은 포크를 얼마든지 변경할 수 있습니다. 다음을 포함하여:

• 브랜치 생성: 브랜치는 메인프로젝트에 위험부담없이 당신이 새로운 특성을 빌드하거나 아이디어를 실험할 수 있게 해줍니다.
• pull 요청 열기: 만약 당신이 원래 레포지토리에 기여하고 싶다면, 당신은 원작자에게 pull 요청을 보냄으로써 당신의 포크를 그들의 레포지토리에 가져가라고 요청을 보낼 수 있습니다.

 

 

 

포크할 다른 레포지토리 찾기

---

프로젝트에 기여하기 위해 레포지토리를 포크하세요. 당신은 당신의 개인 계정이나 당신이 레포지토리 생성 권한을 가진 어떤 기관에서 레포지토리를 포크할 수 있습니다. 더 많은 정보를 원하신다면 "Roles in an organization"을 참고하세요.

 

만약 당신이 비공개 레포지토리의 접근 권한을 가지고 소유자가 포크하는 것을 허락했다면, 당신은 레포지토리를 당신의 개인 계정 또는 당신이 레포지토리 생성 권한을 가지고 속한 GitHub Team에서의 기관으로 포크할 수 있습니다. 당신은 비공개 레포지토리를 무료 GitHub를 이용하는 기관에는 포크할 수 없습니다. 더 많은 정보를 알고싶다면, "GitHub's products"를 살펴보세요.

 

당신은 프로젝트를 찾고 오픈 소스 레포지토리에 기여하는 것을 시작하기 위해 Explore를 탐색할 수 있습니다. 더 많은 정보를 알고싶다면, "Finding ways to contribute to open source on GitHub"를 참고하세요.

 

 

 

다음 단계

---

당신은 레포지토리를 포크하고, 포크를 복제하는 것을 연습했으며, 그리고 업스트림 레포지토리를 구성했습니다.

• 포크를 복제하는 것과 당신의 컴퓨터에서 변경된 포크된 레포지토리를 동기화 하는 것에 대해 자세히 알고싶다면 "Set up Git"을 참고하세요.
• 당신은 또한 새로운 레포지토리 생성하고 당신의 모든 프로젝트를 올려 GitHub에 코드를 공유할 수 있습니다. 당신의 프로젝트를 위해 레포지토리를 생성하는 것은 당신이 GitHub에 코드를 저장할 수 있게 해줍니다. 이것은 당신의 작업에 백업을 제공하며 당신은 다른 개발자와 공유하는 것을 선택할 수 있습니다. 더 많은 정보를 알고 싶다면 "Create a repository"를 참고하세요.
• GitHub에 있는 각 레포지토리는 개인이나 기관에 의해 소유됩니다. 당신은 GitHub에서 그들과 접촉하고 팔로우함으로써 사람, 레포지토리, 기관들과 상호작용 할 수 있습니다. 더 많은 정보를 원한다면 "Be social"을 참고하세요.
• GitHub는 당신이 전 세계 사람들에게 도움을 청하거나 얘기를 나눌 수 있는 훌륭한 지원 커뮤니티를 가지고 있습니다. GitHub Support Community에서 대화에 참여하세요.