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 acessar as informações mais atualizadas, visite a Documentação em inglês.
� 

� 

Esta versão do GitHub Enterprise foi descontinuada em 2022-10-12. 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.

Usar um servidor proxy com os executores auto-hospedados

Neste artigo

Você pode configurar executores auto-hospedados para usar um servidor proxy para comunicar-se com GitHub Enterprise Server.

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.

Configurar um servidor proxy usando variáveis de ambiente

Se você precisar de um executor auto-hospedado para comunicar-se por meio de um servidor proxy, o aplicativo do executor auto-hospedado usará as configurações proxy definidas nas variáveis do ambiente a seguir:

  • https_proxy: URL de proxy para o tráfego HTTPS. Se necessário, você também poderá incluir credenciais de autenticação básica. Por exemplo:
    • http://proxy.local
    • http://192.168.1.1:8080
    • http://username:password@proxy.local
  • http_proxy: URL de proxy para o tráfego HTTP. Se necessário, você também poderá incluir credenciais de autenticação básica. Por exemplo:
    • http://proxy.local
    • http://192.168.1.1:8080
    • http://username:password@proxy.local
  • no_proxy: lista separada por vírgula de hosts que não devem usar um proxy. Somente os nomes de host são permitidos no no_proxy, você não pode usar endereços IP. Por exemplo:
    • example.com
    • example.com,myserver.local:443,example.org

As variáveis do ambiente proxy são lidas quando o aplicativo do executor auto-hospedado inicia. Portanto, você deve definir as variáveis do ambiente antes de configurar ou iniciar o aplicativo do executor auto-hospedado. Se sua configuração de proxy for mudada, você deverá reiniciar o aplicativo executor auto-hospedado.

No Windows, os nomes da variável do ambiente proxy não diferenciam maiúsculas de minúsculas. Nos sistemas Linux e macOS, recomendamos que você use variáveis de ambiente em minúscula. Caso tenha uma variável de ambiente em letras minúsculas e maiúsculas no Linux ou macOS (por exemplo, https_proxy e HTTPS_PROXY), o aplicativo executor auto-hospedado usará a variável de ambiente em minúsculas.

The connection between self-hosted runners and GitHub Enterprise Server is over HTTP (port 80) or HTTPS (port 443). To ensure connectivity over HTTPS, configure TLS for your GitHub Enterprise Server instance. For more information, see "Configuring TLS."

Usar um arquivo .env para definir a configuração de proxy

Se não for prático definir as variáveis de ambiente, defina as variáveis da configuração de proxy em um arquivo chamado .env no diretório do aplicativo do executor auto-hospedado. Por exemplo, isso pode ser necessário se você desejar configurar um aplicativo executor como um serviço em uma conta de sistema. Quando o aplicativo do executor é iniciado, ele lê as variáveis definidas em .env para a configuração de proxy.

Um exemplo de configuração de proxy de .env é mostrado abaixo:

https_proxy=http://proxy.local:8080
no_proxy=example.com,myserver.local:443

Definir configuração de proxy para contêineres Docker

Se você usar ações do contêiner Dock ou contêineres de serviço nos seus fluxos de trabalho, você também deverá configurar o Docker para usar o seu servidor proxy além de definir as variáveis do ambiente acima.

Para obter informações sobre a configuração necessária do Docker, confira "Configurar o Docker para usar um servidor proxy" na documentação do Docker.