자동화를 다루는 개발자에서, 자동화를 설계하는 개발자로

테스트, 릴리스, 배포 과정을 자동화하면 개발 속도는 물론 협업 방식까지 달라진다. 깃허브 액션은 자동화를 코드로 구현하는 강력한 도구로, 단순한 시간 절약을 넘어 개발 환경을 직접 설계할 수 있게 해준다. 2025년 일본 ‘IT 엔지니어 도서 대상’ 기술서 부문 TOP 10에 선정된 이 책은 깃허브 액션을 활용해 실무에 맞는 CI/CD 시스템을 설계하고 운영하는 법을 다룬다. 워크플로 구성, 릴리스 자동화, 클라우드 연계, 보안 전략 등 핵심 요소를 체계적으로 설명하고, 다양한 실무 예제를 통해 유지 가능한 자동화 시스템 설계 방법을 제시한다. 복잡한 워크플로를 단순화하고 직접 자동화 시스템을 구축하고자 하는 개발자에게 확실한 길잡이가 되어줄 것이다.

[목 차]

옮긴이 머리말 xvi

베타리더 후기 xvii

감사의 글 xxi

이 책에 대하여 xxii

PART I 기초편 1

CHAPTER 1 소프트웨어 개발과 깃허브 3

1.1 소프트웨어 개발 3

1.2 CI/CD 4

1.3 깃허브 8

1.4 환경 구축 11

1.5 요약 14

CHAPTER 2 깃허브 액션의 기초 개념 16

2.1 깃허브 액션을 시작하자 16

2.2 깃허브 액션의 구성 요소 18

2.3 깃허브 액션 실행 21

2.4 깃허브 액션의 오류 23

2.5 워크플로 실행 방법 26

2.6 워크플로 실행 관리 29

2.7 잡 실행 환경 31

2.8 액션 34

2.9 깃허브 액션의 과금 모델 35

2.10 요약 36

[COLUMN] 참고 문헌: 기초 기술 37

CHAPTER 3 워크플로 구문 기초 38

3.1 컨텍스트 38

3.2 환경변수 40

3.3 변수 43

3.4 시크릿 45

3.5 식 48

3.6 함수 50

3.7 조건 분기 53

3.8 명명 규칙 54

3.9 스텝 간 데이터 공유 56

3.10 깃허브 API 실행 58

[COLUMN] 소스 코드 읽기 권한과 리포지터리 종류 62

3.11 스타터 워크플로 63

3.12 요약 65

CHAPTER 4 CI 구현 66

4.1 풀 리퀘스트를 사용한 CI 실행 66

4.2 자동 테스트 68

4.3 이벤트 필터링 73

4.4 셋업 액션 75

4.5 정적 분석 78

4.6 타임아웃 81

4.7 셸 81

4.8 concurrency 83

4.9 CI의 황금률 86

4.10 자동 테스트 운영 방법 88

4.11 정적 분석의 운영 방법 92

[COLUMN] 억제 이유 기록해두기 92

4.12 요약 93

[COLUMN] 참고 문헌: 테스트와 문서화 94

CHAPTER 5 운영하기 쉬운 워크플로 설계 95

5.1 워크플로 설계를 위한 도구함 95

5.2 로그 96

5.3 보고서 101

5.4 채팅 알림 103

5.5 여러 잡의 실행 제어 105

5.6 매트릭스 108

5.7 Environments 111

[COLUMN] 변수와 시크릿에는 세 가지 종류가 있다 115

5.8 캐시 115

5.9 아티팩트 120

5.10 요약 123

CHAPTER 6 액션을 사용한 모듈화 124

6.1 액션의 분류 124

6.2 복합 액션 126

6.3 메타데이터 구문 129

6.4 메타데이터 구문과 워크플로 구문의 차이 132

6.5 액션의 설계 기법 134

[COLUMN] 액션과 Node.js 버전 137

6.6 요약 137

[COLUMN] 참고 문헌: 소프트웨어 설계 138

P A R T II 실전편 139

CHAPTER 7 깔끔한 리포지터리 유지 141

7.1 코드 리뷰 141

7.2 브랜치 보호 142

7.3 주인 의식 유지 146

7.4 인증 정보의 난입 방지 148

7.5 문서화 151

7.6 요약 153

CHAPTER 8 Dependabot을 사용한 의존성 업데이트 154

8.1 의존성 154

8.2 Dependabot 156

8.3 깃허브 액션을 통한 자동 머지 162

8.4 Dependabot의 워크플로 설계 167

8.5 버전 업데이트의 영향 범위 169

8.6 자동 머지 전략 171

[COLUMN] 구분 문자를 무시하는 사람은 구분 문자 때문에 운다 172

8.7 요약 173

CHAPTER 9 깃허브 릴리스를 사용한 릴리스 자동화 174

9.1 소프트웨어 릴리스 174

9.2 버전 관리 175

9.3 공지 177

9.4 깃허브 릴리스 179

9.5 릴리스 노트 자동 생성 181

9.6 릴리스 자동화 185

9.7 깃 태그 보호 189

9.8 요약 192

[COLUMN] 참고 문헌: 소프트웨어 개발 193

CHAPTER 10 깃허브 패키지를 사용한 패키지 관리 194

10.1 패키지 194

10.2 깃허브 패키지 196

10.3 컨테이너 레지스트리 197

10.4 깃허브의 패키지 관리 199

10.5 패키지의 자동 링크와 권한 계승 202

10.6 컨테이너 이미지의 자동 릴리스 205

10.7 요약 211

[COLUMN] 참고 문헌: 컨테이너 기술 212

CHAPTER 11 OpenID Connect를 사용한 안전한 클라우드 연계 213

11.1 클라우드 서비스의 인증 정보 213

11.2 OpenID Connect 215

11.3 검증 작업의 위험 관리 218

[COLUMN] 클라우드 보안 219

11.4 AWS에서 OpenID Connect 사용 준비 220

11.5 OpenID Connect를 사용한 AWS 연동 225

11.6 클라우드 역할의 안전한 운영 230

11.7 요약 231

[COLUMN] 참고 문헌: 인프라스트럭처 232

CHAPTER 12 컨테이너 오케스트레이션 및 배포 233

12.1 서비스 233

12.2 실행 환경 구축 235

12.3 배포 정보용 변수 관리 240

12.3.1 배포 정보 확인 241 / 12.3.2 배포 정보 등록 242

12.4 배포 자동화 242

[COLUMN] Node 16 기반의 액션 243

12.5 Environments를 사용해 여러 환경에 배포 250

12.6 배포 설계 255

12.7 요약 256

CHAPTER 13 액션의 오픈소스화 257

13.1 액션 공개 257

13.2 액션 테스트 261

13.3 액션의 릴리스 관리 265

13.4 액션의 문서화 269

13.5 깃허브 마켓플레이스에 공개 270

13.6 액션의 진화 프로세스 273

13.7 요약 275

[COLUMN] 참고 문헌: 운영 275

P A R T III 응용편 277

CHAPTER 14 깃허브 액션의 고급 사용법 279

14.1 리유저블 워크플로 279

14.2 동적 워크플로 정의 288

14.3 오류 처리 290

14.4 컨텍스트를 통한 흐름 제어 292

14.5 프라이빗 액션과 프라이빗 리유저블 워크플로 295

14.6 요약 296

[COLUMN] 참고 문헌: 보안 297

CHAPTER 15 깃허브 액션의 보안 298

15.1 소프트웨어 공급망 298

15.2 보안 설계 원칙 300

15.3 깃허브의 서비스 특성 301

15.4 리포지터리 보호 302

15.5 외부 액션의 보안 304

15.6 스크립트 주입 308

15.7 최소 권한의 허가 309

15.8 시크릿 관리 311

15.9 포크 풀 리퀘스트 대책 313

15.10 OpenID Connect 설정 315

[COLUMN] 푸시 규칙 322

15.11 요약 323

CHAPTER 16 보안의 시프트 레프트 324

16.1 시프트 레프트 324

16.2 의존성의 취약성 스캔 325

16.3 시크릿 보호 330

16.4 애플리케이션 보안 333

[COLUMN] 컨테이너 레지스트리의 취약성 스캔 335

16.5 IaC 보안 335

16.6 지속적인 보안 개선 338

16.7 요약 339

CHAPTER 17 깃허브 앱 토큰을 사용한 다른 리포지터리 접근 340

17.1 깃허브의 인증 정보 340

17.2 깃허브 앱 토큰 342

17.3 다른 리포지터리 접근 347

[COLUMN] 비밀 키는 신속하게 삭제한다 348

[COLUMN] 호기심 많은 독자를 위해 350

17.4 깃허브 앱 토큰 생성의 원리 350

17.5 깃허브 앱 토큰의 운영 기법 357

17.6 요약 360

[COLUMN] 참고 문헌: 시스템 설계 360

CHAPTER 18 CD 실전 361

18.1 조직 성과 361

18.2 버전 관리 전략 363

18.3 테스트 전략 364

18.4 릴리스 전략 365

18.5 데이터베이스 변경 관리 366

18.6 IaC의 변경 관리 367

18.7 느슨한 결합 아키텍처 369

18.8 운영 잊지 말기 370

18.9 지속적인 학습 371

18.10 요약 372

마치며 373

찾아보기 375

[본 문]

OS는 명령어를 실행할 때에 종료 상태(termination status)라고 하는 값을 반환한다. 성공하면 0, 그 외는 0 이 아닌 다른 값을 반환한다. / 유닉스 계열 OS에서는 $? 변수를 참조하면 직전에 실행한 명령의 종료 상태를 확인할 수 있다. 예를 들어 다음과 같이 존재하지 않는 명령을 실행해보자. 실행에 실패하므로 0 외의 값이 표시될 것이다. 깃허브 액션에서는 바로 이 종료 상태를 사용하고 있다. (25쪽)

깃허브는 프로그램과 연동할 수 있는 API를 제공하고 있으며 이를 깃허브 API라고 한다. 예를 들면 curl 등을 사용해서 풀 리퀘스트에 코멘트나 레이블을 부여할 수 있다. 이미 앞서 소개한 깃허브 CLI도 내부적으로는 깃허브 API를 사용하고 있는 것이다. / 깃허브 액션은 깃허브 API에 쉽게 접근할 수 있다. 깃허브 호스트 러너를 사용하고 있다면 사전 설치돼 있는 깃허브 CLI를 사용하면 된다. (58쪽)

정적 분석 결과 중에는 중요도가 낮은 경고도 있다. 따라서 ‘이 경고는 아무런 조치를 취하지 않는다’라고 취급해버리는 경우가 발생한다. 이때 단순히 경고를 무시하는 것은 좋은 해결책이 아니다. 무시한 경고는 노이즈가 된다. 불필요한 경고는 억제하자. 생각보다 손이 많이 가지 않는다. / 경고를 억제(suppress)할 때는 두 가지 방향성을 고려해야 한다. 억제 대상을 코드베이스 전체로 할지 특정 부분으로 한정할지이다. 전자는 설정 파일 등으로 제어한다. 후자는 특정 키워드를 억제 대상 코드에 직접 삽입하는 것이다. 구체적인 방법은 도구에 따라 다르다. ignore나 suppress 등의 키워드로 도구의 문서를 검색해보자. 흔한 경우이므로 관련 내용이 기록돼 있을 것이다. (92쪽)

깃허브 릴리스는 소프트웨어 전달이나 변경 내용 공지 등을 제공하는 서비스다. 깃 태그와 연동해서 릴리스 단위로 임의의 파일을 2GB까지 업로드할 수 있다. / 깃허브 릴리스는 명령줄 도구 배포 시에 자주 사용된다. 예를 들면 Go로 단일 바이너리 실행 파일을 작성해서 배포하는 경우다. 단순히 파일만 다운로드할 수 있으면 되는 간단한 용도에 적합하다. 또한, 소프트웨어 배포를 하지 않고 릴리스 노트만 배포하는 사용법도 있다. / 깃허브 릴리스는 리포지터리와 자연스럽게 연계된다. 브라우저에서 버전 간 차이를 커밋 단위로 추적할 수 있다. 깃허브 CLI를 통해 조작할 수도 있으며 자동화도 쉽다. (179쪽)

깃허브 액션에서 OIDC를 사용하면 깃허브상에서 정적 인증 정보를 관리할 필요가 없어진다. 임시 인증 정보를 가져올 수 있기 때문이다. 임시 인증 정보는 정적 인증 정보보다 안전하며 운영도 편해진다. / 이 밖에도 다른 이점이 있다. 클라우드 서비스 인증 시에 접속할 수 있는 대상을 세밀하게 제어할 수 있다는 것이다. 예를 들어 깃허브 액션의 경우 특정 리포지터리에만 접속 권한을 허가할 수 있다. 이것은 OIDC를 사용할 때 얻을 수 있는 또다른 부수 효과다. (216쪽)

접속 키 등의 인증 정보는 높은 기밀성이 요구되는 자산이다. 인증 정보는 공격자가 간절히 원할 정도로 매력적인 데이터다. 반면 인증 정보는 부주의하게 취급되기 쉬운 정보이기도 하다. 암호화하지 않고 텍스트로 관리하는 사람도 있다. / 텍스트로 버전 관리하는 것은 논외로 하더라도 인증 정보의 적절한 운영은 꽤 어려운 작업이다. 잠재적으로 사람의 실수로 유출될 수도 있어서 이를 방지하기 위한 많은 노력이 필요하다. 명확한 보상은 없지만 실수하면 막대한 피해를 입힐 수 있다. (311쪽)