Skip to main content

Esta versão do GitHub Enterprise foi descontinuada em 2023-01-18. Nenhum lançamento de patch será feito, mesmo para questões críticas de segurança. Para obter melhor desempenho, segurança aprimorada e novos recursos, atualize para a última versão do GitHub Enterprise. Para obter ajuda com a atualização, entre em contato com o suporte do GitHub Enterprise.

Gerenciar o acesso a executores auto-hospedados usando grupos

Você pode usar políticas para limitar o acesso a executores auto-hospedados adicionados a uma organização ou empresa.

Observação: no momento, não há suporte para os executores hospedados no GitHub no GitHub Enterprise Server. Você pode ver mais informações sobre o suporte futuro planejado no GitHub public roadmap.

Sobre os grupos de executores

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

Quando um proprietário de empresa concede acesso a um grupo de executores, os proprietários da organização podem ver o grupo de executores listado nas configurações do executor da organização. Os proprietários da organização podem atribuir um repositório granular adicional ao grupo do executor corporativo.

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, confira "Como mover um executor para um grupo".

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

Aviso: Recomendamos que você use apenas executores auto-hospedados com repositórios privados. Isso acontece porque as bifurcações do seu repositório público podem executar código perigoso em seu computador de executor auto-hospedado criando uma solicitação de pull que executa o código em um fluxo de trabalho.

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

Todas as organizações têm um só grupo de executores padrão. As organizações dentro de uma conta de empresa podem criar grupos adicionais. 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 com a API REST, confira "Grupos de executores auto-hospedados".

Os executores 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ê deve escolher uma política que defina quais repositórios têm acesso ao grupo do executor.

  1. No your GitHub Enterprise Server instance, navegue até a página principal da organização. 1. No nome da sua organização, clique em Configurações. Botão Configurações da organização 1. Na barra lateral esquerda, clique em Ações.

  2. Na barra lateral esquerda, em "Actions", clique em Executores.

  3. Em "Executores", clique Adicionar e Novo grupo.

    Adicionar grupo de executor

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

    É possível configurar o grupo de um executor para ser acessível a uma lista específica de repositórios ou a todos os repositórios na organização. Por padrão, apenas repositórios privados podem acessar executores no grupo do executor, 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.

    Adicionar opções de grupo de executores

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

Criar um grupo de executor auto-hospedado para 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 público podem executar código perigoso em seu computador de executor auto-hospedado criando uma solicitação de pull que executa o código em um fluxo de trabalho.

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

As empresas podem adicionar os executores delas a grupos para gerenciamento de acesso. As empresas podem criar grupos de executores acessíveis por meio de organizações específicas na conta da empresa . Os proprietários da organização podem atribuir políticas adicionais de acesso do repositório granular para os grupos de executores corporativos. Para obter informações sobre como criar um grupo de executores com a API REST, confira os pontos de extremidade da empresa na API REST de GitHub Actions.

Os executores 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 à direita de GitHub Enterprise Server, clique na foto do perfil e clique em Configurações da empresa. "Configurações da empresa" no menu suspenso da foto do perfil em GitHub Enterprise Server 1. Na barra lateral da empresa, clique em Políticas. Guia Políticas na barra lateral da conta corporativa 1. Em " Políticas", clique em Actions. 1. Clique na guia Executores.

  2. Use o menu suspenso Adicionar novo e selecione Novo grupo.

  3. Em "Nome do grupo", digite um nome para o grupo de executores.

  4. Para escolher uma política para o acesso da organização, selecione o menu suspenso Acesso à organização e clique em uma política. Você pode configurar um grupo de executor para que possa ser acessado por uma lista específica de organizações ou a todas as organizações da empresa. Por padrão, apenas repositórios privados podem acessar executores no grupo de um executor, mas você pode substituir isso.

    Opções de Adicionar grupo de executores

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

Aviso: Recomendamos que você use apenas executores auto-hospedados com repositórios privados. Isso acontece porque as bifurcações do seu repositório público podem executar código perigoso em seu computador de executor auto-hospedado criando uma solicitação de pull que executa o código em um fluxo de trabalho.

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

Para grupos de executores em uma empresa, você pode mudar quais organizações na empresa podem acessar um grupo de executores. Para grupos de executores em uma organização, você pode alterar quais repositórios na organização podem acessar um grupo de executores.

Alterando quais organizações ou repositórios podem acessar um grupo de executores

  1. Na seção "Executores" da página de configurações, ao lado do grupo de executores que você deseja configurar, clique em e clique em Editar nome e acesso de [organização|repositório] . Gerenciar permissões do repositório

  2. Modifique suas opções de política.

    Aviso

    Recomendamos que você use apenas executores auto-hospedados com repositórios privados. Isso acontece porque as bifurcações do seu repositório público podem executar código perigoso em seu computador de executor auto-hospedado criando uma solicitação de pull que executa o código em um fluxo de trabalho.

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

Alterando o nome de um grupo de executores

  1. Na seção "Executores" da página de configurações, ao lado do grupo de executores que você deseja configurar, clique em e clique em Editar nome e acesso de [organização|repositório] . Gerenciar permissões do repositório
  2. Altere o nome do grupo de executores.

Adicionando um executor auto-hospedado a um grupo automaticamente

Você pode usar o script de configuração para adicionar automaticamente um novo executor a um grupo. Por exemplo, esse comando registra um novo executor e usa o parâmetro --runnergroup para adicioná-lo a um grupo chamado 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:

Could not find any self-hosted runner group named "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 são automaticamente atribuídos ao grupo padrão e poderão ser transferidos para outro grupo.

  1. Navegue até onde seu executor está registrado:

    • Em uma organização: navegue até a página principal e clique em Configurações.

    • Se estiver usando um executor de classe empresarial:

      1. No canto superior à direita de GitHub Enterprise Server, clique na foto do perfil e clique em Configurações da empresa. "Configurações da empresa" no menu suspenso da foto do perfil em GitHub Enterprise Server
  2. Navegue até as configurações GitHub Actions:

    • Em uma organização:

      1. Na barra lateral esquerda, clique em Ações.
      2. Na barra lateral esquerda, em "Actions", clique em Executores.
    • Se estiver usando um executor de classe empresarial:

      1. Na barra lateral da empresa, clique em Políticas. Guia Políticas na barra lateral da conta corporativa 1. Em " Políticas", clique em Actions. 1. Clique na guia Executores.
  3. Na seção "Grupos de executores" da página de configurações, localize o grupo atual do corredor que você deseja mover e expanda a lista de membros do grupo. Ver os membros do grupo de executores

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

  5. Para mover o executor, clique no grupo de destino. Movimentação de um membro do grupo de executores

Remover um grupo de executor auto-hospedado

Os executores são retornados automaticamente ao grupo padrão quando o grupo deles é removido.

  1. Navegue até onde seus grupos de executores estão localizados:

    • Em uma organização: navegue até a página principal e clique em Configurações.

    • Se estiver usando um grupo de classe empresarial:

      1. No canto superior à direita de GitHub Enterprise Server, clique na foto do perfil e clique em Configurações da empresa. "Configurações da empresa" no menu suspenso da foto do perfil em GitHub Enterprise Server
  2. Navegue até as configurações "Grupos de executor":

    • Em uma organização:

      1. Na barra lateral esquerda, clique em Ações.
      2. Na barra lateral esquerda, em "Actions", clique em Executores.
    • Se estiver usando um grupo de classe empresarial:

      1. Na barra lateral da empresa, clique em Políticas. Guia Políticas na barra lateral da conta corporativa 1. Em " Políticas", clique em Actions. 1. Clique na guia Grupos de executores.
  3. Na lista de grupos, à direita do grupo que você deseja excluir, clique em .

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

  5. Revise as solicitações de confirmação e clique em Remover este grupo de executores. Todos os executores que ainda estiverem nesse grupo serão movidos automaticamente para o grupo padrão, herdando as permissões de acesso atribuídas a ele.