🔧 GitHub PR 관리 자동화: GitHub Actions 설정하기

Pull Request(이하 PR)는 오픈소스 협업과 코드 리뷰 과정에서 핵심적인 역할을 한다.
하지만 PR을 수동으로 검토하고 관리하는 데 시간이 많이 소요될 수 있다.
GitHub Actions를 활용하면 PR 관리 프로세스를 자동화할 수 있다.

오늘은 GitHub PR 자동화를 위한 기본적인 Action 설정 방법을 소개한다.

---

🚀 GitHub Actions란?

GitHub Actions는 CI/CD를 위한 자동화 도구다.
특정 이벤트(예: PR 생성, push 등)가 발생했을 때 미리 정의한 워크플로우를 실행할 수 있다.

---

📦 PR 관련 자동화 예시

1. PR 제목 검사
2. 라벨 자동 지정
3. 리뷰어 자동 지정
4. 테스트 자동 실행

---

🧩 .github/workflows 디렉토리 구조

.github/
└── workflows/
    └── pr-check.yml

---

✨ PR 제목 검사 Workflow 예시

name: PR 제목 검사

on:
  pull_request:
    types: [opened, edited]

jobs:
  check-title:
    runs-on: ubuntu-latest
    steps:
      - name: PR 제목 확인
        uses: amannn/action-semantic-pull-request@v5
        with:
          types: fix, feat, chore, docs, refactor
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

• PR 제목이 feat:, fix:, docs: 등 정해진 prefix를 따라야 통과함

---

🔖 자동 라벨 지정 Workflow 예시

name: PR 라벨 자동 지정

on:
  pull_request:
    types: [opened]

jobs:
  add-label:
    runs-on: ubuntu-latest
    steps:
      - name: 특정 파일 수정 시 라벨 추가
        uses: actions/labeler@v4
        with:
          repo-token: "${{ secrets.GITHUB_TOKEN }}"

labeler.yml 설정 예:

frontend:
  - frontend/**
backend:
  - backend/**

---

🔍 팁

• GITHUB_TOKEN은 자동으로 제공되며, PR에 대한 권한을 가진 인증 토큰이다.
• 여러 Workflow를 병렬로 구성하면 관리 효율이 높아진다.
• action.yml을 제공하는 오픈소스 Action 라이브러리를 적극 활용하자.

---

🔨 TIL

• GitHub Actions를 통해 PR 제목 검사, 라벨 추가 등의 반복 작업을 자동화할 수 있음을 배움
• 팀 내 코드 품질 유지와 효율적인 리뷰 프로세스를 위해 필수적인 설정임을 느낌
• 작은 설정이지만 협업 환경을 크게 개선할 수 있는 좋은 습관