액션 종료 코드 설정하기

종료 코드(exit codes)를 사용해 액션의 상태를 설정할 수 있어요. GitHub은 액션의 통과 또는 실패를 나타내는 상태를 표시해요.

출처: Setting exit codes for actions

본문

GitHub은 종료 코드를 사용해 액션의 검사 실행(check run) 상태를 설정하며, 이 상태는 success 또는 failure가 될 수 있어요.

종료 상태	검사 실행 상태	설명
`0`	`success`	액션이 성공적으로 완료되었고 이에 의존하는 다른 작업이 시작될 수 있어요.
0이 아닌 값(0을 제외한 정수)	`failure`	다른 모든 종료 코드는 액션이 실패했음을 나타내요. 액션이 실패하면 모든 동시 액션이 취소되고 이후 액션은 건너뛰어져요. 검사 실행(check run)과 검사 모음(check suite) 모두 `failure` 상태를 받아요.

JavaScript 액션을 만든다면 actions 툴킷의 @actions/core 패키지를 사용해 메시지를 기록하고 실패 종료 코드를 설정할 수 있어요. 예를 들어:

try {
  // something
} catch (error) {
  core.setFailed(error.message);
}

자세한 내용은 JavaScript 액션 만들기를 참고하세요.

Docker 컨테이너 액션을 만든다면 entrypoint.sh 스크립트에서 실패 종료 코드를 설정할 수 있어요. 예를 들어:

if <condition> ; then
  echo "Game over!"
  exit 1
fi

자세한 내용은 Docker 컨테이너 액션 만들기를 참고하세요.