Skip to main content

워크플로우 실행 관리

당신은 워크플로우의 매 스텝마다의 결과와 상태를 볼 수 있습니다. 또 펜딩 중인 워크플로우를 캔슬하고, 디버그 해서 실패한 워크플로우를 재실행 할 수 있으며, 로그를 탐색하여 다운로드거나 아티팩트를 다운로드 할 수 있습니다.

워크플로우 권한(permission)에 대하여#

깃허브 액션이 활성화된 레포지토리에 대한 읽기 권한(Read Access)가 있다면 워크플로우에 대한 모든 정보를 볼 수 있습니다. 읽기 권한은 아티팩트를 다운로드하거나 워크플로우 파일과 실행 히스토리 그리고 로그들을 볼 수 있게 해줍니다.

워크플로우를 취소하거나 재실행하려면 최소 쓰기 수준의 권한(write-level access)이 있어야합니다.

더 많은 정보는 "깃허브의 접근권한"을 참고하세요.

워크플로우 관리에 대하여#

워크플로우가 실행 중인지 혹은 완료된 상태인지는 워크플로우 실행 페이지에서 확인 가능합니다. 만약 실행 중이라면, 실행을 취소할 수 있습니다. 만약 완료된 상태라면, 결과가 성공인지 실패인지 취소되었는지 또는 중립적(neutral)인지 알 수 있습니다. 만약 실패했다면 실패를 진단하기 위해 빌드 로그들을 찾아보고 워크플로우를 재실행할 수도 있습니다. 또한 로그들과 빌드 아티팩트들을 다운로드 받을 수도 있습니다.

깃허브 엑션은 Checks API 로 상태, 결과, 로그들을 출력합니다. 깃허브는 각각의 워크플로우 실행마다 새로운 체크 수트(suite)를 생성합니다. 체크 수트는 워크플로우 내 각각의 잡에 대한 체크 실행을 의미하며, 각 잡은 스텝들로 이루어져있습니다. 깃허브 액션은 워크플로우 내에서 스텝으로써 실행됩니다. Checks API에 대하여 도큐먼트를 살펴보십시오.

워크플로우 히스토리 보기#

워크프로우 실행 안에서 각각의 잡들과, 잡의 매 스텝을 볼 수 있습니다. 더 많은 정보는 "액션에 대하여"를 참고하세요.

모든 잡은 "잡 설정하기(Set up Job)" 스텝과 "잡 완료하기(Complete job)" 스텝을 디폴트로 포함하며, 이 액션들은 워크플로우 파일내에서 구성될(configured) 수 있습니다.

1. 깃허브에서 목표한 레포지토리의 메인페이지로 이동한다.#

2. Actions 탭을 클릭한다.#

img

3. 왼쪽 사이드바에서 보고 싶은 워크플로우를 클릭한다.#

img

4. "워크플로우 실행들" 하에 보고 싶은 실행의 이름들을 클릭한다.#

img

5. 만약 실행이 실패했다면, 워크플로우를 재실행하기 위하여, 워크플로우 우측 상단 모퉁이에 Re-run checks 드롭 다운 메뉴를 사용하여, Re-run all checks를 선택한다.#

img

실행 취소하기#

1. 깃허브에서 목표한 레포지토리의 메인페이지로 이동한다.#

2. Actions 탭을 클릭한다.#

img

3. 왼쪽 사이드바에서 보고 싶은 워크플로우를 클릭한다.#

img

4. "워크플로우 실행들" 하에 보고 싶은 실행의 이름들을 클릭한다.#

img

5. 우측 상단의 Cancel check suite를 취소하기#

img

실패 진단을 위해 로그들을 보기#

만약 워크플로우 실행이 실패했다면, 어느 스텝때문에 실패했는지를 보고, 빌드 로그들을 검토하여 문제점을 해결할 수 있습니다. 또 각 스텝에 대하여 실행하는데 걸린 시간 또한 볼 수 있습니다. 그리고 팀원들과 공유하기 위해 로그 파일 안의 특정 라인의 퍼머링크(permalink, 영구적인 정적 하이퍼링크)를 복사할 수 있습니다.

깃허브는 풀 빌드 로그들과 아티팩트들을 push에 관해 90일동안, pull 요청에 관해 30일 동안 보관합니다. pull 요청의 보존 주기는 누군가 pull 요청을 푸쉬할 때마다 재시작됩니다.

1. 깃허브에서 목표한 레포지토리의 메인페이지로 이동한다.#

2. Actions 탭을 클릭한다.#

img

3. 왼쪽 사이드바에서 보고 싶은 워크플로우를 클릭한다.#

img

4. "워크플로우 실행들" 하에 보고 싶은 실행의 이름들을 클릭한다.#

img

5. 왼쪽 사이드바에 보고 싶은 잡을 클릭한다.#

img

6. 실패한 스텝에 대하여 로그를 펼치기 위해, 스텝을 클릭한다.#

img

7. 로그 안의 특정 라인에 대한 링크를 얻기 위해, 스텝 라인의 숫자를 클릭한다. 웹브라우저의 주소창으로부터 링크를 복사할 수 있다.#

img

로그들 검색하기#

특정 스텝의 빌드 로그들을 검색할 수 있다. 이 때 펼쳐진(expanded) 스텝들만 결과에 포함된다.

1. 깃허브에서 목표한 레포지토리의 메인페이지로 이동한다.#

2. Actions 탭을 클릭한다.#

img

3. 왼쪽 사이드바에서 보고 싶은 워크플로우를 클릭한다.#

img

4. "워크플로우 실행들" 하에 보고 싶은 실행의 이름들을 클릭한다.#

img

5. 왼쪽 사이드바에 보고 싶은 잡을 클릭한다.#

img

6. 검색 시 포함할 스텝을 펼친다.#

img

7. 로그 아웃풋 우측 상단의 검색박스에 쿼리를 타이핑한다.#

img

아티팩드와 로그들 다운로드#

아티팩트들은 코드를 빌드할 때나 테스트할 때 생성되는 파일들입니다. 예를 들면, 바이너리 파일이나 패키지 파일들, 테스트 결과들, 스크린샷들, 또는 로그 파일들이 포함될 수 있습니다. 실행이 완료 되면 이 파일들은 워크플로우를 실행 시킨 가상환경에서 제거 되며, 다운로드하기 위해 아카이브됩니다.

1. 깃허브에서 목표한 레포지토리의 메인페이지로 이동한다.#

2. Actions 탭을 클릭한다.#

img

3. 왼쪽 사이드바에서 보고 싶은 워크플로우를 클릭한다.#

img

4. "워크플로우 실행들" 하에 보고 싶은 실행의 이름들을 클릭한다.#

img

5. 드롭다운 메뉴의 Download Logs를 사용하여 원하는 로그들을 선택한 후 다운로드합니다.#

img

6. 드롭다운 메뉴의 Artifacts를 사용하여 원하는 아티팩트를 선택한 후 다운로드 합니다.#

img

디버그 로깅 활성화#

만약 워크플로우, 잡, 혹은 스텝들이 왜 작동하지 않았는지를 진단하기 위해 충분한 정보를 워크플로우 로그들이 제공하지 못했다면, 추가적으로 디버그 로깅을 활성화 할 수 있습니다.

이 추가적인 로그들은 워크플로우를 포함하는 레포지토리 안의 시크릿들을 설정함으로써 다룰 수 있습니다. 시크릿 설정에 대한 더 많은 정보는, "시크릿 생성"을 참고하세요.

러너 진단 로깅 활성화#

러너 진단 로깅(Runner diagnostic logging)은 어떻게 러너가 액션에서 실행되었는지에 대한 정보를 포함한 추가적인 로그 파일들은 제공한다. 두 추가적인 로그 파일들이 로그 아카이브에 추가 됩니다.

  • 러나 진행 로그(runner process log). 잡들을 실행하기 위한 러너들을 coordinating하거나 설정하는 것에 대한 정보를 포함하는 로그입니다.
  • 워커 진행 로그(worker process log). 잡들을 실행하는 로그들입니다.
  1. 러너 진단 로깅을 활성화하기 위해 다음에 해당하는 시크릿을 다음과 같이 바꾸어줘야한다: ACTION_RUNNER_DEBUGtrue
  2. 러너 진단 로그들을 다운로드 하기 위해, 워크플로우에서 로그 아카이브를 다운로드 합니다. runner-diagnostic-logs 폴더 안에 로그들이 포함되어있습니다. 더 많은 정보는 "로그와 아티팩트 다운로드"를 참고하세요.

스텝 디버그 로깅 활성화#

스텝 디버그 로깅은 실행중이거나 실행이 끝난 뒤의 잡의 로그들의 버보시티(verbosity, 상세성)를 증가시킵니다.

  1. 스텝 디버그 로깅을 활성화하기 위해 다음에 해당하는 시크릿을 다음과 같이 바꾸어줘야한다: ACTION_RUNNER_DEBUGtrue
  2. secret을 설정한 다음에는 스텝 로그들에서 더 많은 디버그 이벤트이 나타난다. 더 많은 정보를 위해서는 실패 진단을 위한 로그 보기