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 recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

Adicionar executores auto-hospedados

Você pode adicionar um executor auto-hospedado a GitHub Actions.

Neste artigo

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

Aviso: Recomendamos que você não use runners auto-hospedados com repositórios públicos.

Bifurcações do seu repositório público podem potencialmente executar códigos perigosos na sua máquina de executor auto-hospedada, criando uma pull request que executa o código em um fluxo de trabalho.

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

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 um proprietário da organização ou ter acesso de administrador ao repositório.

  1. No GitHub, navegue até a página principal do repositório.

  2. No nome do seu repositório, clique em Configurações.

    Botão de configurações do repositório

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

    Configuração de ações

  4. Em "Self-hosted runners" (Executores auto-hospedados), clique em Add runner (Adicionar executor).

  5. Selecione o sistema operacional e a arquitetura da sua máquina de executor auto-hospedada.

    Selecionar sistema operacional de 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.

    Nota: No Windows, se você quiser instalar a aplicação de executor auto-hospedada como um serviço, você deve abrir um shell com privilégios de administrador. Também recomendamos que você use C:\actions-runner como diretório para o aplicativo runner auto-hospedado para que as contas de sistema 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.
    • Executando o script config para configurar a aplicação de executor auto-hospedada e registrá-lo no GitHub Actions. O script config requer a URL de destino e um token de tempo limitado gerado automaticamente para autenticar a solicitação.
      • No Windows, o script config também pergunta se você gostaria de instalar o aplicativo de execução 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, consulte "Configuring the self-hosted runner application as a service."
    • 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 agora são listados em "Self-hosted runners" (Executores auto-hospedados).

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 obter mais informações, consulte "Monitoring and troubleshooting self-hosted runners."

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 proprietário da organização.

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

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

    Botão de configurações da organização

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

    Configuração de ações

  4. Em "Self-hosted runners" (Executores auto-hospedados), clique em Adicionar novo, e depois clique em New runner (Novo executor).

  5. Selecione o sistema operacional e a arquitetura da sua máquina de executor auto-hospedada.

    Selecionar sistema operacional de 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.

    Nota: No Windows, se você quiser instalar a aplicação de executor auto-hospedada como um serviço, você deve abrir um shell com privilégios de administrador. Também recomendamos que você use C:\actions-runner como diretório para o aplicativo runner auto-hospedado para que as contas de sistema 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.
    • Executando o script config para configurar a aplicação de executor auto-hospedada e registrá-lo no GitHub Actions. O script config requer a URL de destino e um token de tempo limitado gerado automaticamente para autenticar a solicitação.
      • No Windows, o script config também pergunta se você gostaria de instalar o aplicativo de execução 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, consulte "Configuring the self-hosted runner application as a service."
    • 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 agora são listados em "Self-hosted runners" (Executores auto-hospedados).

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 obter mais informações, consulte "Monitoring and troubleshooting self-hosted runners."

Adicionar um executor auto-hospedado a uma empresa

Você pode adicionar executores auto-hospedados a uma empresa, onde podem ser atribuídos a várias organizações. Os administradores da organização poderão então controlar quais repositórios podem usá-los.

Para adicionar um executor auto-hospedado a uma conta corporativa, você deve ser proprietário da organização.

  1. No canto superior direito de GitHub, clique na sua foto de perfil e, em seguida, clique em Suas empresas.

    "Suas empresas" no menu suspenso para a foto do perfil em GitHub

  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 conta corporativa, clique em Policies.

    Aba de políticas na barra lateral da conta corporativa

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

  5. Clique na aba Executores auto-hospedados.

  6. Clique em Adicionar novo e depois clique em Novo executor. Novos runners são atribuídos ao grupo padrão. Você pode modificar o grupo do executor depois de registrar o runner (executor). Para obter mais informações, consulte "Gerenciando acesso a runners auto-hospedados".

  7. Selecione o sistema operacional e a arquitetura da sua máquina de executor auto-hospedada.

    Selecionar sistema operacional de executor auto-hospedado

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

    Nota: No Windows, se você quiser instalar a aplicação de executor auto-hospedada como um serviço, você deve abrir um shell com privilégios de administrador. Também recomendamos que você use C:\actions-runner como diretório para o aplicativo runner auto-hospedado para que as contas de sistema 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.
    • Executando o script config para configurar a aplicação de executor auto-hospedada e registrá-lo no GitHub Actions. O script config requer a URL de destino e um token de tempo limitado gerado automaticamente para autenticar a solicitação.
      • No Windows, o script config também pergunta se você gostaria de instalar o aplicativo de execução 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, consulte "Configuring the self-hosted runner application as a service."
    • 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 agora são listados em "Self-hosted runners" (Executores auto-hospedados).

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 obter mais informações, consulte "Monitoring and troubleshooting self-hosted runners."

Esse documento ajudou você?

Privacy policy

Ajude-nos a tornar esses documentos ótimos!

Todos os documentos do GitHub são de código aberto. Você percebeu que algo que está errado ou não está claro? Envie um pull request.

Faça uma contribuição

Ou, aprenda como contribuir.