注: GitHub ホステッド ランナーは、現在 GitHub Enterprise Server でサポートされていません。 GitHub public roadmap で、今後の計画的なサポートの詳細を確認できます。
環境変数を利用したプロキシサーバーの設定
セルフホストランナーがプロキシサーバー経由で通信しなければならないのであれば、セルフホストランナーアプリケーションは以下の環境変数に設定されたプロキシの設定を利用します。
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
のように、小文字と大文字の両方の環境変数がある� �合、セルフホステッド ランナー アプリケーションには小文字の環境変数が使用されます。
セルフホステッド ランナーと GitHub Enterprise Server の接続は、HTTP (ポート 80) または HTTPS (ポート 443) を経由します。 HTTPS 経由で確実に接続を行うには、 に対して TLS を構成します。 詳細については、「TLS の構成」を参照してく� さい。
.envファイルを使用したプロキシ設定
環境変数を設定することが現実的ではない� �合、プロキシ設定変数をセルフホスト ランナー アプリケーションのディレクトリ内の .env という名前のファイルで設定できます。 これはたとえば、ランナーアプリケーションをシステ� アカウント下のサービスとして設定したい� �合に必要になるかもしれません。 ランナー アプリケーションが起動すると、 .env 内に設定されたプロキシ設定の変数が読み取られます。
.env のプロキシ構成の例を次に示します。
https_proxy=http://proxy.local:8080
no_proxy=example.com,myserver.local:443
Dockerコンテナのためのプロキシ設定
ワークフロー中でDockerコンテナアクションやサービスコンテナを使うなら、上記の環境変数の設定に� えて、プロキシサーバーを使うようDockerも設定しなければならないかもしれません。
必要な Docker 構成の詳細については、Docker のドキュメントの「プロキシサーバを使うように Docker を設定」を参照してく� さい。