Skip to main content

Uso de un servidor proxy con ejecutores autohospedados

Puedes configurar los ejecutores autoalojados para usar un servidor proxy para comunicarte con GitHub.

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: dirección 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: dirección 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 separada por comas de hosts que no deben usar un proxy. Solo se permiten nombres de host en no_proxy; no se pueden 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 del proxy, debe reiniciar la aplicación del ejecutor autohospedado.

Nota: Para evitar problemas, se recomienda tratar las variables de entorno como distingue mayúsculas de minúsculas, independientemente del comportamiento del sistema operativo y del shell que esté usando.

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 tiene una variable de entorno en minúsculas y mayúsculas en Linux o macOS, por ejemplo, https_proxy y HTTPS_PROXY, la aplicación del ejecutor autohospedado usa la variable de entorno en minúsculas.

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

Si establecer variables de entorno no le resulta práctico, puede establecer las variables de configuración del proxy en un archivo denominado .env en el directorio de la aplicación del ejecutor autohospedado (esto es, el directorio en el que descargó y desempaquetó el software del ejecutor). 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.

Ejemplo de configuración de 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 necesaria, consulte "Configuración de Docker para usar un servidor proxy" en la documentación de Docker.