카카오웹툰은 GitHub Actions를 어떻게 사용하고 있을까?

카카오웹툰 프론트엔드 팀이 GitHub Actions를 활용해 구현한 4가지 워크플로우(테스트 자동화, Slack 알림, 자동 배포, 브랜치 보호)를 실제 YAML 코드와 주석으로 상세히 설명한다. 직접 따라 할 수 있는 예제 2개와 참고용 예제 2개를 함께 제공한다.

핵심 포인트 - GitHub Actions 개념: GitHub 이벤트(push, PR, merge 등) 발생 시 정해진 워크플로우(자동화 프로세스)를 실행하는 도구. .github/workflows/*.yml 파일로 정의 - 핵심 키워드: on(트리거), jobs(실행 단위), steps(단계), uses(외부 Action 사용), with(Action에 값 전달), env(환경변수 참조) - 예제 1 — 테스트 자동화: 모든 브랜치 push 시 lint, tsc, build 자동 실행. ubuntu-latest 러너, actions/checkout, actions/setup-node 활용 - 예제 2 — Slack 알림: 테스트 워크플로우 완료 후 결과를 Slack Incoming Webhook으로 전송. needs 키워드로 워크플로우 간 의존성 설정, SLACK_INCOMING_URL은 Secrets로 관리 - 예제 3 — 자동 배포: main 브랜치 merge 시 빌드 → 배포 자동 실행. 스테이징·프로덕션 환경별 조건 분기 가능 - 예제 4 — 브랜치 보호: 특정 브랜치(main 등)에 직접 push 방지. Required Status Check와 연계해 PR + 모든 체크 통과 후 merge 강제

상세 정리 - GitHub Actions 보안: 민감한 값(API 키, webhook URL)은 Settings > Secrets에 저장 후 ${{ secrets.변수명 }}으로 참조 - 예제 1 실습 방법: ./github/workflows/test-every-push.yml 생성 → on: push, jobs.test.steps에 checkout + setup-node + npm install + 테스트 명령 - needs 키워드: 워크플로우 내 job 간 순서 보장. needs: [test] 설정으로 테스트 완료 후 알림 전송 - Slack 알림 구현: if: always() 조건으로 테스트 성공/실패 모두 알림. ${{ job.status }}로 결과 참조 - marketplace Action 활용: rtCamp/action-slack-notify 등 외부 Action으로 Slack 연동 간소화 - 자동 배포 패턴: on: push: branches: [main]으로 main에 push될 때만 실행, AWS ECR/ECS 또는 Vercel action과 연동 - 브랜치 보호 설정: 워크플로우만으로는 부족 — GitHub 레포지토리 Settings > Branches > Branch protection rules에서 Required status checks 설정 필수

왜 읽나: GitHub Actions의 핵심 개념을 카카오웹툰의 실제 4가지 사용 사례(테스트·알림·배포·브랜치 보호)와 주석 달린 YAML 코드로 한 번에 익혀 팀 프로젝트에 바로 적용할 수 있다.