Gerenciar executores maiores

Como adicionar um executor maior a uma empresa

Os proprietários corporativos podem adicionar executor maiors a uma empresa e atribuí-los a organizações. Por padrão, quando um executor maior é criado para uma empresa, ele é adicionado a um grupo de executores padrão ao qual todas as organizações da empresa têm acesso. Embora todas as organizações tenham acesso ao executor, os repositórios em cada organização não recebem acesso. Em cada organização, um proprietário da organização deve configurar o grupo de executores para especificar quais repositórios têm acesso ao executor corporativo. Para obter mais informações, confira Como permitir que os repositórios acessem executor maiors.

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".

1. No canto superior direito do GitHub, selecione sua foto de perfil.

2. Dependendo do ambiente, selecione Sua empresa ou Suas empresas e escolha a empresa que deseja ver.

3. Do lado esquerdo da página, na barra lateral da conta empresarial, clique em Políticas.

4. Em " Políticas", clique em Ações.

5. Clique na guia Executores.

6. Clique em Novo executor e clique em Novo executor hospedado no GitHub.

7. 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.

   • Rede: escolha se intervalos de endereços IP estáticos serão atribuídos a instâncias de executor maior. Você pode usar até 10 executor maiors com intervalos de endereços IP estáticos no total.

   Note

   Os nomes dos 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".

8. Clique em Criar executor.

9. Para permitir que as organizações acessem seus executor maior, especifique quais organizações podem podem usar o grupo de executores ao qual o executor está designado. Para obter mais informações, confira "Como controlar o acesso a executores maiores".

Como adicionar um executor maior a uma organização

Os proprietários da organização e os usuários com a permissão "Gerenciar executores e grupos de executores 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".

1. Em GitHub, acesse a página principal da organização.

2. 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.

   

3. Na barra lateral esquerda, clique em Ações e clique em Executores.

4. Clique em Novo executor e clique em Novo executor hospedado no GitHub.

5. 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.

   • Rede: escolha se intervalos de endereços IP estáticos serão atribuídos a instâncias de executor maior. Você pode usar até 10 executor maiors com intervalos de endereços IP estáticos no total.

   Note

   Os nomes dos 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".

6. Clique em Criar executor.

7. 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 e usuários com a permissão "Gerenciar executores e grupos de executores 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. Os usuários com a opção "Gerenciar executores e grupos de executores da organização" só podem gerenciar grupos de corredores no nível da organização. Para saber mais, confira Sobre as funções da organização personalizadas.

• 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 e os usuários com a permissão "Gerenciar executores e grupos de executores 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 saber mais, confira Como executar trabalhos em executores maiores.

1. Acesse a página principal da organização em que os grupos de executores estão localizados.
2. Clique em Settings.
3. Na barra lateral esquerda, clique em Ações e escolha Grupos de executores.
4. 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".
5. 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.

Alterar o nome de um executor maior

Você pode editar o nome dos dados do executor maiors.

• Alterar o nome de um executor da organização
• Alterar o nome de um executor corporativo

Alterar o nome de um executor da organização

1. Em GitHub, acesse a página principal da organização.

2. 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.

   

3. Na barra lateral esquerda, clique em Ações e clique em Executores.

4. Na lista correspondente, selecione o executor que você deseja editar.

5. Insira um nome para o executor no campo de texto "Nome".

6. Clique em Save (Salvar).

Alterar o nome de um executor corporativo

1. No canto superior direito do GitHub, selecione sua foto de perfil.
2. Dependendo do ambiente, selecione Sua empresa ou Suas empresas e escolha a empresa que deseja ver.
3. Do lado esquerdo da página, na barra lateral da conta empresarial, clique em Políticas.
4. Em " Políticas", clique em Ações.
5. Clique na guia Executores.
6. Na lista correspondente, selecione o executor que você deseja editar.
7. Insira um nome para o executor no campo de texto "Nome".
8. 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.

• Configurar o dimensionamento automático para um executor da organização
• Configurar o dimensionamento automático para um executor corporativo

Configurar o dimensionamento automático para um executor da organização

1. Em GitHub, acesse a página principal da organização.

2. 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.

   

3. Na barra lateral esquerda, clique em Ações e clique em Executores.

4. Na lista correspondente, selecione o executor que você deseja editar.

5. 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.

6. Clique em Save (Salvar).

Configurar o dimensionamento automático para um executor corporativo

1. No canto superior direito do GitHub, selecione sua foto de perfil.
2. Dependendo do ambiente, selecione Sua empresa ou Suas empresas e escolha a empresa que deseja ver.
3. Do lado esquerdo da página, na barra lateral da conta empresarial, clique em Políticas.
4. Em " Políticas", clique em Ações.
5. Clique na guia Executores.
6. Na lista correspondente, selecione o executor que você deseja editar.
7. 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.
8. Clique em Save (Salvar).

Criar endereços IP estáticos para executor maiors

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. Todos os endereços IP no intervalo atribuído são utilizáveis e não estão na notação CIDR. 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.

• Criar endereços IP estáticos para executores da organização
• Criar endereços IP estáticos para executores corporativos

Criar endereços IP estáticos para executores da organização

1. Em GitHub, acesse a página principal da organização.

2. 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.

   

3. Na barra lateral esquerda, clique em Ações e clique em Executores.

4. Na lista correspondente, selecione o executor que você deseja editar.

5. 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.

6. Clique em Save (Salvar).

Criar endereços IP estáticos para executores corporativos

1. No canto superior direito do GitHub, selecione sua foto de perfil.
2. Dependendo do ambiente, selecione Sua empresa ou Suas empresas e escolha a empresa que deseja ver.
3. Do lado esquerdo da página, na barra lateral da conta empresarial, clique em Políticas.
4. Em " Políticas", clique em Ações.
5. Clique na guia Executores.
6. Na lista correspondente, selecione o executor que você deseja editar.
7. 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.
8. Clique em Save (Salvar).