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 호스팅 러너에서 어떻게 실행되는지 보여줘요.

두 작업으로 구성된 워크플로 다이어그램. 한 작업은 Ubuntu에서, 다른 작업은 Windows에서 실행돼요.

다음 예제 워크플로는 Run-npm-on-UbuntuRun-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에서 볼 수 있어요:

"Run PSScriptAnalyzer on Windows" 작업의 단계가 표시된 워크플로 실행 스크린샷.

GitHub Actions 러너 애플리케이션은 오픈소스예요. runner 저장소에 기여하거나 이슈를 제기할 수 있어요.

저장소에 사용 가능한 러너 보기

저장소에 repo: write 접근 권한이 있다면 저장소에 사용 가능한 러너 목록을 볼 수 있어요.

  1. GitHub에서 저장소의 메인 페이지로 이동해요.

  2. 저장소 이름 아래에서 Actions 탭을 클릭해요.

    "github/docs" 저장소의 탭 스크린샷. "Actions" 탭이 주황색 윤곽선으로 강조되어 있어요.

  3. 왼쪽 사이드바의 "Management" 섹션 아래에서 Runners을 클릭해요.

  4. 저장소에 사용 가능한 GitHub 호스팅 러너 목록을 검토해요.

  5. 선택적으로, 워크플로에서 사용할 러너의 레이블을 복사하려면 러너 오른쪽의 케밥(세로 점 3개) 아이콘을 클릭한 다음 Copy label을 클릭해요.

Note

엔터프라이즈 및 조직 소유자는 이 페이지에서 러너를 만들 수 있어요. 새 러너를 만들려면 러너 목록 오른쪽 상단의 New runner을 클릭해 저장소에 러너를 추가할 수 있어요.

자세한 내용은 더 큰 러너 관리하기자체 호스팅 러너 추가하기를 참고하세요.