ノート: GitHubホストランナーは、現在GitHub Enterprise Serverでサポートされていません。 GitHubパブリックロードマップで、計画されている将来のサポートに関する詳しい情� �を見ることができます。
環境変数を利用したプロキシサーバーの設定
セルフホストランナーがプロキシサーバー経由で通信しなければならないのであれば、セルフホストランナーアプリケーションは以下の環境変数に設定されたプロキシの設定を利用します。
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マシンで、環境変数はすべて小文字にすることをおすすめします。 たとえばhttps_proxy
とHTTPS_PROXY
といったように、大文字と小文字の環境変数をLinuxもしくはmacOSで使った� �合、セルフホストランナーアプリケーションは小文字の環境変数を使います。
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 GitHub Enterprise Serverインスタンス. 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を設定する」を参照してく� さい。