Skip to main content
Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais atualizadas, acesse a documentação em inglês.

Primeiros passos vom executores auto-hospedados da sua empresa

Você pode configurar a máquina de um exeucutor para sua empresa para que seus desenvolvedores possam começar a automatizar fluxos de trabalho com GitHub Actions.

Quem pode usar esse recurso

Enterprise owners can configure policies for GitHub Actions and add self-hosted runners to the enterprise.

Sobre os executores auto-hospedados do GitHub Actions

O GitHub Actions permite que os membros da sua empresa melhorem a produtividade automatizando todas as fases do fluxo de trabalho de desenvolvimento de software. Para obter mais informações, confira "Sobre o GitHub Actions para empresas".

Com GitHub Actions, os desenvolvedores podem escrever e combinar tarefas individuais denominadas ações para criar fluxos de trabalho personalizados. Você pode hospedar seu computador de executor para executar esses trabalhos e esse computador é chamado de executor auto-hospedado. Os executores auto-hospedados podem ser físicos, virtuais, em um contêiner, no local ou em uma nuvem. A sua máquina do executor conecta-se ao GitHub Enterprise Cloud usando o aplicativo do executor auto-hospedado de GitHub Actions. Todos podem ser executados no Linux, Windows ou macOS. Para obter mais informações, confira "Sobre os executores auto-hospedados".

Como alternativa, você pode usar máquinas de executores que GitHub hospeda. Os executores hospedados em GitHub estão fora do escopo deste guia. Para obter mais informações, confira "Sobre os executores hospedados no GitHub".

Este guia mostra como aplicar uma abordagem de gerenciamento centralizada para os executores auto-hospedados para GitHub Actions na sua empresa. No guia, você realizará as seguintes tarefas.

  1. Configurar uma política limitada para restringir as ações e os fluxos de trabalho reutilizáveis que podem ser executados na empresa
  2. Implantar um executor auto-hospedado para a sua empresa
  3. Criar um grupo para gerenciar o acesso aos executores disponíveis para sua empresa
  4. Opcionalmente, restringir ainda mais os repositórios que podem usar o executor
  5. Opcionalmente, crie ferramentas personalizadas para dimensionar automaticamente os executores auto-hospedados

Você também encontrará informações adicionais sobre como monitorar e proteger seus executores auto-hospedados, e como personalizar o software nas máquinas dos seus executores.

Depois que você terminar o guia, os membros da empresa poderão executar trabalhos do fluxo de trabalho do GitHub Actions no computador de um executor auto-hospedado.

Pré-requisitos

1. Configurar políticas para o GitHub Actions

Primeiro, habilite o GitHub Actions para todas as organizações e configure uma política para restringir as ações e os fluxos de trabalho reutilizáveis que têm permissão de execução na empresa no GitHub Enterprise Cloud. Opcionalmente, os proprietários da organização podem restringir ainda mais essas políticas para cada organização.

  1. No canto superior direito do GitHub.com, clique na foto do seu perfil e em Suas empresas. "Suas empresas" no menu suspenso na foto de perfil no GitHub Enterprise Cloud

  2. Na lista de empresas, clique na empresa que você deseja visualizar. Nome de uma empresa na lista das suas empresas

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

  4. Em "Políticas", selecione Habilitar para todas as organizações.

    Captura de tela da política "Habilitar para todas as organizações" do GitHub Actions

  5. Selecione Permitir a empresa e fluxos de trabalho reutilizáveis e ações selecionados que não são empresa e Permitir ações criadas pelo GitHub para permitir ações locais, e fluxos de trabalho reutilizáveis e ações criadas pelo GitHub.

    Captura de tela de "Permitir ações selecionadas" e "Permitir ações criadas pelo GitHub" para o GitHub Actions

  6. Clique em Salvar.

Você pode configurar políticas adicionais para restringir as ações disponíveis para os membros da empresa. Para obter mais informações, confira "Como impor políticas ao GitHub Actions na sua empresa".

2. Implantar o executor auto-hospedado para sua empresa

Em seguida, adicione um executor auto-hospedado à sua empresa. O GitHub Enterprise Cloud irá guiar você pela instalação do software necessário na máquina do executor. Depois de implantar o executor, você poderá verificar a conectividade entre o computador do executor e a empresa.

Adicionando o executor auto-hospedado

  1. No canto superior direito do GitHub.com, clique na foto do seu perfil e em Suas empresas. "Suas empresas" no menu suspenso na foto de perfil no GitHub Enterprise Cloud

  2. Na lista de empresas, clique na empresa que você deseja visualizar. Nome de uma empresa na lista das suas empresas

  3. 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. 1. Clique em Novo executor, depois em Novo executor auto-hospedado. 1. Selecione a imagem e a arquitetura do sistema operacional do computador do executor auto-hospedado.

  4. Você verá instruções mostrando como baixar o executor e instalá-lo em sua máquina de executor auto-hospedada.

    Abra um shell em sua máquina de executor auto-hospedado e execute cada comando shell na ordem mostrada.

    Observação: no Windows, caso você deseje instalar o aplicativo do executor auto-hospedado como um serviço, abra um shell com privilégios de administrador. Também recomendamos que você use C:\actions-runner como diretório para o aplicativo do executor auto-hospedado para que as contas do sistema do Windows possam acessar o diretório do executor.

    As instruções te ajudam a completar estas tarefas:

    • Transferindo e extraindo o aplicativo do executor auto-hospedado.
    • Executar o script config para configurar o aplicativo do executor auto-hospedado e registrá-lo no GitHub Actions. O script config exige a URL de destino e um token de tempo limitado gerado automaticamente para autenticar a solicitação.
    • Executando o aplicativo do executor auto-hospedado para conectar a máquina ao GitHub Actions.

Verificando se o seu executor auto-hospedado foi adicionado com sucesso

Depois de completar as etapas para adicionar um executor auto-hospedado, o executor e seu status serão listados em "Runners".

A aplicação dos executores auto-hospedados deve estar activa para que o executor aceite os trabalhos. Quando o aplicativo do executor estiver conectado a GitHub Enterprise Cloud e pronto para receber trabalhos, você verá a seguinte mensagem no terminal da máquina.

√ Connected to GitHub

2019-10-24 05:45:56Z: Listening for Jobs

3. Gerenciar o acesso ao executor auto-hospedado usando um grupo

Você pode criar um grupo de executor para gerenciar o acesso ao executor que você adicionou à sua empresa. Você usará o grupo para escolher quais organizações podem executar trabalhos a partir de GitHub Actions no executor.

GitHub Enterprise Cloud adiciona todos os novos executores a um grupo. Os executores podem estar em um grupo por vez. Por padrão, o GitHub Enterprise Cloud adiciona novos executores ao grupo "padrão".

  1. No canto superior direito do GitHub.com, clique na foto do seu perfil e em Suas empresas. "Suas empresas" no menu suspenso na foto de perfil no GitHub Enterprise Cloud

  2. Na lista de empresas, clique na empresa que você deseja visualizar. Nome de uma empresa na lista das suas empresas

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

  4. Clique em Novo grupo de executores.

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

  6. Para escolher uma política de acesso à organização, em "Acesso à organização", selecione o menu suspenso Acesso à organização e clique em Organizações selecionadas.

  7. À direita da lista suspensa com a política de acesso da organização, clique em .

  8. Selecione as organizações que você gostaria de conceder acesso ao grupo do executor.

  9. Opcionalmente, para permitir que repositórios públicos nas organizações selecionadas usem executores no grupo, selecione Permitir repositórios públicos.

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

    1. Clique em **Criar grupo** para criar o grupo e aplicar a política.
  10. Clique na aba "Executores".

  11. Na lista de executores, clique no executor que você implantou na seção anterior.

  12. Clique em Editar.

  13. Clique em Grupos de executores .

  14. Na lista de grupos de executores, clique no nome do grupo que você criou anteriormente.

  15. Clique em Salvar para mover o executor para o grupo.

Você já implantou um executor auto-hospedado que pode executar trabalhos de GitHub Actions dentro das organizações que você especificou.

4. Restringir ainda mais o acesso ao executor auto-hospedado

Opcionalmente, os proprietários da organização podem restringir ainda mais a política de acesso do grupo p executor que você criou. Por exemplo, um proprietário da organização pode permitir que apenas certos repositórios na organização usem o grupo de executores.

Para obter mais informações, confira "Como gerenciar o acesso a executores auto-hospedados usando grupos".

5. Escalar automaticamente os executores auto-hospedados

Opcionalmente, você pode criar ferramentas personalizadas para dimensionar automaticamente os executores auto-hospedados para a empresa. Por exemplo, suas ferramentas podem responder a eventos de webhook de GitHub.com para dimensionar automaticamente um cluster de computadores de executores. Para obter mais informações, confira "Dimensionamento automático com executores auto-hospedados".

Próximas etapas

  • Você pode monitorar executores auto-hospedados e resolver problemas comuns. Para obter mais informações, confira "Monitoramento e solução de problemas de executores auto-hospedados".

  • GitHub recomenda que você revise considerações de segurança para máquinas de executores auto-hospedados. Para obter mais informações, confira "Proteção de segurança do GitHub Actions".

  • Se você usar GitHub Enterprise Server ou GitHub AE, você poderá sincronizar manualmente os repositórios em GitHub.com que contém ações para a sua empresa em GitHub Enterprise Server ou GitHub AE. Como alternativa, você pode permitir que os integrantes da sua empresa acessem automaticamente as ações de GitHub.com usando GitHub Connect. Para obter mais informações, consulte o seguinte.

  • Você pode personalizar o software disponível nas suas máquinas de executores auto-hospedados ou configurar seus executores para executar softwares similares a executores hospedados em GitHub. O software que alimenta máquinas de executores para GitHub Actions é de código aberto. Para obter mais informações, confira os repositórios actions/runner e actions/runner-images.

Leitura adicional