Skip to main content

워크플로 상태 배지 추가

리포지토리에 상태 배지를 표시하여 워크플로의 상태를 나타낼 수 있습니다.

참고: 프라이빗 리포지토리의 워크플로 배지는 외부에서 액세스할 수 없으므로 외부 사이트에서 배지를 포함하거나 연결할 수 없습니다.

상태 배지는 워크플로가 현재 실패 중 또는 통과 중인지 보여줍니다. 상태 배지를 추가하는 일반적인 위치는 리포지토리의 README.md 파일이지만 원하는 웹 페이지에 추가할 수도 있습니다. 기본적으로 배지는 기본 분기의 상태를 표시합니다. URL의 branchevent 쿼리 매개 변수를 사용하여 특정 분기 또는 이벤트에 대한 워크플로 실행의 상태를 표시할 수도 있습니다.

워크플로 상태 배지의 스크린샷. 왼쪽에는 octocat 로고와 워크플로의 이름인 "GitHub Actions Demo"가 포함되어 있습니다. 오른쪽 절반은 녹색이며 "통과"라는 텍스트가 있습니다.

README.md 파일에 워크플로 상태 배지를 추가하려면 먼저 표시할 상태 배지의 URL을 찾습니다. 그런 다음 Markdown을 사용하여 README.md 파일에서 배지를 이미지로 표시할 수 있습니다. Markdown의 이미지 태그에 대한 자세한 내용은 "기본 쓰기 및 서식 지정 구문"을(를) 참조하세요.

워크플로 파일 이름 사용

워크플로 파일의 이름을 사용하여 워크플로 상태 배지의 URL을 빌드할 수 있습니다.

https://github.com/OWNER/REPOSITORY/actions/workflows/WORKFLOW-FILE/badge.svg

README.md 파일에 워크플로 상태 배지를 표시하려면 이미지 포함을 위해 Markdown 태그를 사용합니다. Markdown의 이미지 태그에 대한 자세한 내용은 "기본 쓰기 및 서식 지정 구문"을(를) 참조하세요.

예를 들어 README.md 파일에 다음 Markdown을 추가하여 파일 경로가 .github/workflows/main.yml인 워크플로의 상태 배지를 추가합니다. 리포지토리의 OWNERgithub 조직이고 REPOSITORY 이름은 docs입니다.

![example workflow](https://github.com/github/docs/actions/workflows/main.yml/badge.svg)

branch 매개 변수 사용

특정 분기의 워크플로 실행 상태를 표시하려면 상태 배지 URL의 끝에 ?branch=BRANCH-NAME을 추가합니다.

예를 들어 다음 Markdown을 README.md 파일에 추가하여 이름이 feature-1인 분기의 상태 배지를 표시합니다.

![example branch parameter](https://github.com/github/docs/actions/workflows/main.yml/badge.svg?branch=feature-1)

event 매개 변수 사용

push 이벤트에 의해 트리거되는 워크플로의 상태를 표시하려면 상태 배지 URL의 끝에 ?event=push를 추가합니다.

예를 들어 다음 Markdown을 README.md 파일에 추가하여 push 이벤트에 의해 트리거되는 워크플로 실행 상태가 포함된 배지를 표시합니다. 그러면 해당 분기의 현재 상태의 빌드 상태가 표시됩니다.

![example event parameter](https://github.com/github/docs/actions/workflows/main.yml/badge.svg?event=push)