Workflow dispatch API가 이제 run ID를 반환합니다

Source: GitHub Changelog

개요

GitHub Actions 워크플로우 디스패치 API 엔드포인트를 사용해 워크플로우를 트리거하면, 이제 요청을 해당 워크플로우 실행과 연결하는 데 도움이 되는 메타데이터를 응답에서 받을 수 있습니다.

• 이전에는 이 엔드포인트가 204 No Content 상태 코드만 반환했습니다.
• 새로운 선택적 불리언 매개변수 return_run_details를 전달하면, API는 200 OK 응답을 반환하며 다음 정보를 포함합니다:
  • 워크플로우 ID
  • API URL
  • 워크플로우 URL

매개변수를 생략하면 엔드포인트는 계속해서 204 No Content를 반환합니다.

GitHub CLI 지원

이 기능은 GitHub CLI에서도 v2.87.0부터 지원됩니다.

• gh workflow run 명령으로 워크플로우 디스패치를 트리거합니다.
• CLI는 생성된 실행의 URL을 반환하며, 이는 gh run view로 확인할 수 있습니다.
• 최신 CLI 버전에서는 return_run_details가 기본값으로 true로 설정됩니다.

이점

개발자는 이제 API 호출에서 생성된 워크플로우 실행을 쉽게 식별할 수 있어, 복잡한 폴링이나 맞춤형 추적 솔루션이 필요하지 않게 됩니다.

워크플로우 디스패치 API에 대한 자세한 내용은 GitHub Actions 문서를 참고하세요.