my-blog: deploy.yml에 workflow_dispatch 추가

요약

이번 커밋에서는 .github/workflows/deploy.yml 파일에 workflow_dispatch 이벤트를 추가하여 수동으로 GitHub Actions 파이프라인을 실행할 수 있도록 기능을 개선했습니다. 이 변경은 2026년 7월 15일에 이루어졌으며, 주로 CI/CD 워크플로우의 유연성을 높이기 위한 작업의 일환입니다.

배경 및 목적

기존에는 deploy.yml 워크플로우가 특정 파일 변경이 감지되었을 때만 자동으로 트리거되었습니다. 하지만 실제 운영 환경에서는 자동 트리거 없이도 특정 시점에 파이프라인을 테스트하거나 수동으로 실행해야 하는 경우가 발생합니다. 이러한 필요성에 따라 workflow_dispatch 이벤트를 추가하여 개발자가 필요할 때 언제든지 파이프라인을 직접 실행할 수 있도록 하여 개발 및 배포 프로세스의 유연성과 효율성을 높이고자 했습니다. 또한, ci.yml 파일에서 이미 사용하고 있는 workflow_dispatch 패턴과 일관성을 유지하여 워크플로우 관리의 통일성을 확보하는 것도 목적이었습니다.

구현 내용

이번 작업으로 .github/workflows/deploy.yml 파일에 단 한 줄의 코드가 추가되었습니다. on: 섹션 아래에 workflow_dispatch:를 추가함으로써, GitHub Actions UI에서 해당 워크플로우를 수동으로 실행할 수 있는 옵션이 활성화됩니다.

변경된 파일 목록

• .github/workflows/deploy.yml

추가/삭제 라인 수

• 총 추가 라인: 1
• 총 삭제 라인: 0

핵심 코드 설명

.github/workflows/deploy.yml 파일의 on: 섹션에 workflow_dispatch:가 추가되었습니다.

# .github/workflows/deploy.yml
on:
      - 'frontend/**'
      - 'ecosystem.config.cjs'
      - 'deployment/**'
  workflow_dispatch: # 이 부분이 새로 추가되었습니다.

jobs:
  deploy:
    # ... deploy job details

이 변경으로 인해 GitHub 저장소의 Actions 탭에서 deploy.yml 워크플로우를 찾아 수동으로 실행 버튼을 누르면, 지정된 이벤트(push 등)와 관계없이 해당 워크플로우가 실행될 것입니다.

배운 점 및 개선점

이번 작업을 통해 GitHub Actions에서 workflow_dispatch 이벤트를 사용하여 수동으로 워크플로우를 트리거하는 방법을 구체적으로 이해할 수 있었습니다. 이는 CI/CD 파이프라인을 더욱 유연하게 관리하고 테스트할 수 있는 좋은 방법임을 다시 한번 확인했습니다.

배운 점

• workflow_dispatch 이벤트를 통해 GitHub Actions를 수동으로 실행하는 방법.
• 다양한 GitHub Actions 이벤트(push, pull_request, workflow_dispatch 등)를 조합하여 워크플로우의 실행 조건을 정의하는 방법.

개선점 및 다음 단계 계획

이번 변경은 deploy.yml 파일에 간단한 기능 추가였기 때문에, 즉각적인 개선점이나 복잡한 시행착오를 겪지는 않았습니다. 하지만 앞으로는 workflow_dispatch를 사용할 때, 실행 시점에 필요한 입력값(inputs)을 정의하여 더욱 세밀하게 워크플로우를 제어하는 방안을 고려해볼 수 있습니다. 예를 들어, 배포할 특정 브랜치나 환경을 입력값으로 받아 처리하도록 확장할 수 있습니다.

참고 자료

• GitHub Actions workflow syntax for GitHub Actions
• Manually triggering a workflow