리포지토리에 사용 가능한 실행기 식별
리포지토리에 repo: write 액세스 권한이 있는 경우 리포지토리에서 사용할 수 있는 실행기 목록을 볼 수 있습니다.
-
GitHub에서 리포지토리의 기본 페이지로 이동합니다.
-
리포지토리 이름에서 작업을 클릭합니다.
-
왼쪽 사이드바의 "Management" 섹션에서 Runners를 클릭합니다.
-
리포지토리에 사용할 수 있는 실행기 목록을 검토합니다.
-
실행기 레이블을 복사사하여 워크플로에서 사용하려면, 실행기 오른쪽에 있는 을 클릭한 다음 레이블 복사를 클릭합니다.
참고
엔터프라이즈와 조직 소유자 및 “조직 실행기와 실행기 그룹 관리” 권한을 가진 사용자는 이 페이지에서 새 실행기를 만들 수 있습니다. 새 실행기를 만들려면 실행기 목록의 오른쪽 상단에 있는 새 실행기를 클릭하여 리포지토리에 실행기를 추가합니다.
자세한 내용은 대형 런너 관리하기 및 자체 호스트형 실행기 추가를 참조하세요. 사용자 지정 조직 역할에 대한 자세한 내용은 사용자 지정 조직 역할의 권한를 참조하세요.
워크플로에서 대형 러너 지정하기
사용하려는 항목을 식별 더 큰 실행기한 후 실행기 그룹, 워크플로 레이블 또는 둘 다를 사용하여 워크플로에서 대상으로 지정할 수 있습니다. 실행기 그룹을 사용하여 작업을 실행기 집합으로 라우팅하거나, 워크플로 레이블을 사용하여 특정 레이블이 있는 실행기를 대상으로 지정하거나, 작업이 두 조건 모두와 일치해야 하는 경우 둘 다 라우팅합니다.
관리자가 표준 GitHub호스팅 실행기를 사용하지 않도록 설정한 경우 실행기 그룹만 사용할 수 있습니다.
실행기 그룹별 대상 지정
워크플로에서 실행기 그룹 이름을 참조하십시오. 특정 그룹의 사용 가능한 실행기로 작업을 라우팅하려는 경우 이를 사용합니다.
이 예제에서는 러너가 build-runners라는 그룹에 추가되었습니다.
runs-on 키는 build-runners 그룹에서 사용 가능한 모든 실행기로 작업을 보냅니다.
name: learn-github-actions
on: [push]
jobs:
check-bats-version:
runs-on:
group: build-runners
steps:
- uses: actions/checkout@v6
- uses: actions/setup-node@v4
with:
node-version: '14'
- run: npm install -g bats
- run: bats -v
이 예제에서는 러너가 build-runners라는 그룹에 추가되었습니다.
runs-on 키는 build-runners 그룹에서 사용 가능한 모든 실행기로 작업을 보냅니다.
name: learn-github-actions
on: [push]
jobs:
check-bats-version:
runs-on:
group: build-runners
steps:
- uses: actions/checkout@v6
- uses: actions/setup-node@v4
with:
node-version: '14'
- run: npm install -g bats
- run: bats -v
이 예제에서 runs-on 키는 macos-build-runners 그룹에서 사용 가능한 실행기 중 하나로 작업을 전송합니다.
name: learn-github-actions
on: [push]
jobs:
check-swift-version:
runs-on:
group: macos-build-runners
steps:
- uses: actions/checkout@v6
- name: Build
run: swift build
- name: Run tests
run: swift test
워크플로 레이블별 대상 지정
특정 레이블을 공유하는 실행기로 작업을 라우팅하려는 경우 워크플로에서 워크플로 레이블을 참조합니다.
대형 러너들은 러너 이름과 일치하는 워크플로 레이블이 자동으로 할당됩니다.
이 예제에서 runs-on 키는 ubuntu-24.04-16core 레이블이 할당된 사용 가능한 모든 실행기로 작업을 보냅니다.
name: learn-github-actions
on: [push]
jobs:
check-bats-version:
runs-on:
labels: ubuntu-24.04-16core
steps:
- uses: actions/checkout@v6
- uses: actions/setup-node@v4
with:
node-version: '14'
- run: npm install -g bats
- run: bats -v
이 예제에서 runs-on 키는 windows-2022-16core 레이블이 할당된 사용 가능한 모든 실행기로 작업을 보냅니다.
name: learn-github-actions
on: [push]
jobs:
check-bats-version:
runs-on:
labels: windows-2022-16core
steps:
- uses: actions/checkout@v6
- uses: actions/setup-node@v4
with:
node-version: '14'
- run: npm install -g bats
- run: bats -v
macOS 대형 러너의 경우, GitHub에서 정의된 워크플로 레이블 또는 생성할 때 설정한 더 큰 실행기 이름에서 자동으로 할당된 워크플로 레이블을 사용할 수 있습니다. 사용 가능한 macOS 워크플로 레이블 목록은 대형 실행기 참조을 참조하세요.
이 예제에서 runs-on 키는 macos-26-xlarge 레이블이 할당된 사용 가능한 모든 실행기로 작업을 보냅니다.
name: learn-github-actions
on: [push]
jobs:
check-swift-version:
runs-on: macos-26-xlarge
steps:
- uses: actions/checkout@v6
- name: Build
run: swift build
- name: Run tests
run: swift test
레이블 및 그룹을 사용하여 작업 실행 위치 제어
특정 레이블이 있는 특정 그룹의 실행기에서만 작업을 실행해야 하는 경우 레이블과 그룹을 모두 사용합니다. 러너는 작업을 실행할 자격을 얻으려면 두 가지 요구 사항을 모두 충족해야 합니다.
그룹과 레이블을 결합할 때, 러너는 작업을 실행할 수 있는 자격을 얻기 위해 두 가지 요구 사항을 모두 충족해야 합니다.
이 예제에서는 runs-on 키가 group와 labels를 결합하여, 일치하는 레이블도 가진 그룹 내의 사용 가능한 러너 중 하나로 작업이 라우팅되도록 합니다.
name: learn-github-actions
on: [push]
jobs:
check-bats-version:
runs-on:
group: ubuntu-runners
labels: ubuntu-24.04-16core
steps:
- uses: actions/checkout@v6
- uses: actions/setup-node@v4
with:
node-version: '14'
- run: npm install -g bats
- run: bats -v
그룹과 레이블을 결합할 때, 러너는 작업을 실행할 수 있는 자격을 얻기 위해 두 가지 요구 사항을 모두 충족해야 합니다.
이 예제에서는 runs-on 키가 group와 labels를 결합하여, 일치하는 레이블도 가진 그룹 내의 사용 가능한 러너 중 하나로 작업이 라우팅되도록 합니다.
name: learn-github-actions
on: [push]
jobs:
check-bats-version:
runs-on:
group: ubuntu-runners
labels: ubuntu-24.04-16core
steps:
- uses: actions/checkout@v6
- uses: actions/setup-node@v4
with:
node-version: '14'
- run: npm install -g bats
- run: bats -v
이 예제에서는 runs-on 키가 group와 labels를 결합하여, 일치하는 레이블도 가진 그룹 내의 사용 가능한 러너 중 하나로 작업이 라우팅되도록 합니다.
name: learn-github-actions
on: [push]
jobs:
check-swift-version:
runs-on:
group: macos-runners
labels: macos-26-xlarge
steps:
- uses: actions/checkout@v6
- name: Build
run: swift build
- name: Run tests
run: swift test
추가 읽기
키에 대한 runs-on 구문 세부 정보는 GitHub Actions에 대한 워크플로 구문을 참조하세요.
사양, 레이블, 제한 사항 및 문제 해결 정보는 대형 실행기 참조을 참조하세요.