소셜 코딩으로 이끄는 GitHub 실천 기술

Chapter 1 GitHub 세계에 어서오세요 _ 1
1.1 GitHub란? 2
GitHub 회사와 octocat 2
일반적인 Git 리포지토리 호스팅 서비스가 아니다 3
GitHub 이용 형태 4
Column GitHub와 Git의 차이 4
1.2 GitHub를 사용하면 무엇이 달라질까? 4
협업 형태 변화 5
다른 팀이 작성하던 소프트웨어를 더 자세히 볼 수 있다 8
공개 소프트웨어 세계와 같은 개발 스타일 10
1.3 소셜 코딩이란? 10
1.4 소셜 코딩을 해야 하는 이유 12
드넓은 개발 세계 12
코드를 작성할 수 있는 개발자 13
GitHub의 가장 큰 특징은 ‘사람을 바라본다’는 것 13
1.5 GitHub가 제공하는 주요한 기능 14
Git 리포지토리 14
Organization 15
Issue 15
Wiki 16
Pull Request 16
Column GitHub에서 주목받고 있는 소프트웨어 17
1.6 정리 17

Chapter 2 Git 기본 _ 19
2.1 탄생 배경 20
2.2 버전 관리란? 21
집중형과 분산형 21
집중형과 분산형 중에 어떤 것이 좋은 것일까? 23
2.3 설치 24
맥과 리눅스의 경우 24
윈도우즈의 경우 24
이 책에서 사용하는 환경 27
2.4 기본 설정 28
사용자 이름과 메일 주소 설정 28
출력되는 명령어를 쉽게 읽을 수 있도록 만드는 방법 29
2.5 정리 29

Chapter 3 GitHub 사용 준비 _ 31
3.1 사전 준비 32
계정 생성 32
계정 설정 33
SSH Key 설정 33
공개 키 등록 34
소셜 기능 이용 36
3.2 실제로 사용해 보자 36
리포지토리 작성 36
Column 코드를 공개할 때의 라이선스 41
리포지토리 접근 41
코드 공개 41
3.3 정리 46

Chapter 4 Git을 직접 사용하면서 배우기 _ 47
4.1 기본적인 사용 방법 48
git init: 리포지토리 초기화 48
git status: 리포지토리 상태 확인 49
git add: 스테이지 영역에 파일 추가 50
git commit: 리포지토리 변경 내용을 기록 51
git log: commit 확인 53
git diff: 변경 내역 확인 55
4.2 브랜치 생성 58
git branch: 브랜치를 보는 방법 60
git checkout -b: 브랜치를 만들고 변경하는 방법 61
토픽 브랜치 63
통합 브랜치 64
git merge: 브랜치 merge 64
git log --graph: 브랜치를 시각적으로 확인 66
4.3 commit을 변경하는 조작 67
git reset: 과거 상태로 복원 67
충돌 문제 해결 72
git commit --amend: commit 메시지 수정 74
git rebase -i: 변경 내역 조작 76
4.4 원격 리포지토리 송신 80
git remote add: 원격 리포지토리 등록 81
git push: 원격 리포지토리 전송 82
4.5 원격 리포지토리에서 가져오기 84
git clone: 원격 리포지토리를 가져오기 84
git pull: 최신 원격 리포지토리를 가져오기 87
4.6 Git과 관련된 추가 참고 자료 88
4.7 정리 90

Chapter 5 GitHub의 기능을 확실하게 알아보자 _ 91
5.1 키보드 단축키 92
5.2 툴바 93
UI 구성 설명 93
5.3 대시보드 96
UI 구성 설명 97
5.4 프로필 98
UI 구성 설명 98
5.5 리포지토리 102
UI 구성 설명 102
파일 관련 조작 108
Column 파일 이름의 일부로 검색 108
변경 내역 확인 109
5.6 Issue 111
다양한 요소를 삽입할 수 있는 문서 작성 방식 112
라벨을 사용한 정리 115
Milestones을 사용한 관리 116
Column 공헌하기 위한 규칙을 알리자! 117
할 일 목록 117
commit 메시지로 Issue 조작 118
특정 Issue를 Pull Request로 변환 119
5.7 Pull Request 120
Column diff 또는 patch 파일 형식 활용 121
Conversation 122
Column 댓글 인용 122
Commits 123
Column 이모티콘 자동 완성 기능 124
Files Changed 124
5.8 Wiki 125
History 127
Column Wiki에 사이드 바 생성 127
5.9 Pulse 129
active pull requests 130
active issues 130
commits 131
Releases published 131
Unresolved Conversations 132
5.10 Graphs 133
Contributors 133
Commit Activity 134
Code Frequency 135
Punchcard 135
Network 136
members 137
5.11 Settings 138
Options 138
Collaborators 140
Webhooks & Services 142
Deploy Keys 142
5.12 Notifications 142
5.13 그 외의 기능 144
GitHub Pages 144
GitHub Jobs 144
GitHub Enterprise 145
GitHub API 145
5.14 정리 146
Column 맥의 통지 센터로 GitHub의 Notification 확인 146

Chapter 6 Pull Request를 해보자 _ 147
6.1 Pull Request 개요 148
Pull Request란? 148
Pull Request의 흐름 148
6.2 Pull Request 전송 준비 149
수정할 소스 코드 확인 150
Fork 151
clone 151
branch 152
코드 추가 153
변경 사항 commit 154
원격 브랜치 작성 154
6.3 Pull Request 전송 155
6.4 Pull Request를 효과적으로 사용하는 방법 158
개발 도중에도 토론을 위한 Pull Request를 보내세요 159
개발 중이라는 것을 알리는 방법 159
Fork하지 않은 브랜치에서 Pull Request 전송 160
6.5 리포지토리 관리 161
리포지토리 Fork, clone 162
원본 리포지토리 이름 설정 162
최신 데이터 획득 162
6.6 정리 163


Chapter 7 Pull Request가 도착한다면 _ 165
7.1 Pull Request를 보내는 방법 166
7.2 Pull Request를 보낼 준비 167
코드 리뷰 167
그림 변경 사항 확인 168
Pull Request의 내용을 현재 개발 환경에 반영 170
Column 코드 관리 기술을 증진시키고 싶을 때 174
7.3 Pull Request를 보내기 174
메인 브랜치에 merge 175
변경 사항 push 176
7.4 정리 177

Chapter 8 GitHub와 연계되는 툴과 서비스 _ 179
8.1 hub 명령어 180
개요 180
기본 설정 181
명령어 183
Column hub 명령어와 GitHub Enterprise 190
8.2 Travis CI 190
개요 190
실제 사용 191
8.3 Coveralls 196
개요 196
기본 설정 198
8.4 Gemnasium 202
8.5 Code Climate 204
8.6 Jenkins 205
개요 205
설치 207
bot 계정 작성 208
bot 계정 권한 설정 208
Jenkins SSH 키 설정 211
GitHub pull request builder plugin 설치 212
Git plugin 설정 213
GitHub pull request builder 설정 214
작업 생성과 설정 216
결과 통지 219
댓글을 활용한 관리 221
8.7 정리 223
Column Coderwall로 GitHub 프로필 작성 224

Chapter 9 GitHub를 사용하는 경우의 개발 진행 과정 _ 225
9.1 팀 내부에서 GitHub를 사용해야 할 때 고려할 것들 226
모든 것을 간단하게! 226
리포지토리를 Fork하지 않는 방법 228
9.2 GitHub Flow - Deploy 중심의 개발 스타일 230
9.3 GitHub Flow의 흐름 231
항상 Deploy 상태를 유지, 배포라는 개념은 없다 231
새로운 작업을 할 때는 master 브랜치에서 새로운 브랜치를 작성 232
작성한 새로운 브랜치에 commit하자 233
정기적으로 push하자 233
Pull Request를 활용하자 234
반드시 다른 개발자들에게 코드 리뷰를 받도록 하자 234
merge 후에는 곧바로 Deploy하자 236
9.4 GitHub Flow를 실천하기 위한 전제 조건 236
Deploy 작업 자동화 236
테스트 238
9.5 GitHub Flow 따라하기 239
Fizzbuzz 개요 239
새로운 기능 추가 240
새로운 브랜치 작성 241
새로운 기능 구현 243
Pull Request 작성 245
피드백 246
들여쓰기 수정 247
테스트 추가 249
Pull Request 추가 252
Pull Request를 merge 253
9.6 팀에서 GitHub Flow를 실천하려면 254
Pull Request 크기 축소 254
테스트 환경 준비 255
Pull Request 피드백 256
빠른 Pull Request 처리 257
9.7 GitHub Flow 정리 257
9.8 Git Flow - 배포 중심의 개발 스타일 258
표준 개발 진행 과정 258
복잡성 260
9.9 Git Flow 도입을 위한 준비 260
git-flow 설치 260
리포지토리 초기 설정 262
9.10 Git Flow 따라하기 264
master 브랜치와 develop 브랜치 264
feature 브랜치 265
Pull Request 전송 268
코드 리뷰를 활용한 코드 품질 향상 271
로컬 develop 브랜치 갱신 271
release 브랜치 실행 273
Column 디폴트 브랜치 설정 273
원격 리포지토리 반영 280
hotfix 브랜치 281
9.11 Git Flow 정리 288
Column 버전 번호 붙이기 288

Chapter 10 회사에서 GitHub 사용하기 _ 289
10.1 전 세계의 표준 개발 환경을 회사에서도 사용해 봅시다 290
회사에 GitHub를 도입하는 경우의 장점 290
Organization 이용 291
GitHub 보안 확인 291
유지보수 시간 주의 292
서비스 장애 관련 정보 확인 292
10.2 GitHub Enterprise 295
개요 295
도입 장점 296
도입 단점 296
도입하면 좋은 경우 296
Column GitHub 리포지토리를 서브버전 리포지토리로 이용하는 방법 297
10.3 Git 호스팅을 수행하는 다른 소프트웨어 298
Column Bitbucket 299
10.4 정리 300

APPENDIX A GitHub GUI 클라이언트 _ 301
A.1 GitHub for Mac, GitHub for Windows 302
A.2 Source Tree 304

APPENDIX B 코드를 Gist로 쉽게 공유하기 _ 307
B.1 Gist의 특징 308
B.2 Gist 작성 309
UI 설명 309
B.3 Gist 목록 313
Gist 메뉴 313
파일 메뉴 315
B.4 Your Gists 316
B.5 정리 317

찾아보기 _ 318

전 세계의 프로그램 개발 현장은 GitHub의 등장과 함께 많은 변화가 생겼습니다. 가히 혁명이 일어났다 해도 과언이 아닐 정도입니다. 이번 장에서는 아직 GitHub를 본격적으로 사용해 보지 않은 독자를 위해 일반적인 프로그램 개발에서 어떻게 GitHub를 도입하고 있는지 등을 간단히 살펴보겠습니다.

Pull Request는 GitHub에 있는 Git 리포지토리에서 변경하고 싶은 소스 코드를 주고 수정해 달라고 요청하는 기능입니다. Pull Request를 기반으로 댓글을 주고받을 수도 있습니다. ‘버그를 고쳤는데, 이렇게 수정해 주시면 안 될까요?’ 같은 댓글부터 ‘새로운 기능을 작성했는데, 이 코드를 넣어 주시면 안 될까요?’ 같은 댓글도 있습니다. 간단하게 소스 코드를 변경하고, 변경하고 싶은 기능을 넣도록 요청할 수 있습니다. 물론, 해당 소프트웨어 프로젝트의 정책에 어긋나는 변경 사항은 반영하지 않을 자유도 있습니다.

Git에는 이 디렉토리 이하의 내용을 해당 리포지토리와 관련된 ‘working tree(워킹 트리)’라고 부릅니다. working tree에서는 파일 준비 등이 이루어지며, 이후에 리포지토리에 등록된 파일 변경 내역을 관리하게 됩니다. 파일을 이전 상태로 되돌리고 싶은 경우, 리포지토리로부터 이전 파일 상태를 확인하고 working tree에 전개합니다. 이러한 기능을 수행하는 명령어는 뒤에서 차근차근 설명하겠습니다.