[Git] GitHub Actions로 Pull Request Labeling 자동화하기

1. GitHub Actions에서 Workflow 생성하기

리포지토리의 Actions 메뉴에서 set up a workflow yourself 버튼을 클릭하면 새로운 워크플로우 파일을 생성합니다.

오른쪽 사이드바의 GitHub Marketplace에서 "Auto Labeler"를 검색 후 선택합니다.

검색 결과에서 View full Marketplace listing 버튼을 눌러 상세 설명을 확인합니다.

---

2. Workflow 코드 작성하기

Marketplace 페이지에 있는 Create a Workflow 예시 코드를 복사하여 워크플로우 파일에 붙여 넣습니다.

작성한 코드를 저장하고 리포지토리에 커밋하면 GitHub Actions에 워크플로우가 등록됩니다.

---

 

3. labeler.yml 커스텀하기

jimschubert/labeler-action 은 .github/labeler.yml 파일을 기준으로 레이블을 설정합니다.

 

리파지토리의 .github/ 경로에서 Add file 버튼을 클릭하여 labeler.yml 파일을 추가한 뒤, 아래와 같이 원하는 규칙을 작성합니다:

 

저는 아래와 같이 커스텀하였습니다.

# enable labeler on issues, prs, or both.
enable:
  issues: false
  prs: true

# 레이블을 성공적으로 붙이고 PR에 보낼 코멘트
comments:
  prs: |
    Labeler has applied labels based on your PR title or description.
    Please review the labels and make any necessary adjustments.

# 레이블 규칙
labels:
  'feat':
    include:
      - '\bfeat\b'
  'fix':
    include:
      - '\bfix\b'
  'build':
    include:
      - '\bbuild\b'
  'chore':
    include:
      - '\bchore\b'
  'ci':
    include:
      - '\bci\b'
  'documentation':
    include:
      - '\bdocs\b'
  'style':
    include:
      - '\bstyle\b'
  'refactor':
    include:
      - '\brefactor\b'
  'test':
    include:
      - '\btest\b'
  'release':
    include:
      - '\brelease\b'

---

 

4. 액션 동작 확인하기

설정 파일을 커밋한 후, 리포지토리의 Actions 탭에서 새로 생성된 워크플로우가 정상적으로 등록된 것을 확인할 수 있습니다.

이제 실제로 Pull Request를 생성해보면 라벨러가 동작하여 자동으로 레이블이 추가됩니다.

---

5. 최종 확인

PR을 생성하면 아래와 같이 설정한 규칙에 따라 Labels이 자동 지정됩니다.

 

이제 매번 수동으로 라벨을 붙일 필요 없이, GitHub Actions가 자동으로 처리해주므로 코드 리뷰를 훨씬 효율적으로 진행할 수 있습니다. 🚀

---

PR 라벨링 자동화 외에도 Assignees 자동 지정 방법도 공유했으니 확인해보세요 😊

2025.09.17 - [개발도구/Git] - [Git] GitHub Actions로 Pull Request 자동 Assignees 지정하기

[Git] GitHub Actions로 Pull Request 자동 Assignees 지정하기