Observação: Executores hospedados em GitHub não são atualmente compatíveis com GitHub Enterprise Server. Você pode ver mais informações sobre suporte futuro planejado no Itinerário público do GitHub.
Visão Geral
Use jobs.<job_id>.runs-on to define the type of machine to run the job on. Você pode fornecer runs-on como uma única string ou como uma matriz de strings. Se você especificar uma matriz de strings, o seu fluxo de trabalho será executado em um executor auto-hospedado cujas etiquetas correspondam a todos os valores de runs-on, se disponível. Se você quiser executar seu fluxo de trabalho em várias máquinas, use jobs.<job_id>.strategy.
Observação: Executores hospedados em GitHub não são atualmente compatíveis com GitHub Enterprise Server. Você pode ver mais informações sobre suporte futuro planejado no Itinerário público do GitHub.
Choosing GitHub-hosted runners
Se você usar um executor hospedado no GitHub, cada trabalho será executado em uma nova instância de um ambiente virtual especificado por runs-on.
Os tipos de executor disponíveis para GitHub são:
| Ambiente virtual | Etiqueta de fluxo de trabalho YAML | Observações |
|---|---|---|
| Windows Server 2022 |
windows-2022
|
The windows-latest label currently uses the Windows Server 2019 runner image.
|
| Windows Server 2019 |
windows-latest ou windows-2019
|
|
| Windows Server 2016[deprecated] |
windows-2016
|
Migrate to Windows 2019 or Windows 2022. For more information, see the blog post. |
| Ubuntu 20.04 |
ubuntu-latest ou ubuntu-20.04
|
|
| Ubuntu 18.04 |
ubuntu-18.04
|
|
| macOS Big Sur 11 |
macos-latest or macos-11
|
The macos-latest label currently uses the macOS 11 runner image.
|
| macOS Catalina 10.15 |
macos-10.15
|
Note: The -latest virtual environments are the latest stable images that GitHub provides, and might not be the most recent version of the operating system available from the operating system vendor.
Note: Beta and Deprecated Images are provided "as-is", "with all faults" and "as available" and are excluded from the service level agreement and warranty. Beta Images may not be covered by customer support.
Example: Specifying an operating system
runs-on: ubuntu-latest
Para obter mais informações, consulte "Ambientes virtuais para executores hospedados em GitHub".
Choosing self-hosted runners
Para especificar um executor auto-hospedado para o seu trabalho, configure runs-on no seu arquivo de fluxo de trabalho com etiquetas de executores auto-hospedados.
All self-hosted runners have the self-hosted label. Using only this label will select any self-hosted runner. To select runners that meet certain criteria, such as operating system or architecture, we recommend providing an array of labels that begins with self-hosted (this must be listed first) and then includes additional labels as needed. When you specify an array of labels, jobs will be queued on runners that have all the labels that you specify.
Although the self-hosted label is not required, we strongly recommend specifying it when using self-hosted runners to ensure that your job does not unintentionally specify any current or future GitHub-hosted runners.
Example: Using labels for runner selection
runs-on: [self-hosted, linux]
Para obter mais informações, consulte "Sobre executores auto-hospedados" e "Usar executores auto-hospedados em um fluxo de trabalho."