Observações:
- As informações e instruções neste artigo aplicam-se apenas a executor maiors com sistemas operacionais Linux e Windows.
- Os executores acionados pelo ARM de GPU estão em versão beta pública e sujeitas a alterações.
Como adicionar um executor maior a uma organização
Os proprietários da organização podem adicionar um executor maior para uma organização controlar os repositórios que podem usá-la. Quando você cria um novo executor para uma organização, por padrão, todos os repositórios na organização têm acesso ao executor. Para limitar quais repositórios podem usar o executor, atribua-o a um grupo de executores com acesso a repositórios específicos. Para obter mais informações, consulte "Como permitir que repositórios acessem executores avançados".
Você pode escolher um sistema operacional e uma configuração de hardware na lista de opções disponíveis. Quando novas instâncias desse executor forem implantadas por meio do dimensionamento automático, elas usarão o mesmo sistema operacional e a mesma configuração de hardware que você definiu aqui.
Novos executores são atribuídos automaticamente ao grupo padrão, ou você pode escolher em qual grupo os executores devem ingressar durante o processo de criação dos executores. Além disso, você pode modificar a associação ao grupo do executor depois de registrá-lo. Para obter mais informações, confira "Como controlar o acesso a executores maiores".
-
No GitHub.com, navegue até a página principal da organização.
-
No nome da sua organização, clique Configurações. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.
-
Na barra lateral esquerda, clique em Ações e clique em Executores.
-
Clique em Novo executor e clique em Novo executor hospedado no GitHub .
-
Preencha os detalhes obrigatórios para configurar seu novo executor:
- Nome: insira um nome para seu novo executor. Para facilitar a identificação, esse campo deve indicar o hardware e configuração operacional, como
ubuntu-20.04-16core
. - Plataforma: Escolha uma plataforma entre as opções disponíveis. Depois de selecionar uma plataforma, você poderá escolher uma imagem específica.
- Imagem: Escolha uma imagem entre as opções disponíveis. Depois de selecionar uma imagem, você poderá escolher um tamanho específico.
- Propriedade do GitHub: para imagens gerenciadas pelo GitHub, selecione uma imagem nesta guia.
- Parceiro: para imagens gerenciadas por um parceiro, selecione uma imagem nessa guia. As imagens otimizadas para GPU e área de trabalho de Windows 11 estão localizadas nessa guia.
- Tamanho: escolha uma configuração de hardware na lista de opções disponíveis. Os tamanhos disponíveis dependem da imagem selecionada em uma etapa anterior. Para executores de GPU, selecione um tamanho na guia baseados em GPU.
- Simultaneidade máxima: escolha o número máximo de trabalhos que podem estar ativos a qualquer momento.
- Grupo do executor: escolha o grupo do qual seu executor será membro. Esse grupo hospedará várias instâncias do seu executor, à medida que elas escalarem verticalmente para atender à demanda.
Nota: Os nomes de executores avançados podem ditar sua funcionalidade. Por exemplo, para usar uma configuração padrão executor maior para code scanning, o executor deve se chamar
code-scanning
. Para obter mais informações sobre code scanning com executores avançados, consulte "Configurando executores maiores para configuração padrão". - Nome: insira um nome para seu novo executor. Para facilitar a identificação, esse campo deve indicar o hardware e configuração operacional, como
-
Clique em Criar executor.
-
Para permitir que os repositórios acessem seus executor maiors, adicione-os à lista de repositórios que podem usá-los. Para obter mais informações, confira "Como permitir que os repositórios acessem executor maiors".
Permitir que os repositórios acessem executor maiors
Os repositórios recebem acesso a executor maiors por meio de grupos de executores. Os administradores corporativos podem escolher quais organizações recebem acesso a grupos de executores de nível empresarial, e os proprietários da organização controlam o acesso no nível do repositório a todos os executor maiors.
Os proprietários da organização podem usar e configurar grupos de executores de nível empresarial para os repositórios em sua organização ou podem criar grupos de executores de nível organizacional para controlar o acesso.
- Para grupos de executores de nível empresarial: Por padrão, os repositórios na organização não têm acesso a grupos de executores de nível empresarial. Para fornecer aos repositórios acesso aos grupos de executores corporativos, os proprietários da organização devem configurar cada grupo de executores corporativos e escolher quais repositórios têm acesso.
- Para grupos de executores no nível da organização: Por padrão, todos os repositórios em uma organização recebem acesso aos grupos de executores no nível da organização. Para restringir quais repositórios têm acesso, os proprietários da organização configurar grupos de executores da organização e escolher quais repositórios têm acesso.
Depois que um repositório tiver acesso a executor maiors, os dados dos executor maiors poderão ser adicionados aos arquivos de fluxo de trabalho. Para obter mais informações, confira "Como executar trabalhos em executores maiores".
- Acesse a página principal da organização em que os grupos de executores estão localizados.
- Clique em Configurações.
- Na barra lateral esquerda, clique em Ações e escolha Grupos de executores.
- Selecione um grupo de executores de qualquer lista na página. Os grupos de executores no nível da organização são listados na parte superior da página e os grupos de executores no nível da empresa são listados em "Compartilhados pela empresa".
- Na página do grupo de executores, em "Acesso ao repositório", selecione Todos os repositórios ou Repositórios selecionados. Se você optar por conceder acesso a repositórios específicos, clique em e selecione os repositórios aos quais deseja conceder acesso na lista.
Aviso:
Se você estiver usando um intervalo de IP fixo, a recomendação será usar apenas executor maior com repositórios particulares. Bifurcações do seu repositório podem executar códigos perigosos em seu executor maior criando uma solicitação de pull que executa o código em um fluxo de trabalho.
Para obter mais informações, confira "Como controlar o acesso a executores maiores".
Alterar o nome de um executor maior
Nota: Os nomes de executores avançados podem ditar sua funcionalidade. Por exemplo, para usar uma configuração padrão executor maior para code scanning, o executor deve se chamar code-scanning
. Para obter mais informações sobre code scanning com executores avançados, consulte "Configurando executores maiores para configuração padrão".
-
No GitHub.com, navegue até a página principal da organização.
-
No nome da sua organização, clique Configurações. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.
-
Na barra lateral esquerda, clique em Ações e clique em Executores.
-
Na lista correspondente, selecione o executor que você deseja editar.
-
Insira um nome para o executor no campo de texto "Nome".
-
Clique em Save (Salvar).
Configurar autodimensionamento para executor maiors
Você pode controlar o número máximo de trabalhos permitidos para execução simultânea para conjuntos de executores específicos. Definir esse campo como um valor mais alto pode ajudar a impedir que os fluxos de trabalho sejam bloqueados devido ao paralelismo.
-
No GitHub.com, navegue até a página principal da organização.
-
No nome da sua organização, clique Configurações. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.
-
Na barra lateral esquerda, clique em Ações e clique em Executores.
-
Na lista correspondente, selecione o executor que você deseja editar.
-
Na seção "Dimensionamento automático", em "Simultaneidade Máxima do Trabalho", insira o número máximo de trabalhos que você deseja permitir que sejam executados ao mesmo tempo.
-
Clique em Save (Salvar).
Criar endereços IP estáticos para executor maiors
Observação: para usar o logon único do SAML, sua organização precisa usar o GitHub Enterprise Cloud. Para obter mais informações sobre como você pode experimentar o GitHub Enterprise Cloud gratuitamente, confira "Como configurar uma avaliação do GitHub Enterprise Cloud".
Você pode habilitar endereços IP estáticos para executor maiors. Quando você faz isso, os dados de executor maiors recebem intervalos de endereços IP estáticos. Por padrão, você pode configurar até 10 executor maiors diferentes com intervalos de IP para sua conta. Para usar mais de 10 executores maiores com intervalos de endereços IP estáticos, entre em contato com conosco por meio do Portal de suporte do GitHub.
O número de endereços IP disponíveis nos intervalos atribuídos não restringe o número de trabalhos simultâneos especificados para dimensionamento automático. Dentro de um pool de executores, há um balanceador de carga que permite a reutilização alta dos endereços IP nos intervalos atribuídos. Isso garante que seus fluxos de trabalho possam ser executados simultaneamente em escala enquanto cada computador recebe um endereço IP estático.
-
No GitHub.com, navegue até a página principal da organização.
-
No nome da sua organização, clique Configurações. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.
-
Na barra lateral esquerda, clique em Ações e clique em Executores.
-
Na lista correspondente, selecione o executor que você deseja editar.
-
Para atribuir endereços IP estáticos ao executor, em "Rede", marque Atribuir intervalos de endereços IP público estáticos e exclusivo para esse executor.
-
Clique em Save (Salvar).