プロキシを使用するようにランナーを設定する

Depending on how your or your organization’s system and workflows are set up, you may need to allow your self-hosted runners to run behind a proxy server. A runner can be configured to operate behind a proxy by passing the HTTP_PROXY and HTTPS_PROXY environment variables through to the Docker run command.

Runners communicate back to Bitbucket over https for git clone and for any REST API calls it makes internally, so at a minimum HTTPS_PROXY must be set.

以下の例は、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 サービスを設定する

When your build uses the Docker service, it will, by default, use the HTTP_PROXY and HTTPS_PROXY variables passed to the runner.

It is possible to configure the Docker service to use a proxy independently, or with a different proxy that 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:

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 and HTTPS_PROXY variables passed to the runner on start up are not passed through to the build container, service containers, or pipes. You can configure variables, such as repository level variables, if required.

  • 認証未設定の Git + http によるプッシュ バックはサポート対象外です。https 経由でプッシュ バックするには、プロキシを使用するように Git を手動で設定するとともに適切な認証情報を使用するように Git を設定するか、ssh 経由でプッシュ バックする必要があります。

  • For the Docker service, any HTTP_PROXY or HTTPS_PROXY pipelines variables configured at the workspace, repository, or service level will override the variables passed to the runner.

  • 認証を必要とするプロキシはサポート対象外です。

その他のヘルプ