Bitbucket Cloud の使用を開始する
Bitbucket Cloud を初めてお使いですか? 新規ユーザー用のガイドをご利用ください。
プロキシを使用するようにランナーを設定する
自分またはその組織のシステムとワークフローのセットアップ方法によっては、セルフホスト ランナーをプロキシ サーバーの背後で実行できるようにする必要がある場合があります。HTTP_PROXY と HTTPS_PROXY の各環境変数を Docker run コマンドに渡すことで、プロキシの背後で実行されるようにランナーを設定できます。
ランナーは git clone と内部で行う REST API 呼び出しに対して https 経由で Bitbucket と通信するため、少なくとも HTTPS_PROXY を設定する必要があります。
以下の例は、Linux でプロキシの背後でランナーを起動する方法を示しています。
1
2
3
4
5
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:1プロキシを使用するようにホストの Docker デーモンを設定する
Docker を使用する際は、ランナー ホストの Docker デーモンもプロキシによって外部と通信するように設定する必要がある場合があります。このセットアップ方法の詳細については、Docker のドキュメントをご確認ください。
プロキシを使用するように Docker サービスを設定する
ビルドで Docker サービスを使用する際、初期設定ではランナーに渡された HTTP_PROXY と HTTPS_PROXY の各変数が使用されます。
Docker サービスを構成して、プロキシを個別に使用したり、ランナーが使用するプロキシとは異なるプロキシを使用したりできます。これは、HTTP_PROXY と HTTPS_PROXY の各値をワークスペースまたはリポジトリの各変数として指定するか、カスタム Docker-in-Docker サービスを使用することで実現できます。
1
2
3
4
5
6
services:
docker:
image: docker:dind
environment:
HTTP_PROXY: "http://username:password@proxy2.domain.com"
HTTPS_PROXY: "http://username:password@proxy2.domain.com"制限事項
起動時にランナーに渡される HTTP_PROXY と HTTPS_PROXY の各変数は、ビルド コンテナー、サービス コンテナー、またはパイプには渡されません。必要に応じて、リポジトリ レベル変数などの変数を設定できます。
認証未設定の Git + http によるプッシュ バックはサポート対象外です。https 経由でプッシュ バックするには、プロキシを使用するように Git を手動で設定するとともに適切な認証情報を使用するように Git を設定するか、ssh 経由でプッシュ バックする必要があります。
Docker サービスの場合は、ワークスペース、リポジトリ、またはサービスのレベルで設定された HTTP_PROXY または HTTPS_PROXY の各パイプライン変数は、ランナーに渡される変数をオーバーライドします。
認証を必要とするプロキシはサポート対象外です。
この内容はお役に立ちましたか?