{"meta":{"title":"GitHub 호스팅 러너 사용","intro":"GitHub에서 호스팅하는 가상 머신에서 실행되도록 작업을 할당할 수 있습니다.","product":"GitHub Actions","breadcrumbs":[{"href":"/ko/actions","title":"GitHub Actions"},{"href":"/ko/actions/how-tos","title":"사용법"},{"href":"/ko/actions/how-tos/manage-runners","title":"실행기 관리"},{"href":"/ko/actions/how-tos/manage-runners/github-hosted-runners","title":"GitHub 호스팅 실행기"},{"href":"/ko/actions/how-tos/manage-runners/github-hosted-runners/use-github-hosted-runners","title":"GitHub 호스팅 러너 사용"}],"documentType":"article"},"body":"# GitHub 호스팅 러너 사용\n\nGitHub에서 호스팅하는 가상 머신에서 실행되도록 작업을 할당할 수 있습니다.\n\n## GitHub호스팅된 러너 사용\n\nGitHub호스팅 실행기를 사용하려면 작업을 만들고 `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)을(를) 참조하세요.\n\n작업이 시작 GitHub 되면 해당 작업에 대한 새 VM을 자동으로 프로비전합니다. 모든 단계는 해당 작업 내에서 VM에서 실행되므로, 실행기의 파일 체계를 통해 정보를 공유할 수 있습니다. VM 또는 Docker 컨테이너에서 직접 워크플로를 실행할 수 있습니다. 작업이 완료되면 VM이 자동으로 서비스 해제됩니다.\n\n다음 다이어그램에서는 워크플로의 두 작업이 서로 다른 GitHub두 개의 호스트된 실행기에서 실행되는 방법을 보여 줍니다.\n\n![두 개의 작업으로 구성된 워크플로의 다이어그램. 한 작업은 Ubuntu에서 실행되고 다른 작업은 Windows에서 실행됩니다.](/assets/images/help/actions/overview-github-hosted-runner.png)\n\n예시된 다음 워크플로에는 `Run-npm-on-Ubuntu`, `Run-PSScriptAnalyzer-on-Windows` 두 개의 작업이 있습니다. 이 워크플로가 트리거되면 GitHub 각 작업에 대해 새 가상 머신을 프로비전합니다.\n\n* 이름이 `Run-npm-on-Ubuntu`인 작업은 작업의 `runs-on:`이 `ubuntu-latest`를 지정하므로 Linux VM에서 실행됩니다.\n* 이름이 `Run-PSScriptAnalyzer-on-Windows`인 작업은 작업의 `runs-on:`가 `windows-latest`를 지정하므로 Windows VM에서 실행됩니다.\n\n```yaml copy\nname: Run commands on different operating systems\non:\n  push:\n    branches: [ main ]\n  pull_request:\n    branches: [ main ]\n\njobs:\n  Run-npm-on-Ubuntu:\n    name: Run npm on Ubuntu\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions/checkout@v6\n      - uses: actions/setup-node@v7\n        with:\n          node-version: '14'\n      - run: npm help\n\n  Run-PSScriptAnalyzer-on-Windows:\n    name: Run PSScriptAnalyzer on Windows\n    runs-on: windows-latest\n    steps:\n      - uses: actions/checkout@v6\n      - name: Install PSScriptAnalyzer module\n        shell: pwsh\n        run: |\n          Set-PSRepository PSGallery -InstallationPolicy Trusted\n          Install-Module PSScriptAnalyzer -ErrorAction Stop\n      - name: Get list of rules\n        shell: pwsh\n        run: |\n          Get-ScriptAnalyzerRule\n```\n\n작업이 실행되는 동안 GitHub UI에서 로그 및 출력 내용을 볼 수 있습니다.\n\n![워크플로 실행의 스크린샷. \"Windows에서 PSScriptAnalyzer 실행\" 작업의 단계가 표시되어 있습니다.](/assets/images/help/repository/actions-runner-output.png)\n\nGitHub Actions 실행기 애플리케이션이 오픈 소스입니다. [실행기](https://github.com/actions/runner) 리포지토리에서 기여하고 문제를 제출할 수 있습니다.\n\n## 리포지토리에서 이용 가능한 러너 확인하기\n\n리포지토리에 `repo: write` 액세스 권한이 있는 경우 리포지토리에서 사용할 수 있는 실행기 목록을 볼 수 있습니다.\n\n1. GitHub에서 리포지토리의 기본 페이지로 이동합니다.\n2. 리포지토리 이름에서 **<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> 작업**을 클릭합니다.\n\n   ![\"github/docs\" 리포지토리의 탭 스크린샷. \"작업\" 탭은 주황색 윤곽선으로 강조 표시됩니다.](/assets/images/help/repository/actions-tab-global-nav-update.png)\n3. 왼쪽 사이드바의 \"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**를 클릭합니다.\n4. 리포지토리에 사용할 수 있는 GitHub 호스팅 실행기 목록을 검토합니다.\n5. 실행기 레이블을 복사사하여 워크플로에서 사용하려면, 실행기 오른쪽에 있는 <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>을 클릭한 다음 **레이블 복사**를 클릭합니다.\n\n> \\[!NOTE]\n> 엔터프라이즈 및 조직 소유자는 이 페이지에서 실행기를 생성할 수 있습니다. 새 실행기를 만들려면 실행기 목록의 오른쪽 상단에 있는 **새 실행기**를 클릭하여 리포지토리에 실행기를 추가합니다.\n>\n> 자세한 내용은  및 [](/ko/actions/how-tos/manage-runners/larger-runners/manage-larger-runners)을 참조 [](/ko/actions/how-tos/manage-runners/self-hosted-runners/add-runners) 하세요."}