Использование прокси-сервера с самостоятельно размещенными средствами выполнения

Можно настроить локальные средства выполнения, чтобы использовать прокси-сервер для обмена данными с GitHub Enterprise Server.

В этой статье

Note

GitHubразмещенные в данный момент средства выполнения не поддерживаются в GitHub Enterprise Server. Дополнительные сведения о планируемой поддержке в будущем см. в GitHub public roadmap.

Настройка прокси-сервера с помощью переменных среды

Если для обмена данными через прокси-сервер требуется локальное средство выполнения, приложение локального средства выполнения использует конфигурации прокси-сервера, заданные в следующих переменных среды:

  • https_proxy: URL-адрес прокси-сервера для трафика HTTPS. При необходимости можно также включить учетные данные обычной проверки подлинности. Например:
    • http://proxy.local
    • http://192.168.1.1:8080
    • http://username:password@proxy.local
  • http_proxy: URL-адрес прокси-сервера для трафика HTTP. При необходимости можно также включить учетные данные обычной проверки подлинности. Например:
    • http://proxy.local
    • http://192.168.1.1:8080
    • http://username:password@proxy.local
  • no_proxy: разделенный запятыми список узлов, которые не должны использовать прокси-сервер. В no_proxy нельзя использовать IP-адреса, только имена узлов. Например:
    • example.com
    • example.com,myserver.local:443,example.org

Переменные среды прокси-сервера считываются при запуске приложения локального средства выполнения, поэтому перед настройкой или запуском этого приложения необходимо задать переменные среды. При изменении конфигурации прокси необходимо перезапустить локальное приложение самостоятельного средства выполнения.

Note

Чтобы избежать проблем, рекомендуется рассматривать переменные среды как конфиденциальные регистры независимо от поведения операционной системы и используемой оболочки.

На компьютерах Windows имена переменных среды прокси-сервера не учитывает регистр. На компьютерах с Linux и macOS рекомендуется использовать только строчные символы в переменных среды. Если у вас есть переменная среды в нижнем и верхнем регистре в Linux или macOS, например https_proxy и HTTPS_PROXY, локальное приложение Runner использует переменную среды в нижнем регистре.

Подключение между локальными средствами выполнения и GitHub Enterprise Server превышает HTTP (порт 80) или HTTPS (порт 443). Чтобы обеспечить подключение по протоколу HTTPS, настройте TLS для GitHub Enterprise Server. Дополнительные сведения см. в разделе "Настройка TLS".

Использование файла .env для настройки конфигурации прокси-сервера

Если параметры переменных среды не являются практическими, вы можете задать переменные конфигурации прокси-сервера в файле, именованном .env в каталоге приложений для локального запуска (то есть каталог, в который вы скачали и распаковали программное обеспечение runner). Например, это может потребоваться, если вы хотите настроить приложение средства выполнения в качестве службы в системной учетной записи. При запуске приложения runner он считывает переменные, заданные .env для конфигурации прокси-сервера.

Пример .env конфигурации прокси-сервера

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

Настройка конфигурации прокси-сервера для контейнеров Docker

Если в рабочих процессах используются действия контейнера Docker или контейнеры служб, возможно, потребуется настроить Docker для применения прокси-сервера в дополнение к настройке вышеуказанных переменных среды.

Сведения о требуемой конфигурации Docker см. в разделе "Настройка Docker" для использования прокси-сервера в документации По Docker.