# 워크플로 상태 배지 추가

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

> \[!NOTE]
> GitHub Enterprise Server 호스트 실행기는 현재 GitHub에서 지원되지 않습니다.

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

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

![워크플로 상태 배지의 스크린샷. 오른쪽에서 왼쪽으로는 GitHub 로고, 워크플로 이름("GitHub Actions 데모") 및 상태("전달")가 표시됩니다.](/assets/images/help/repository/actions-workflow-status-badge.png)

`README.md` 파일에 워크플로 상태 배지를 추가하려면 먼저 표시할 상태 배지의 URL을 찾습니다. 그런 다음 Markdown을 사용하여 `README.md` 파일에서 배지를 이미지로 표시할 수 있습니다. Markdown의 이미지 태그에 대한 자세한 내용은 [기본 쓰기 및 서식 지정 구문](/ko/enterprise-server@3.22/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#images)을(를) 참조하세요.

## UI 사용

워크플로 파일 이름, 분기 매개 변수, 이벤트 매개 변수를 사용하여 UI에서 직접 워크플로 상태 배지를 만들 수 있습니다.

1. GitHub에서 리포지토리의 기본 페이지로 이동합니다.
2. 리포지토리 이름에서 **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-play" aria-label="play" role="img"><path d="M8 0a8 8 0 1 1 0 16A8 8 0 0 1 8 0ZM1.5 8a6.5 6.5 0 1 0 13 0 6.5 6.5 0 0 0-13 0Zm4.879-2.773 4.264 2.559a.25.25 0 0 1 0 .428l-4.264 2.559A.25.25 0 0 1 6 10.559V5.442a.25.25 0 0 1 .379-.215Z"></path></svg> 작업**을 클릭합니다.

   !["github/docs" 리포지토리의 탭 스크린샷. "작업" 탭은 주황색 윤곽선으로 강조 표시됩니다.](/assets/images/help/repository/actions-tab-global-nav-update.png)
3. 왼쪽 사이드바에서 확인할 워크플로를 클릭합니다.

   !["작업" 탭의 왼쪽 사이드바 스크린샷. "CodeQL"이라는 워크플로가 진한 주황색 윤곽선으로 표시되어 있습니다.](/assets/images/help/actions/superlinter-workflow-sidebar.png)
4. 페이지 오른쪽의 "Filter workflow runs" 필드 옆에 있는 <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-kebab-horizontal" aria-label="Show workflow options" role="img"><path d="M8 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3ZM1.5 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Zm13 0a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z"></path></svg>를 클릭하여 드롭다운 메뉴를 표시하고 **Create status badge**를 클릭합니다.
5. 필요에 따라, 기본으로 설정된 분기가 아닌 다른 분기의 상태 배지를 표시하려면 해당 분기를 선택합니다.
6. 필요에 따라, 워크플로를 트리거할 이벤트를 선택합니다.
7. **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-copy" aria-label="copy" role="img"><path d="M0 6.75C0 5.784.784 5 1.75 5h1.5a.75.75 0 0 1 0 1.5h-1.5a.25.25 0 0 0-.25.25v7.5c0 .138.112.25.25.25h7.5a.25.25 0 0 0 .25-.25v-1.5a.75.75 0 0 1 1.5 0v1.5A1.75 1.75 0 0 1 9.25 16h-7.5A1.75 1.75 0 0 1 0 14.25Z"></path><path d="M5 1.75C5 .784 5.784 0 6.75 0h7.5C15.216 0 16 .784 16 1.75v7.5A1.75 1.75 0 0 1 14.25 11h-7.5A1.75 1.75 0 0 1 5 9.25Zm1.75-.25a.25.25 0 0 0-.25.25v7.5c0 .138.112.25.25.25h7.5a.25.25 0 0 0 .25-.25v-7.5a.25.25 0 0 0-.25-.25Z"></path></svg> 상태 배지 Markdown 복사**를 클릭하세요.
8. Markdown을 `README.md` 파일로 복사합니다.

## 워크플로 파일 이름 사용

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

```text
HOSTNAME/OWNER/REPOSITORY/actions/workflows/WORKFLOW-FILE/badge.svg
```

`README.md` 파일에 워크플로 상태 배지를 표시하려면 이미지 포함을 위해 Markdown 태그를 사용합니다. Markdown의 이미지 태그에 대한 자세한 내용은 [기본 쓰기 및 서식 지정 구문](/ko/enterprise-server@3.22/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#images)을(를) 참조하세요.

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

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

## `branch` 매개 변수 사용

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

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

```markdown
![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` 이벤트에 의해 트리거되는 워크플로 실행 상태가 포함된 배지를 표시합니다. 그러면 해당 분기의 현재 상태의 빌드 상태가 표시됩니다.

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