より大きなランナーでジョブを実行する

使用可能な より大きなランナーを特定し、ランナー グループとワークフロー ラベルを使用して適切なランナーにジョブをルーティングします。

この機能を使用できるユーザーについて

より大きなランナー は、GitHub Team または GitHub Enterprise Cloud プランを使っている組織とエンタープライズのみが使用できます。

Platform navigation

この記事で

リポジトリで使用可能なランナーの識別

リポジトリに repo: write アクセス許可を持つ場合は、リポジトリで使用できるランナーの一覧が表示されます。

  1. GitHub で、リポジトリのメイン ページに移動します。

  2. リポジトリ名の下にある [ Actions] をクリックします。

    "github/docs" リポジトリのタブのスクリーンショット。 [アクション] タブがオレンジ色の枠線で強調表示されています。

  3. 左側のサイドバーの [Management] セクションで、 [Runners] をクリックします。

  4. リポジトリで使用可能なランナーの一覧を確認します。

  5. 必要に応じて、ランナーのラベルをコピーしてワークフローで使用するには、ランナーの右側にある をクリックし、[ラベルのコピー] をクリックします。

メモ

Enterprise と organization の所有者、および "organization ランナーとランナー グループの管理" アクセス許可を持つユーザーは、このページからランナーを作成できます。 新しいランナーを作成するには、ランナーの一覧の右上にある [新しいランナー] をクリックして、リポジトリにランナーを追加します。

詳細は、「より大きなランナーを管理する」および「自己ホストランナーの追加」を参照してください。 Organization のカスタム ロールについて詳しくは、「カスタム組織ロールの権限」をご覧ください。

ワークフロー内の大規模なランナーをターゲットにする

使用する より大きなランナーを特定したら、ランナー グループ、ワークフロー ラベル、またはその両方を使用して、ワークフロー内でそれらをターゲットにすることができます。 ランナー グループを使用して、一連のランナーにジョブをルーティングするか、ワークフロー ラベルを使用して特定のラベルを持つランナーをターゲットにするか、ジョブが両方の条件と一致する必要がある場合の両方をルーティングします。

管理者が標準の 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 より大きなランナー (larger runner)の場合は、 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 キーの構文の詳細については、AUTOTITLE を参照してください。

仕様、ラベル、制限事項、トラブルシューティング情報については、 ラージャー ランナー リファレンス を参照してください。