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
para definir o tipo de máquina para executar o trabalho. 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.
Escolhendo executores hospedados em GitHub
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-latest ou windows-2022
|
O rótulo windows-latest usa atualmente a imagem do executor do Windows Server 2022.
|
Windows Server 2019 |
windows-2019
|
|
Ubuntu 22.04 |
ubuntu-22.04
|
O Ubuntu 22,04 está atualmente em beta público. |
Ubuntu 20.04 |
ubuntu-latest ou ubuntu-20.04
|
|
Ubuntu 18.04 |
ubuntu-18.04
|
|
macOS Monterey 12 |
macos-12
|
|
macOS Big Sur 11 |
macos-latest or macos-11
|
A etiqueta macos-latest usa a imagem do executor macOS 11 atualmente.
|
macOS Catalina 10.15 |
macos-10.15
|
Observação: Os -últimos
ambientes virtuais são as últimas imagens estáveis que GitHub fornece, e podem não ser a versão mais recente do sistema operacional disponível no fornecedor do sistema operacional.
Observação: Imagens Beta e Depreciadas são fornecidas "como se apresentam", "com todas as falhas" e "como disponível" e são excluídas da garantia e do contrato de nível de serviço. Imagens Beta podem não estar cobertas pelo suporte ao cliente.
Exemplo: Especificar um sistema operacional
runs-on: ubuntu-latest
Para obter mais informações, consulte "Ambientes virtuais para executores hospedados em GitHub".
Escolhendo executores auto-hospedados
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.
Todos os executores auto-hospedados têm a etiqueta auto-hospedado
. O uso apenas esta etiqueta selecionará qualquer executor auto-hospedado. Para selecionar executores que atendem a certos critérios, como sistema operacional ou arquitetura, recomendamos fornecer uma matriz de etiquetas que começam com auto-hospedado
(isso deve ser listado primeiro) e, em seguida, inclui etiquetas adicionais, conforme necessário. Ao especificar uma matriz de etiquetas, os trabalhos serão colocados na fila em executores que tenham todas as etiquetas especificadas.
Embora a etiqueta de auto-hospedado
não seja obrigatória, recomendamos especificá-lo quando estiver usando executores auto-hospedados para garantir que seu trabalho não especifique nenhum executor atual ou futuro de GitHub.
Exemplo: Usando etiquetas para seleção do executor
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."