プロキシを使用するようにランナーを設定する
This support document is only applicable to Linux Docker runners. For shell runners (MacOS, Windows, Linux Shell), the proxy needs to be configured in the runner’s host.
自分またはその組織のシステムとワークフローのセットアップ方法によっては、セルフホスト ランナーをプロキシ サーバーの背後で実行できるようにする必要がある場合があります。HTTP_PROXY と HTTPS_PROXY の各環境変数を Docker run コマンドに渡すことで、プロキシの背後で実行されるようにランナーを設定できます。
ランナーは git clone と内部で行う REST API 呼び出しに対して https 経由で Bitbucket と通信するため、少なくとも HTTPS_PROXY を設定する必要があります。
以下の例は、Linux でプロキシの背後でランナーを起動する方法を示しています。
docker container run \
-e HTTP_PROXY="http://my-http-proxy" \
-e HTTPS_PROXY="http://my-https-proxy" \
....
docker-public.packages.atlassian.com/sox/atlassian/bitbucket-pipelines-runnerプロキシを使用するようにホストの Docker デーモンを設定する
Docker を使用する際は、ランナー ホストの Docker デーモンもプロキシによって外部と通信するように設定する必要がある場合があります。このセットアップ方法の詳細については、Docker のドキュメントをご確認ください。
プロキシを使用するように Docker サービスを設定する
ビルドで Docker サービスを使用する際、初期設定ではランナーに渡された HTTP_PROXY と HTTPS_PROXY の各変数が使用されます。
It is possible to configure the Docker service to use a proxy independently, or with a different proxy than what the Runner uses. This can be done by providing values for HTTP_PROXY and HTTPS_PROXY as workspace or repository variables, or by using a custom Docker-in-Docker service:
services:
docker:
image: docker:dind
environment:
HTTP_PROXY: "http://username:[email protected]"
HTTPS_PROXY: "http://username:[email protected]"制限事項
起動時にランナーに渡される
HTTP_PROXYとHTTPS_PROXYの各変数は、ビルド コンテナー、サービス コンテナー、またはパイプには渡されません。必要に応じて、リポジトリ レベル変数などの変数を設定できます。認証未設定の Git + http によるプッシュ バックはサポート対象外です。https 経由でプッシュ バックするには、プロキシを使用するように Git を手動で設定するとともに適切な認証情報を使用するように Git を設定するか、ssh 経由でプッシュ バックする必要があります。
Docker サービスの場合は、ワークスペース、リポジトリ、またはサービスのレベルで設定された
HTTP_PROXYまたはHTTPS_PROXYの各パイプライン変数は、ランナーに渡される変数をオーバーライドします。認証を必要とするプロキシはサポート対象外です。
この内容はお役に立ちましたか?