GitHub 호스팅 러너 사용하기
GitHub 호스팅 러너 사용하기
GitHub이 호스팅하는 가상 머신에서 실행되도록 작업을 할당할 수 있어요. 작업이 시작되면 GitHub이 해당 작업을 위한 새 VM을 자동으로 프로비저닝하고, 작업이 끝나면 자동으로 해제해요.
출처: 문서
본문
GitHub 호스팅 러너 사용하기
GitHub 호스팅 러너를 사용하려면 작업을 만들고 runs-on으로 작업을 처리할 러너 유형을 지정해요(예: ubuntu-latest, windows-latest, macos-latest). 러너 유형의 전체 목록은 GitHub 호스팅 러너 참조를 참고하세요. 저장소에 repo: write 접근 권한이 있다면 저장소의 워크플로에서 사용할 수 있는 러너 목록을 볼 수 있어요. 자세한 내용은 저장소에 사용 가능한 러너 보기를 참고하세요.
작업이 시작되면 GitHub은 그 작업을 위한 새 VM을 자동으로 프로비저닝해요. 작업의 모든 단계는 VM에서 실행되며, 작업의 단계들이 러너의 파일 시스템을 사용해 정보를 공유할 수 있어요. 워크플로를 VM에서 직접 또는 Docker 컨테이너에서 실행할 수 있어요. 작업이 끝나면 VM이 자동으로 해제돼요.
다음 다이어그램은 워크플로의 두 작업이 서로 다른 두 GitHub 호스팅 러너에서 어떻게 실행되는지 보여줘요.

다음 예제 워크플로는 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에서 실행돼요.
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에서 볼 수 있어요:

GitHub Actions 러너 애플리케이션은 오픈소스예요. runner 저장소에 기여하거나 이슈를 제기할 수 있어요.
저장소에 사용 가능한 러너 보기
저장소에 repo: write 접근 권한이 있다면 저장소에 사용 가능한 러너 목록을 볼 수 있어요.
-
GitHub에서 저장소의 메인 페이지로 이동해요.
-
저장소 이름 아래에서 Actions 탭을 클릭해요.

-
왼쪽 사이드바의 "Management" 섹션 아래에서 Runners을 클릭해요.
-
저장소에 사용 가능한 GitHub 호스팅 러너 목록을 검토해요.
-
선택적으로, 워크플로에서 사용할 러너의 레이블을 복사하려면 러너 오른쪽의 케밥(세로 점 3개) 아이콘을 클릭한 다음 Copy label을 클릭해요.
Note
엔터프라이즈 및 조직 소유자는 이 페이지에서 러너를 만들 수 있어요. 새 러너를 만들려면 러너 목록 오른쪽 상단의 New runner을 클릭해 저장소에 러너를 추가할 수 있어요.
자세한 내용은 더 큰 러너 관리하기와 자체 호스팅 러너 추가하기를 참고하세요.