본문 바로가기

Developer/GitHub

Github 튜토리얼

GitHub 란 무엇입니까?

GitHub는 버전 제어 및 협업을위한 코드 호스팅 플랫폼입니다. 그것은 당신과 다른 사람들이 어디서나 프로젝트를 함께 작업 할 수 있도록합니다.

이 튜토리얼은 리포지토리 , 브랜치 , 커밋 , 풀 리퀘스트  같은 GitHub 필수 사항을 알려 줍니다. 자체 Hello World 리포지토리를 만들고 코드를 만들고 검토하는 인기있는 방법 인 GitHub의 Pull Request 워크 플로를 배웁니다.

코딩 불필요

이 자습서를 완료하려면 GitHub.com 계정 과 인터넷 액세스 가 필요합니다 . 코딩, 명령 줄 사용 또는 Git 설치 방법을 알 필요가 없습니다 (버전 제어 소프트웨어 GitHub가 빌드 됨).

팁 : 자습서의 단계를 완료하는 동안 볼 수 있도록 별도의 브라우저 창 (또는 탭)에서이 가이드를 엽니 다.

 

1 단계. 리포지토리 생성

저장소는 일반적으로 하나의 프로젝트를 구성하는 데 사용됩니다. 저장소에는 프로젝트에 필요한 모든 폴더와 파일, 이미지, 비디오, 스프레드 시트 및 데이터 세트가 포함될 수 있습니다. README 또는 프로젝트에 대한 정보가있는 파일을 포함하는 것이 좋습니다 . GitHub를 사용하면 새 저장소를 만드는 동시에 쉽게 추가 할 수 있습니다. 또한 라이센스 파일과 같은 다른 공통 옵션도 제공합니다.

귀하 hello-world는 아이디어, 자원, 또는 공유를 저장하고 다른 사람들과 일을 논의 곳 저장소는 장소가 될 수 있습니다.

새 저장소를 만들려면

  1. 오른쪽 상단에서 아바타 또는 identicon 옆에있는 그런 다음 새 저장소 를 선택 합니다 .
  2. 저장소 이름을 지정하십시오 hello-world.
  3. 간단한 설명을 작성하십시오.
  4. README로이 저장소 초기화를 선택 합니다 .

저장소 만들기를 클릭 합니다 .

 

2 단계. 브랜치 생성

분기 는 한 번에 여러 버전의 저장소에서 작업하는 방법입니다.

기본적으로 저장소에는 main최종 분기로 간주되는 하나의 분기 가 있습니다. 우리는 브랜치를 사용하여에 커밋하기 전에 실험하고 편집합니다 main.

브랜치에서 브랜치를 만들 때 해당 시점 main의 복사본 또는 스냅 샷을 main만듭니다. main브랜치에서 작업하는 동안 다른 사람이 브랜치를 변경 한 경우 해당 업데이트를 가져올 수 있습니다.

이 다이어그램은 다음을 보여줍니다.

  • main지점
  • 라는 새 브랜치 feature(이 브랜치에서 '기능 작업'을하고 있기 때문에)
  • feature합병되기 전의 여정main

다른 버전의 파일을 저장 한 적이 있습니까? 다음과 같은 것 :

  • story.txt
  • story-joe-edit.txt
  • story-joe-edit-reviewed.txt

분기는 GitHub 저장소에서 유사한 목표를 달성합니다.

여기 GitHub에서 개발자, 작성자 및 디자이너는 버그 수정 및 기능 작업을 main(프로덕션) 브랜치 와 별도로 유지하기 위해 브랜치를 사용 합니다. 변경이 준비되면 분기를 main.

새 분기를 만들려면

  1. 새 저장소로 이동합니다 hello-world.
  2. branch : main 이라고 표시된 파일 목록 상단의 드롭 다운을 클릭합니다 .
  3. readme-edits새 분기 텍스트 상자에 분기 이름을 입력합니다 .
  4. 파란색 Create branch 상자를 선택 하거나 키보드에서 "Enter"를 누르십시오.

이제 두 개의 분기 main및 readme-edits. 그들은 똑같아 보이지만 오래 가지 않습니다! 다음으로 새 분기에 변경 사항을 추가합니다.

 

3 단계. 변경 사항 수행 및 커밋

브라보! 이제 readme-edits.NET의 복사 본인 브랜치 의 코드보기에 있습니다 main. 몇 가지 수정을 해보겠습니다.

GitHub에서 저장된 변경 사항을 커밋 이라고 합니다. 각 커밋에는 관련 커밋 메시지 가 있으며, 이는 특정 변경이 이루어진 이유를 설명하는 설명입니다. 커밋 메시지는 변경 내역을 캡처하므로 다른 기여자가 수행 한 작업과 이유를 이해할 수 있습니다.

변경 및 커밋

  1. README.md파일을 클릭 하십시오.
  2. 클릭  편집 할 파일보기의 오른쪽 상단 모서리에있는 연필 아이콘.
  3. 편집기에서 자신에 대해 약간 작성하십시오.
  4. 변경 사항을 설명하는 커밋 메시지를 작성합니다.
  5. Commit changes 버튼을 클릭 합니다.

이러한 변경 사항은 readme-edits브랜치 의 README 파일에만 적용 되므로 이제이 브랜치에는 main.

 

4 단계. Pull 요청 열기

멋진 편집! 의 분기에 변경 사항이 main있으므로 풀 요청을 열 수 있습니다 .

Pull Request는 GitHub 협업의 핵심입니다. pull request 를 열면 변경 사항을 제안하고 누군가가 귀하의 기여를 검토하고 가져 와서 해당 브랜치에 병합하도록 요청하는 것입니다. 풀 요청을 보여 차이점 두 가지의 내용, 또는 차이를. 변경, 더하기 및 빼기는 녹색과 빨간색으로 표시됩니다.

커밋을하자마자 코드가 완성되기 전이라도 풀 리퀘스트를 열고 토론을 시작할 수 있습니다.

풀 요청 메시지에서 GitHub의 @mention 시스템 을 사용 하면 특정 사람이나 팀이 복도에 있든 10 개 시간대에 있든 상관없이 피드백을 요청할 수 있습니다.

자신의 저장소에서 pull 요청을 열고 직접 병합 할 수도 있습니다. 더 큰 프로젝트에서 작업하기 전에 GitHub 흐름을 배우는 좋은 방법입니다.

README 변경 사항에 대한 Pull Request 열기

더 큰 버전을 보려면 이미지를 클릭하십시오

단계스크린 샷

클릭  풀 요청 탭을 클릭 한 다음 풀 요청 페이지에서 녹색 새 풀 요청 버튼을 클릭합니다.  
에서 비교 예 상자, 당신이 만든 지점을 선택 readme-edits하여 비교, main(원래).  
비교 페이지의 diff에서 변경 사항을 살펴보고 제출하려는 내용인지 확인하십시오.  
제출하려는 변경 사항이 만족 스러우면 큰 녹색 Create Pull Request 버튼을 클릭합니다.  
풀 리퀘스트에 제목을 지정하고 변경 사항에 대한 간략한 설명을 작성하십시오.  

메시지 작성 이 완료되면 Create pull request !


 : 이모티콘 을 사용 하고 이미지와 GIF 를 댓글 및 Pull Request에 끌어다 놓을 수 있습니다 .

 

5 단계. Pull Request 병합

이 마지막 단계에서는 변경 사항을 통합하여 readme-edits분기를 분기로 병합 할  main입니다.

  1. 녹색 병합 풀 요청 버튼을 클릭하여 변경 사항을에 병합합니다 main.
  2. 병합 확인을 클릭 합니다 .
  3. 보라색 상자에있는 분기 삭제 버튼을 사용하여 변경 사항이 통합되었으므로 분기를 삭제 하십시오.

 

세상에 알리다!

이 튜토리얼을 완료함으로써 프로젝트를 생성하고 GitHub에서 pull 요청을하는 방법을 배웠습니다!

이 자습서에서 수행 한 작업은 다음과 같습니다.

  • 오픈 소스 저장소 생성
  • 새로운 지사 시작 및 관리
  • 파일을 변경하고 변경 사항을 GitHub에 커밋했습니다.
  • Pull Request를 열고 병합했습니다.

GitHub 프로필을 살펴보면 새로운 기여 사각형을 볼 수 있습니다 !

Pull Requests의 힘에 대해 자세히 알아 보려면 GitHub 흐름 가이드를 읽는 것이 좋습니다 . GitHub Explore를 방문 하여 오픈 소스 프로젝트에 참여할 수도 있습니다 .

 

출처 : guides.github.com