# GitHub 호스팅 러너 사용

GitHub에서 호스팅하는 가상 머신에서 실행되도록 작업을 할당할 수 있습니다.

## GitHub호스팅된 러너 사용

GitHub호스팅 실행기를 사용하려면 작업을 만들고 `runs-on`을 사용하여 해당 작업을 처리할 실행기 유형(예: `ubuntu-latest`, `windows-latest` 또는 `macos-latest`)을 지정하세요. 실행기 유형의 전체 목록은 [GitHub 호스팅 실행기 참조](/ko/actions/reference/runners/github-hosted-runners#supported-runners-and-hardware-resources)을 참조하세요. 리포지토리에 액세스할 수 있는 경우 `repo: write` 리포지토리의 워크플로에서 사용할 수 있는 실행기 목록을 볼 수 있습니다. 자세한 내용은 [리포지토리에서 사용 가능한 러너 확인](#viewing-available-runners-for-a-repository)을(를) 참조하세요.

작업이 시작 GitHub 되면 해당 작업에 대한 새 VM을 자동으로 프로비전합니다. 모든 단계는 해당 작업 내에서 VM에서 실행되므로, 실행기의 파일 체계를 통해 정보를 공유할 수 있습니다. VM 또는 Docker 컨테이너에서 직접 워크플로를 실행할 수 있습니다. 작업이 완료되면 VM이 자동으로 서비스 해제됩니다.

다음 다이어그램에서는 워크플로의 두 작업이 서로 다른 GitHub두 개의 호스트된 실행기에서 실행되는 방법을 보여 줍니다.

![두 개의 작업으로 구성된 워크플로의 다이어그램. 한 작업은 Ubuntu에서 실행되고 다른 작업은 Windows에서 실행됩니다.](/assets/images/help/actions/overview-github-hosted-runner.png)

예시된 다음 워크플로에는 `Run-npm-on-Ubuntu`, `Run-PSScriptAnalyzer-on-Windows` 두 개의 작업이 있습니다. 이 워크플로가 트리거되면 GitHub 각 작업에 대해 새 가상 머신을 프로비전합니다.

* 이름이 `Run-npm-on-Ubuntu`인 작업은 작업의 `runs-on:`이 `ubuntu-latest`를 지정하므로 Linux VM에서 실행됩니다.
* 이름이 `Run-PSScriptAnalyzer-on-Windows`인 작업은 작업의 `runs-on:`가 `windows-latest`를 지정하므로 Windows VM에서 실행됩니다.

```yaml copy
name: Run commands on different operating systems
on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]

jobs:
  Run-npm-on-Ubuntu:
    name: Run npm on Ubuntu
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: actions/setup-node@v7
        with:
          node-version: '14'
      - run: npm help

  Run-PSScriptAnalyzer-on-Windows:
    name: Run PSScriptAnalyzer on Windows
    runs-on: windows-latest
    steps:
      - uses: actions/checkout@v6
      - name: Install PSScriptAnalyzer module
        shell: pwsh
        run: |
          Set-PSRepository PSGallery -InstallationPolicy Trusted
          Install-Module PSScriptAnalyzer -ErrorAction Stop
      - name: Get list of rules
        shell: pwsh
        run: |
          Get-ScriptAnalyzerRule
```

작업이 실행되는 동안 GitHub UI에서 로그 및 출력 내용을 볼 수 있습니다.

![워크플로 실행의 스크린샷. "Windows에서 PSScriptAnalyzer 실행" 작업의 단계가 표시되어 있습니다.](/assets/images/help/repository/actions-runner-output.png)

GitHub Actions 실행기 애플리케이션이 오픈 소스입니다. [실행기](https://github.com/actions/runner) 리포지토리에서 기여하고 문제를 제출할 수 있습니다.

## 리포지토리에서 이용 가능한 러너 확인하기

리포지토리에 `repo: write` 액세스 권한이 있는 경우 리포지토리에서 사용할 수 있는 실행기 목록을 볼 수 있습니다.

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. 왼쪽 사이드바의 "Management" 섹션에서 **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-server" aria-label="server" role="img"><path d="M1.75 1h12.5c.966 0 1.75.784 1.75 1.75v4c0 .372-.116.717-.314 1 .198.283.314.628.314 1v4a1.75 1.75 0 0 1-1.75 1.75H1.75A1.75 1.75 0 0 1 0 12.75v-4c0-.358.109-.707.314-1a1.739 1.739 0 0 1-.314-1v-4C0 1.784.784 1 1.75 1ZM1.5 2.75v4c0 .138.112.25.25.25h12.5a.25.25 0 0 0 .25-.25v-4a.25.25 0 0 0-.25-.25H1.75a.25.25 0 0 0-.25.25Zm.25 5.75a.25.25 0 0 0-.25.25v4c0 .138.112.25.25.25h12.5a.25.25 0 0 0 .25-.25v-4a.25.25 0 0 0-.25-.25ZM7 4.75A.75.75 0 0 1 7.75 4h4.5a.75.75 0 0 1 0 1.5h-4.5A.75.75 0 0 1 7 4.75ZM7.75 10h4.5a.75.75 0 0 1 0 1.5h-4.5a.75.75 0 0 1 0-1.5ZM3 4.75A.75.75 0 0 1 3.75 4h.5a.75.75 0 0 1 0 1.5h-.5A.75.75 0 0 1 3 4.75ZM3.75 10h.5a.75.75 0 0 1 0 1.5h-.5a.75.75 0 0 1 0-1.5Z"></path></svg> Runners**를 클릭합니다.
4. 리포지토리에 사용할 수 있는 GitHub 호스팅 실행기 목록을 검토합니다.
5. 실행기 레이블을 복사사하여 워크플로에서 사용하려면, 실행기 오른쪽에 있는 <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-kebab-horizontal" aria-label="More 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>을 클릭한 다음 **레이블 복사**를 클릭합니다.

> \[!NOTE]
> 엔터프라이즈 및 조직 소유자는 이 페이지에서 실행기를 생성할 수 있습니다. 새 실행기를 만들려면 실행기 목록의 오른쪽 상단에 있는 **새 실행기**를 클릭하여 리포지토리에 실행기를 추가합니다.
>
> 자세한 내용은  및 [](/ko/actions/how-tos/manage-runners/larger-runners/manage-larger-runners)을 참조 [](/ko/actions/how-tos/manage-runners/self-hosted-runners/add-runners) 하세요.