Identificando os executores disponíveis para um repositório
Se você tiver repo: write acesso a um repositório, poderá exibir uma lista dos executores disponíveis para o repositório.
-
Em GitHub, acesse a página principal do repositório.
-
No nome do repositório, clique em Actions.
-
Na barra lateral esquerda, na seção "Management", clique em Runners.
-
Revise a lista de executores disponíveis para o repositório.
-
Opcionalmente, para copiar o rótulo de um corredor para usá-lo em um fluxo de trabalho, clique em à direita do corredor e clique em Copiar rótulo.
Observação
Os proprietários de empresas e organizações e usuários com a permissão "Manage organization runners and runner groups" podem criar executores podem criar novos executores a partir desta página. Para criar um novo executores, clique em Novo executor no canto superior direito da lista de executores para adicionar executores ao repositório.
Para obter mais informações, confira Gerenciar executores maiores e Adicionar executores auto-hospedados. Para obter mais informações sobre funções de organização personalizadas, confira Permissões de funções de organização personalizadas.
Direcionando corredores maiores em um fluxo de trabalho
Depois de identificar os executor avançados que deseja usar, você pode direcioná-los em seu fluxo de trabalho com grupos de executores, rótulos de fluxo de trabalho ou ambos. Use grupos de executores para rotear trabalhos para um conjunto de executores, rótulos de fluxo de trabalho para executores de destino com um rótulo específico ou ambos quando um trabalho deve corresponder às duas condições.
Se um administrador tiver desativado os executores padrão hospedados em GitHub, você poderá usar apenas grupos de executores.
Segmentação por grupo de runners
Faça referência ao nome do grupo de runners no seu fluxo de trabalho. Use isto quando quiser encaminhar uma tarefa para qualquer executor disponível de um grupo específico.
Neste exemplo, foram adicionados executores a um grupo chamado build-runners. A chave runs-on envia o trabalho para qualquer executor disponível no grupo 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
Neste exemplo, foram adicionados executores a um grupo chamado build-runners. A chave runs-on envia o trabalho para qualquer executor disponível no grupo 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
Neste exemplo, a runs-on chave envia o trabalho para qualquer executor disponível no macos-build-runners grupo:
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
Direcionamento por rótulo de fluxo de trabalho
Faça referência a um rótulo de fluxo de trabalho em seu fluxo de trabalho quando quiser rotear um trabalho para os executores que compartilham um rótulo específico.
Executor avançados são atribuídos automaticamente a um rótulo de workflow que corresponde ao nome do runner.
Neste exemplo, a chave runs-on envia o trabalho para qualquer executor disponível ao qual tenha sido atribuído o rótulo 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
Neste exemplo, a chave runs-on envia o trabalho para qualquer executor disponível ao qual tenha sido atribuído o rótulo 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
Para macOS executores avançados, você pode usar tanto os rótulos de fluxo de trabalho definidos em GitHub quanto o rótulo de fluxo de trabalho atribuído automaticamente com base no nome executor avançado que você define quando o cria. Para obter uma lista dos rótulos de fluxo de trabalho do macOS disponíveis, consulte Referência de executores avançados.
Neste exemplo, a runs-on chave envia o trabalho para qualquer executor disponível que tenha recebido o macos-26-xlarge rótulo.
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
Usar rótulos e grupos para controlar onde os trabalhos são executados
Use tanto rótulos quanto grupos quando um trabalho precisar ser executado somente em runners de um grupo específico que também tenham um rótulo específico. O executor deve atender a ambos os requisitos para estar apto a executar a tarefa.
Quando você combina grupos e rótulos, o executor deve atender aos dois requisitos para ser qualificado para executar o trabalho.
Neste exemplo, a runs-on chave combina group e labels , portanto, o trabalho é roteado para qualquer executor disponível dentro do grupo que também tenha um rótulo correspondente:
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
Quando você combina grupos e rótulos, o executor deve atender aos dois requisitos para ser qualificado para executar o trabalho.
Neste exemplo, a runs-on chave combina group e labels , portanto, o trabalho é roteado para qualquer executor disponível dentro do grupo que também tenha um rótulo correspondente:
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
Neste exemplo, a runs-on chave combina group e labels , portanto, o trabalho é roteado para qualquer executor disponível dentro do grupo que também tenha um rótulo correspondente:
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
Leitura adicional
Para obter detalhes de sintaxe da runs-on chave, consulte Sintaxe de fluxo de trabalho para o GitHub Actions.
Para obter especificações, rótulos, limitações e informações de solução de problemas, consulte Referência de executores avançados.