Gerenciando o acesso aos executores auto-hospedados usando grupos

Sobre grupos de executores auto-hospedados

Grupos de executores auto-hospedados são usados para controlar o acesso a executores auto-hospedados a nível da organização e da empresa. Os administradores da empresa podem configurar políticas de acesso que controlam quais organizações em uma empresa têm acesso ao grupo de runner. Os administradores da organização podem configurar políticas de acesso que controlam quais repositórios em uma organização têm acesso ao grupo de runner.

Quando um administrador da empresa concede acesso de uma organização a um grupo de runner, os administradores da organização podem ver o grupo de runner listado nas configurações do runner auto-hospedado da organização. Os administradores de organizações podem então atribuir políticas adicionais de acesso ao repositório granular para o grupo de executores empresariais.

Quando novos executores são criados, eles são atribuídos automaticamente ao grupo-padrão. Os executores só podem estar em um grupo por vez. Você pode mover os executores do grupo-padrão para outro grupo. Para obter mais informações, consulte "Mover um executorauto-hospedado para um grupo".

Criar um grupo de executor auto-hospedado para uma organização

Todas as organizações têm um único grupo de executores auto-hospedados padrão. As organizações dentro de uma conta corporativa podem criar outros grupos auto-hospedados. Os administradores da organização podem permitir o acesso de repositórios individuais a um grupo de executor. Para obter informações sobre como criar um grupo de executores auto-hospedados com a API REST, consulte "grupos de executores auto-hospedados."

Os executores auto-hospedados são automaticamente atribuídos ao grupo-padrão quando criados e só podem ser membros de um grupo por vez. Você pode mover um executor do grupo- padrão para qualquer grupo que você criar.

Ao criar um grupo, você deverá escolher uma política que defina quais repositórios têm acesso ao grupo do executor.

1. No your GitHub Enterprise Server instance, navegue para a página principal da organização.

2. Abaixo do nome da sua organização, clique em Settings.

   

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

4. Em "Executores auto-hospedados", clique em Adicionar novo e, em seguida, Novo grupo.

   

5. Insira um nome para o seu grupo de executor e atribua uma política para acesso ao repositório.

   Você pode configurar um grupo de executores para poder ser acessado por uma lista específica de repositórios ou por todos os repositórios na organização. Por padrão, apenas repositórios privados podem acessar executores em um grupo de executores, mas você pode substituir isso. Esta configuração não pode ser substituída se configurar o grupo de executores da organização que foi compartilhado por uma empresa.

   Aviso

   Recomendamos que você use apenas executores auto-hospedados com repositórios privados. Isso acontece porque as bifurcações do seu repositório podem potencialmente executar código perigoso na sua máquina de executor auto-hospedada criando um pull request que executa o código em um fluxo de trabalho.

   Para obter mais informações, consulte "Sobre os executores auto-hospedados."

   

6. Clique em Salvar grupo para criar o grupo e aplicar a política.

Criar um grupo de executor auto-hospedado para uma empresa

As empresas podem adicionar seus executores auto-hospedados a grupos para gerenciamento de acesso. As empresas podem criar grupos de executores auto-hospedados acessíveis a organizações específicas na conta corporativa. Os administradores da organização podem atribuir políticas adicionais granulares de acesso ao repositório para os grupos de executores corporativos. Para obter informações sobre como criar um grupo de executores auto-hospedados com a API REST, consulte os pontos de extremidade corporativos na API REST de GitHub Actions.

Os executores auto-hospedados são automaticamente atribuídos ao grupo-padrão quando criados e só podem ser membros de um grupo por vez. Você pode atribuir o executor a um grupo específico durante o processo de registro, ou você pode mover o executor do grupo-padrão para um grupo personalizado.

Ao criar um grupo, você deve escolher uma política que defina quais organizações têm acesso ao grupo de executores.

1. No canto superior direito de GitHub Enterprise Server, clique na sua foto de perfil e, em seguida, clique em Configurações da empresa.

2. Na barra lateral da conta corporativa, clique em Policies.

3. Em " Policies (Políticas)", clique em Actions (Ações).

4. Clique na aba Executores auto-hospedados .

5. Clique em Adicionar novo e, em seguida, Novo grupo.

   

6. Insira um nome para o seu grupo de executor e atribua uma política para acesso �  organização.

   Você pode configurar um grupo de executores para que possa ser acessado por uma lista específica de organizações ou por todas as organizações da empresa. Por padrão, apenas repositórios privados podem acessar executores em um grupo de executores, mas você pode substituir isso. This setting can't be overridden if configuring an organization's runner group that was shared by an enterprise.

   Aviso

   Recomendamos que você use apenas executores auto-hospedados com repositórios privados. Isso acontece porque as bifurcações do seu repositório podem potencialmente executar código perigoso na sua máquina de executor auto-hospedada criando um pull request que executa o código em um fluxo de trabalho.

   Para obter mais informações, consulte "Sobre os executores auto-hospedados."

   

7. Clique em Salvar grupo para criar o grupo e aplicar a política.

Alterar a política de acesso de um grupo de executores auto-hospedados

Você pode atualizar a política de acesso de um grupo de executores ou renomear um grupo de executores.

1. Na seção "Executores auto-hospedados" da página de configurações, clique em ao lado do grupo executor que você gostaria de configurar e, em seguida, clique em Editar nome e acesso [organization|repository].

2. Modifique as suas opções de políticas, ou altere o nome do grupo do executor.

   Aviso

   Recomendamos que você use apenas executores auto-hospedados com repositórios privados. Isso acontece porque as bifurcações do seu repositório podem potencialmente executar código perigoso na sua máquina de executor auto-hospedada criando um pull request que executa o código em um fluxo de trabalho.

   Para obter mais informações, consulte "Sobre os executores auto-hospedados."

Adicionando um executor auto-hospedado a um grupo automaticamente

Você pode usar o script de configuração para adicionar automaticamente um novo executor auto-hospedado a um grupo. Por exemplo, este comando registra um novo executor auto-hospedado e usa o parâmetro --runnergroup para adicioná-lo a um grupo denominado rg-runnergroup.

./config.sh --url $org_or_enterprise_url --token $token --runnergroup rg-runnergroup

O comando irá falhar se o grupo do executor não existir:

Não foi possível encontrar nenhum grupo de executor auto-hospedado denominado "rg-runnergroup".

Mover um executor auto-hospedado para um grupo

Se você não especificar o grupo de um executor durante o processo de registro, seus novos executores auto-hospedados são automaticamente atribuídos ao grupo padrão e poderão ser transferidos para outro grupo.

1. Navegue por onde seu runner auto-hospedado está registrado:

   • In an organization: navigate to the main page and click Settings.

   • If using an enterprise-level runner:

     1. No canto superior direito de qualquer página, clique em .
     2. Na barra lateral esquerda, clique em Visão geral da empresa.
     3. In the enterprise sidebar, Policies.

2. Navegue até as configurações GitHub Actions:

   • In an organization: Click Actions in the left sidebar.
   • Se estiver usando um executor de nível corporativo: Clique em Ações em " Políticas".

3. Na seção "Executores auto-hospedados" da página de configurações, localize o grupo atual do executor que deseja mover e expandir a lista de integrantes do grupo.

4. Marque a caixa de seleção ao lado do executor auto-hospedado e, em seguida, clique em Mover para o grupo para ver os destinos disponíveis.

5. Para mover o executor, clique no grupo de destino.

Remover um grupo de executor auto-hospedado

Os executores auto-hospedados são retornados automaticamente ao grupo-padrão quando seu grupo é removido.

1. Na seção "Executores auto-hospedados" da página de configurações, localize o grupo que você deseja excluir e clique no botão .

2. Para remover o grupo, clique em Remover grupo.

3. Revise os avisos de confirmação e, em seguida, clique em Remover este grupo de executores.