Adicionar executores auto-hospedados

Você pode adicionar um executor auto-hospedado a um repositório, a uma organização ou a uma empresa.

Se você é um administrador de empresa ou organização, talvez você queira adicionar seus executores auto-hospedados a nível da organização ou empresa. Esta abordagem torna o executor disponível para vários repositórios na sua organização ou empresa, e também permite gerenciar seus executores em um só lugar.

Para obter informações sobre os sistemas operacionais compatíveis para executores auto-hospedados ou sobre como usar os executores auto-hospedados com um servidor proxy, confira Sobre executores auto-hospedados.

Você pode configurar a automação para dimensionar o número de executores auto-hospedados. Para saber mais, confira Redimensionamento automático com executores auto-hospedados.

Você pode registrar executores efêmeros que executam um único trabalho antes que o registro seja limpo usando o registro do executor just-in-time. Para saber mais, confira Fortalecimento de segurança para o GitHub Actions.

Pré-requisitos

• Você precisa ter acesso ao computador que usará como um executor auto-hospedado no seu ambiente.

Adicionar um executor auto-hospedado a um repositório

Você pode adicionar executores auto-hospedados a um único repositório. Para adicionar um executor auto-hospedado a um repositório de usuário, você deve ser o proprietário do repositório. Para um repositório da organização, você deve ser proprietário de uma organização ou ter acesso de administrador ao repositório.

Para obter informações sobre como adicionar um executor auto-hospedado com a API REST, confira Pontos de extremidade da API REST para executores auto-hospedados.

1. Em GitHub, acesse a página principal do repositório.

2. Abaixo do nome do repositório, clique em 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 auto-hospedado.

5. Selecione a imagem e a arquitetura do sistema operacional do computador do executor auto-hospedado.

   

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

   Note

   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. O token expira após uma hora.
     • No Windows, o script config também pergunta se você deseja instalar o aplicativo do executor auto-hospedado como um serviço. Para Linux e macOS, você pode instalar um serviço depois de terminar de adicionar o executor. Para obter mais informações, confira "Configurar o aplicativo do executor auto-hospedado como um serviç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

Após concluir as etapas para adicionar um executor auto-hospedado, o executor e seu status agora estão listados em "Executores".

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

Para saber mais, confira Monitorar e solucionar problemas de executores auto-hospedados.

Adicionar um executor auto-hospedado a uma organização

Você pode adicionar executores auto-hospedados no nível da organização, onde podem ser usados para processar trabalhos para múltiplos repositórios em uma organização. Para adicionar um executor auto-hospedado a uma organização, você deve ser um proprietário da organização. Para obter informações sobre como adicionar um executor auto-hospedado com a API REST, confira Pontos de extremidade da API REST para executores auto-hospedados.

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

   

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

   Note

   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. O token expira após uma hora.
     • No Windows, o script config também pergunta se você deseja instalar o aplicativo do executor auto-hospedado como um serviço. Para Linux e macOS, você pode instalar um serviço depois de terminar de adicionar o executor. Para obter mais informações, confira "Configurar o aplicativo do executor auto-hospedado como um serviç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

Após concluir as etapas para adicionar um executor auto-hospedado, o executor e seu status agora estão listados em "Executores".

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

Para saber mais, confira Monitorar e solucionar problemas de executores auto-hospedados.

Adicionar um executor auto-hospedado a uma empresa

Se você usar GitHub Enterprise Cloud, você poderá adicionar executores auto-hospedados a uma empresa, onde eles poderão ser atribuídos a várias organizações. Assim, os proprietários da organização poderão controlar quais repositórios podem usar os executores. Para obter mais informações, confira a documentação do GitHub Enterprise Cloud.