오늘은 GitHub Actions에 사용할 수 있는 다양한 트리거와 그 유형을 알아보자 ❕

• GitHub Actions는 코드 저장소의 변경을 자동으로 감지하여 빌드, 테스트, 배포 등 다양한 작업을 자동화할 수 있는 CI/CD 도구이다.
• 이 자동화를 가능하게 해주는 핵심 요소가 바로 Trigger이며, 오늘은 Github Actions에서 지원하는 다양한 트리거 유형과 사용 시나리오를 알아보자.

---

1. push ▶

저장소 코드가 푸쉬될 때 워크플로우 실행

on:
  push:
    branches: [main]

• 언제 사용할까? 🧐
  • CI/CD 기본 시나리오 : main, release 브랜치로 코드가 푸쉬되면 테스트 및 배포 실행
  • 버전 태그에 반응하는 자동 릴리즈

push:
  tags:
    - 'v*.*.*'

---

2. pull_request ⏩

PR이 생성되거나 변경될 때 워크플로우 실행

on:
  pull_request:
    branches: [ main ]

• 언제 사용할까? 🧐
  • PR 제출 시 자동 테스트 및 코드 품질 검사
  • PR 병합 전 상태 체크 ( required check로 설정 가능 )

pull_request:
  types: [opened, synchronize, reopened]

---

3. workflow_dispatch 🌊

수동으로 워크플로우를 실행 (UI 버튼 클릭)

on:
  workflow_dispatch:
    inputs:
      environment:
        description: '배포 환경'
        required: true
        default: 'dev'

• 언제 사용할까? 🧐
  • 수동 배포 시나리오 ( 운영팀 승인 후 배포 )
  • 테스트/운영 환경 분기시 배포
  • 매개변수로 다양한 동작 제어 가능 ( ex - dev, prod, v1.2.0 등 )

---

4. schedule 🕒

특정 시간 간격으로 주기적으로 실행 ( cron 방식 )

on:
  schedule:
    - cron: '0 9 * * *' # 매일 오전 9시 UTC 실행

• 언제 사용할까? 🧐
  • 매일 자동 테스트 실행
  • 정기적인 백업/로그 정리
  • 외부 API 동기화 주기적 실행
  • 참고사항 : GitHub Actions는 UTC 기준으로 동작

---

5. workflow_call🛎

다른 워크플로우에서 해당 워크플로우를 재사용하도록 호출

on:
  workflow_call:
    inputs:
      service-name:
        required: true
        type: string

• 언제 사용할까? 🧐
  • 중복된 파이프라인 로직을 분리하여 재사용
  • 여러 서비스에서 공통 빌드 로직을 호출할 때
  • 참고사항 : 해당 트리거 유형은 모듈화된 워크플로우 구성에 필수적임 ❗

---

6. workflow_run 🏃‍♀️

다른 워크 플로우가 완료된 후 실행

on:
  workflow_run:
    workflows: ["CI"]
    types:
      - completed

• 언제 사용할까? 🧐
  • 테스트 워크플로우 성공 이후에만 배포 실행
  • 보안 스캔 → 빌드 → 배포와 같이 단계별 파이프라인 구성
  • 하나의 워크플로우 실패가 다음 단계 실행을 막아야 하는 경우

---

7. repository_dispatch ⚙

외부 시스템에서 GitHub API로 이벤트 발생( Webhook 기반 )

on:
  repository_dispatch:
    types: [external-trigger]

• 언제 사용할까? 🧐
  • 외부 시스템에서 GitHub Actions 실행
  • 다른 서비스 이벤트에 따른 자동화

---

8. 기타 트리거들

트리거	설명	활용 예
release	릴리즈 생성/수정 시	배포 자동화, 릴리즈 노트 빌드
issues, issue_comment	이슈/댓글 작성 시	슬랙 알림, 자동 라벨링
fork, watch, star	저장소 활동 감지	커뮤니티 알림 자동화
deployment, deployment_status	배포 시작/완료	배포 상태 대시보드 연동

• 이러한 트리거 유형은 필터링 조건 ( 브랜치, 태그, 경로 등 )과 함께 사용하여 더 세밀한 워크플로우 제어가 가능하다.

---

시나리오에 따른 트리거 정리

시나리오	적합한 트리거
코드 변경 자동 빌드/테스트	push, pull_request
PR 병합 전 자동 검증	pull_request
수동 배포	workflow_dispatch
주기적 작업	schedule
외부 시스템과 연동	repository_dispatch
공통 워크플로우 재사용	workflow_call

---

마무리 🔚

워크플로우를 유지보수 가능하고 유연하게 구성하려면 트리거 설계가 핵심이다. 그렇기에 해당 여러 트리거 유형과 시나리오들을 숙달하여 정교한 설계를 할 수 있도록 노력하자 ❗❕