セルフホストランナーとプロキシ サーバーを使う

環境変数を利用したプロキシサーバーの設定

セルフホストランナーがプロキシサーバー経由で通信しなければならないのであれば、セルフホストランナーアプリケーションは以下の環境変数に設定されたプロキシの設定を利用します。

• https_proxy: HTTPS トラフィックのプロキシ URL。 必要な� �合には、basic認証の認証情� �を含めることもできます。 たとえば次のような点です。
  • http://proxy.local
  • http://192.168.1.1:8080
  • http://username:password@proxy.local
• http_proxy: HTTP トラフィックのプロキシ URL。 必要な� �合には、basic認証の認証情� �を含めることもできます。 たとえば次のような点です。
  • 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

プロキシの環境変数は、セルフホストランナーアプリケーションの起動時に読み込まれるので、これらの環境変数はセルフホストランナーアプリケーションを設定あるいは起動する前に設定しなければなりません。 プロキシの構成を変更した� �合は、セルフホステッド ランナー アプリケーションを再起動する必要があります。

Windowsマシンで、プロキシ環境変数名で大文字小文字は区別されません。 Linux及びmacOSマシンで、環境変数はすべて小文字にすることをおすすめします。 Linux または macOS 上で、https_proxy と HTTPS_PROXY のように、小文字と大文字の両方の環境変数がある� �合、セルフホステッド ランナー アプリケーションには小文字の環境変数が使用されます。

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

.envファイルを使用したプロキシ設定

環境変数を設定することが現実的ではない� �合、プロキシ設定変数をセルフホスト ランナー アプリケーションのディレクトリ内の .env という名前のファイルで設定できます。 これはたとえば、ランナーアプリケーションをシステ� アカウント下のサービスとして設定したい� �合に必要になるかもしれません。 ランナー アプリケーションが起動すると、 .env 内に設定されたプロキシ設定の変数が読み取られます。

.env のプロキシ構成の例を次に示します。

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

Dockerコンテナのためのプロキシ設定

ワークフロー中でDockerコンテナアクションやサービスコンテナを使うなら、上記の環境変数の設定に� えて、プロキシサーバーを使うようDockerも設定しなければならないかもしれません。

必要な Docker 構成の詳細については、Docker のドキュメントの「プロキシサーバを使うように Docker を設定」を参照してく� さい。