[Activity] GitHub Action × Trello: "이슈 트래킹 자동화"

[luminouxx]

GitHub Action with Trello

많은 팀들이 Notion이나 Github Project 등의 칸반을 활용하고 있는 것으로 알고 있는데요.

“GitHub에서 이슈 열면 Trello 카드가 자동 생성된다면?”
“PR을 머지하면 카드가 Done으로 쓱 이동한다면?”
이런 의문이 든 적이 있는 분들을 위한 간단한 예제를 준비했습니다.

오늘 해볼 것.

GitHub 이슈	Trello 보드

번거롭게 손으로 옮기지 않아도, GitHub Actions과 Trello API만으로 무료 플랜에서 충분히 구현할 수 있습니다.
디자인, 비즈와 같은 다른 팀과 하나의 칸반에서 작업을 진행할 수 있는 장점이 있어요.
오늘은 그 방법을 정리해 보았습니다.

1. 우리가 원하는 흐름

• Issue 생성 → Trello To do 카드 자동 생성
• Issue 닫힘 → 카드가 Done으로 이동
• (선택) Issue Reopen → 카드가 다시 To do로
• (선택) PR 생성 → 카드가 In Progress로 이동
• (선택) PR 머지 → 카드가 Done으로 이동

2. 과정

• GitHub 저장소 (Actions 켜두기)
• Trello 보드 (To do / In Progress / Done 리스트 준비)
• Trello API Key & Token 저장
• Trello Board Id, List Id 저장
• GitHub Secrets 설정
• GitHub Action 설정

2.1. Github 저장소

사용할 Github Repository를 준비해주세요.

2.2. Trello 보드 (To do / In Progress / Done 리스트 준비)

칸반 형식의 이슈 트래킹 툴을 많이 써봤다면 직관적으로 잘 사용할 수 있을 것 같아요.
Trello Board에 To do / In Progress / Done List를 추가합니다.

2.3. Trello API Key & Token

1. Trello Admin Portal → New Power-Up or Integration 생성
   (실제로 Power-Up을 쓰지는 않고, 키 발급용입니다)

필요한 정보를 적절히 입력합니다.

이제 API Key와 Token을 준비합니다.
"Generate a new API Key" 클릭 후, API 키를 복사합니다.
추가적으로 manually generate a Token을 클릭해서 Token을 발급합니다.
또는 브라우저에 아래 코드를 입력합니다.

https://trello.com/1/authorize?expiration=never&scope=read,write,account&response_type=token&key={YOUR_KEY}

2.4. Trello Board Id, List Id

(1) Board Id 얻기

보드 URL에서 확인: https://trello.com/b/<BOARD_ID>/<board-name> → <BOARD_ID>

또는 bash에서 API호출:

curl "https://api.trello.com/1/members/me/boards?key={KEY}&token={TOKEN}"

응답 JSON의 각 보드 객체 id가 Board Id 입니다.

(2) List Id 얻기 (To do / In Progress / Done)

아래 API로 보드의 열린 리스트를 조회합니다:

curl "https://api.trello.com/1/boards/{BOARD_ID}/lists?filter=open&key={KEY}&token={TOKEN}"

Json file을 Response로 받게 됩니다.
아래는 응답 예시 입니다.

[
  {"id":"<TO_DO_LIST_ID>","name":"To do", ...},
  {"id":"<IN_PROGRESS_LIST_ID>","name":"In Progress", ...},
  {"id":"<DONE_LIST_ID>","name":"Done", ...}
]

이 id 값들을 메모해 두세요.

2.5. GitHub Secrets 설정

Repository > Settings → Secrets and variables → Actions → New repository secret 로 이동합니다.

• TRELLO_KEY = (발급받은 Key)
• TRELLO_TOKEN = (발급받은 Token)
• TRELLO_TODO_LIST_ID = (To do 리스트 ID)
• TRELLO_DONE_LIST_ID = (Done 리스트 ID)

2.6. Github Action 작성

Repository > Actions → New workflow → set up a workflow yourself 클릭
아래의 스크립트를 작성한 후 Commit

name: Trello Sync

on:
  issues:
    types: [opened, closed]

jobs:
  trello-sync:
    runs-on: ubuntu-latest

    steps:
      - name: Create Trello card (on issue opened)
        if: github.event.action == 'opened'
        env:
          TRELLO_KEY: ${{ secrets.TRELLO_KEY }}
          TRELLO_TOKEN: ${{ secrets.TRELLO_TOKEN }}
          TODO_LIST_ID: ${{ secrets.TRELLO_TODO_LIST_ID }}
        run: |
          NUMBER=${{ github.event.issue.number }}
          TITLE="${{ github.event.issue.title }}"
          CARD_NAME="[#$NUMBER] $TITLE"
          CARD_DESC="GitHub Issue: ${{ github.event.issue.html_url }}"

          curl -s -X POST "https://api.trello.com/1/cards" \
            --data-urlencode "key=$TRELLO_KEY" \
            --data-urlencode "token=$TRELLO_TOKEN" \
            --data-urlencode "idList=$TODO_LIST_ID" \
            --data-urlencode "name=$CARD_NAME" \
            --data-urlencode "desc=$CARD_DESC"

      - name: Move Trello card to Done (on issue closed)
        if: github.event.action == 'closed'
        env:
          TRELLO_KEY: ${{ secrets.TRELLO_KEY }}
          TRELLO_TOKEN: ${{ secrets.TRELLO_TOKEN }}
          DONE_LIST_ID: ${{ secrets.TRELLO_DONE_LIST_ID }}
        run: |
          ISSUE_NUM=${{ github.event.issue.number }}
          QUERY="%5B%23${ISSUE_NUM}%5D"
          SEARCH=$(curl -s "https://api.trello.com/1/search?key=$TRELLO_KEY&token=$TRELLO_TOKEN&query=$QUERY&modelTypes=cards")
          CARD_ID=$(echo "$SEARCH" | jq -r '.cards[0].id')
          if [ "$CARD_ID" != "null" ]; then
            curl -s -X PUT "https://api.trello.com/1/cards/$CARD_ID" \
              --data-urlencode "key=$TRELLO_KEY" \
              --data-urlencode "token=$TRELLO_TOKEN" \
              --data-urlencode "idList=$DONE_LIST_ID"
          fi

이슈 열리면 → To do에 [#번호] 제목 카드 생성
이슈 닫히면 → 해당 카드 Done으로 이동
(※ PR에서 Closes #123 사용하면 머지 시 이슈가 자동 종료 → Done 이동)
Issue를 만든 후, Action으로 다시 오면, Script가 잘 작동되는지 확인할 수 있습니다.

GitHub Action	Trello 보드

Trello Board에서 잘 작동하는지 확인합니다.

3. 정리

이 문서의 핵심의 Github Action을 통해서 Repository의 이벤트를 서버사이드에서 처리 가능하다는 점 입니다.
이러한 일련의 Flow를 각자 팀의 상황에 맞게 커스텀해서 사용할 수 있을 것 같습니다.

당연하게도 다양한 Tool과 Integration이 가능합니다. 여러분만의 꿀팁을 알려주셔도 좋을 것 같아요.
(Trello가 가볍게 작은 규모의 팀에서 사용하기 좋을 것 같아서 예제로 삼았습니다 ㅎㅎ)

질문이 있으신 분은, 멘토링을 신청해주세요 😊

[freeskyES]

루미 짱이에요~👍 잘 쓰겠습니당

[luminouxx]

화이팅!