KKUSVERSECI/CD | GitHub Actions 빌드 자동화 + Slack 알림 연동하기

# workflow의 이름을 정의합니다.
# GitHub Actions UI에서 이 이름으로 표시됩니다.
name: CI Build & Slack Notification
 
# workflow가 언제 실행될지 trigger를 정의합니다.
# 예) main 브랜치에 push될 때만 실행됩니다.
on:
  push:
    branches:
      - main
 
# workflow 안에서 수행할 개별 작업 단위를 정의합니다.
jobs:
  # 각 job을 식별하는 고유 이름인 job_id를 정의합니다.
  build:
    # job의 이름을 정의합니다.
    name: Build
    # job이 실행될 런타임 환경을 지정합니다.
    runs-on: ubuntu-latest
 
    # job 안에서 실행할 단계들을 정의합니다.
    # 각 step은 순차적으로 실행됩니다.
    steps:
      # 1. 현재 Repository를 Runner 환경에 복사(Checkout)합니다.
      # 외부 Action(actions/checkout@v5)을 사용합니다.
      - name: Checkout repository
        uses: actions/checkout@v5
 
      # 2. Node.js 환경을 설정합니다.
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          # 사용할 Node.js 버전 지정
          node-version: ${{ vars.NODE_VERSION }}
          # npm 캐시 자동 관리
          cache: npm
 
      # 3. 의존성을 설치합니다.
      - name: Install Dependencies
        run: npm ci
 
      # 4. 프로젝트를 빌드합니다.
      - name: Build project
        run: npm run build

name: Slack Notify
description: Send build notification to Slack
 
# webhook-url와 build-status 값을 전달받습니다.
inputs:
  webhook-url:
    description: Slack Incoming Webhook URL
    required: true
  build-status:
    description: 'Build status: success or failure'
    required: true
 
# 빌드 상태에 따라 이모지와 텍스트를 설정하고 Slack 메시지를 전송합니다.
runs:
  using: composite
  steps:
    - name: Send Slack Notification
      shell: bash
      run: |
        COMMIT_SHA=${GITHUB_SHA:0:7}
 
        if [ "${{ inputs.build-status }}" = "success" ]; then
          EMOJI="✅"
          STATUS_TEXT="Success"
        else
          EMOJI="❌"
          STATUS_TEXT="Failure"
        fi
 
        curl -X POST -H 'Content-type: application/json' \
          --data "{
            \"blocks\": [
              {
                \"type\": \"header\",
                \"text\": {
                  \"type\": \"plain_text\",
                  \"text\": \":rocket: Build Notification\",
                  \"emoji\": true
                }
              },
              {
                \"type\": \"section\",
                \"fields\": [
                 {\"type\": \"mrkdwn\", \"text\": \"*Repository:*\n${GITHUB_REPOSITORY}\"},
                  {\"type\": \"mrkdwn\", \"text\": \"*Branch:*\n${GITHUB_REF_NAME}\"},
                  {\"type\": \"mrkdwn\", \"text\": \"*Commit:*\n$COMMIT_SHA\"},
                  {\"type\": \"mrkdwn\", \"text\": \"*Actor:*\n${GITHUB_ACTOR}\"},
                  {\"type\": \"mrkdwn\", \"text\": \"*Status:*\n$EMOJI $STATUS_TEXT\"}
                ]
              },
            ]
          }" "${{ inputs.webhook-url }}"

      ...
      # 빌드를 실행하고 결과를 환경변수에 저장합니다.
      - name: Build project
        run: |
          if npm run build; then
            echo "BUILD_STATUS=success" >> $GITHUB_ENV
          else
            echo "BUILD_STATUS=failure" >> $GITHUB_ENV
            exit 1
          fi
 
      # 빌드 완료를 Slack으로 알립니다.
      - name: Slack Notification
        # 빌드 성공 여부와 관계없이 항상 Slack 알림을 실행합니다.
        if: always()
        # 우리가 만든 Action의 경로입니다.
        uses: ./.github/actions/slack-notify
        with:
          webhook-url: ${{ secrets.SLACK_WEBHOOK_URL }}
          build-status: ${{ env.BUILD_STATUS }}