Usar un servidor proxy con ejecutores autoalojados

Configurar un servidor proxy mediante variables de entorno

Si necesitas un ejecutor autoalojado para comunicarte a través de un servidor proxy, la aplicación del ejecutor autoalojado usa configuraciones de proxy establecidas en las siguientes variables de entorno:

• https_proxy: URL del proxy para el tráfico HTTPS. También puedes incluir credenciales de autenticación básicas, si es necesario. Por ejemplo:
  • http://proxy.local
  • http://192.168.1.1:8080
  • http://username:password@proxy.local
• http_proxy: URL del proxy para el tráfico HTTP. También puedes incluir credenciales de autenticación básicas, si es necesario. Por ejemplo:
  • http://proxy.local
  • http://192.168.1.1:8080
  • http://username:password@proxy.local
• no_proxy: Lista de hosts separados por comas que no deberían usar un proxy. Solo se permiten nombres de host en no_proxy, no puedes usar direcciones IP. Por ejemplo:
  • example.com
  • example.com,myserver.local:443,example.org

Las variables de entorno de proxy se leen cuando se inicia la aplicación del ejecutor autoalojado, por lo que debes establecer las variables de entorno antes de configurar o iniciar la aplicación del ejecutor autoalojado. Si cambia la configuración de tu proxy, debes reiniciar la aplicación del ejecutor autoalojado.

En las máquinas Windows, los nombres de las variables de entorno proxy no distinguen mayúsculas de minúsculas. En las máquinas Linux y macOS, te recomendamos que uses todas las variables de entorno en minúsculas. Si tienes una variable de entorno tanto en minúsculas como en mayúsculas en Linux o macOS, por ejemplo https_proxy y HTTPS_PROXY, la aplicación del ejecutor autoalojado usa la variable de entorno en minúscula.

La conexión entre los ejecutores auto-hospedados y GitHub Enterprise Server es a través de HTTP (puerto 80) o HTTPS (puerto 443). Para garantizar la conectividad por HTTPS, configura el TLS para tu instancia de GitHub Enterprise Server. Para obtener más información, consulta la sección "Configurar el TLS".

Usar un archivo.env para establecer la configuración del proxy

Si establecer variables de entorno no es práctico, puedes establecer las variables de configuración de proxy en un archivo llamado .env en el directorio de la aplicación del ejecutor autoalojado. Por ejemplo, esto puede ser necesario si deseas configurar la aplicación del ejecutor como un servicio en una cuenta de sistema. Cuando se inicia la aplicación del ejecutor, lee las variables establecidas en .env para la configuración del proxy.

A continuación se muestra un ejemplo de configuración del proxy .env:

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

Establecer la configuración del proxy para contenedores Docker

Si usas las acciones del contenedor Docker o los contenedores de servicio en tus flujos de trabajo, es posible que también debas configurar Docker para usar tu servidor proxy además de establecer las variables de entorno anteriores.

Para obtener información sobre la configuración de Docker que se necesita, consulta "Configurar Docker para usar un servidor proxy" en la documentación de Docker.