Bitbucket is getting a new navigation

We’re rolling out these changes, so the documentation may not match your experience in the Bitbucket Cloud app. Read about the new Bitbucket navigation

Linux Docker 用のランナーをセットアップする

ランナーを使用すると、独自のインフラストラクチャ上の Pipelines でビルドを実行でき、自社ホストのランナーで使用するビルド時間に対して課金されなくなります。

前提条件

ランナー用のホストとして少なくとも 8GB の RAM を持つ 64 ビット Linux インスタンス。
- More RAM may be required for builds with larger step sizes or build services.
ランナーコンテナーには少なくとも 512MB のメモリを割り当てます。
Docker v19.03 and above - Install Docker

べストプラクティス

スワップを無効化して vm.swappiness を設定することを強くお勧めします。スワップを有効化すると、メモリと OOM に関して決定的でないビルドが生じる可能性があります。つまり、十分なスワップが利用可能であればビルドが渡されますが、十分なスワップが利用できないと同じビルドで OOM が生じることがあります。

Linux 環境でスワップを無効にする

ほとんどの Linux ディストリビューションでスワップを無効にする手順を次に示します。次のコマンドがインストールされていない場合は、それらをインストールする必要があります。スワップを設定する場合は、ディストリビューションのドキュメントをご参照ください。

スワップが有効になっているかどうかを確認するには、次のコマンドを使用します。
sudo swapon -sv
スワップが有効な場合は、次のような出力が表示されます。
NAME TYPE SIZE USED PRIO /dev/sda3 partition 2G 655.2M -1
スワップが有効な場合は、次のプロセスを使用して無効にする必要があります。
1. 次のコマンドを実行して、すべてのスワップを無効にします。
  sudo swapoff -av
2. /etc/fstab を開いて、構成されているすべてのスワップパーティションまたはファイルを削除します。
3. マシンを再起動します。
4. 次のコマンドをもう一度実行して、次の出力がないことを確認します。
  sudo swapoff -av
5. 出力がある場合はステップ 2 を繰り返して、すべてのスワップファイルが /etc/fstab から削除されていることを確認します。

Linux 環境で vm.swappiness を構成する

ほとんどの Linux ディストリビューションで vm.swappiness を構成する手順を次に示します。次のコマンドがインストールされていない場合は、それらをインストールする必要があります。スワップを設定する場合は、ディストリビューションのドキュメントをご参照ください。

vm.swappiness の値を確認するには、次のコマンドを使用します。
sudo sysctl -n vm.swappiness
値が 1 以外の場合は、スワップ動作がまだ有効になっていることを意味します。
swappiness の値が 1 以外の値である場合は、次のプロセスで設定します。
1. /etc/sysctl.conf を開いて、vm.swappiness = 1 をファイル自体の行に追加します。
2. マシンを再起動します。
3. 次のコマンドを実行して、出力が 1 になることを確認します。
  sudo sysctl -n vm.swappiness
4. 1 以外の出力がある場合は、ステップ 2 を繰り返して、/etc/sysctl.conf が正しく構成されていることを確認します。

Docker イメージのクリーンアップをスケジュールする

ディスクスペースが不足しないように、Docker イメージを自動で削除するプロセスを設定することをお勧めします。docker system prune -af コマンドを使用して cron ジョブを作成し、すべての未使用のイメージを削除できます。スケジュールは、使用するイメージのサイズ、利用可能なディスクスペース、ランナーでビルドを実行する頻度によって異なります。

たとえば、週に 1 回、日曜日の午前 0 時にイメージをクリーンアップするには、次の手順に従います。

crontab -e コマンドを使用して、ユーザーアカウントの crontab ファイルを開きます。
次のエントリを追加します。0 0 * * 0 docker system prune -af
ファイルを保存して閉じます。

For more details, refer to the crontab documentation.

ランナーを始める

ランナーページに移動します。
- For Workspace runners, visit Workspace settings, then Workspace runners.
- For Repository runners, visit Repository settings, then Runners.
[ランナーを追加] を選択します。
[ランナーインストール] ダイアログの [システムとアーキテクチャ] で、Linux Docker (x86_64) または Linux Docker (arm64) を選択します。
[ランナーインストール] ダイアログの実行ステップで提供される事前設定された Docker コマンドによって、ランナーを実行します。
- ランナー実行が 1 回目の場合は、イメージをプルします。
- 新しいランナーを起動する前に、必ず次のコマンドを使用してランナーイメージを手動でプルし、常に最新のランナーが実行されるようにしてください。
  docker pull docker-public.packages.atlassian.com/sox/atlassian/bitbucket-pipelines-runner
  If you’re looking to update an existing runner to latest version, follow the instructions of Updating a runner version | Bitbucket Cloud | Atlassian Support
- 次のエラーが発生した場合は、以下の「docker container rm -f runner」コマンドを実行してランナーを削除します。
  エラー
  docker: Error response from daemon: docker: Error response from daemon: Conflict. The container name "/runner-76b247e7-b925-5e7b-9da2-1cda14c4ff2c" is already in use by container "c3403236e3af5962ed3a9b8771561bd2021974941cc8a89a40c6c66cecb18f53". You have to remove (or rename) that container to be able to reuse that name. See 'docker run --help'.
  docker container rm -f runner コマンド
  docker container rm -f runner-76b247e7-b925-5e7b-9da2-1cda14c4ff2c

ランナーの作業ディレクトリを変更する

ランナーがホストマシンで使用する作業ディレクトリを変更する場合は、ランナーを起動するときに docker run コマンドに次の 2 つのフラグを追加します。

docker run [all existing parameters] -v /mydir:/mydir -e WORKING_DIRECTORY=/mydir

このコマンドでは、-v パラメーターの最初の値は、作業ディレクトリとして機能するマシン上のローカルディレクトリになります。2 番目の値は、ランナー内のディレクトリになります。WORKING_DIRECTORY 環境変数で指定された値と一致するものであれば、どのようなものでも構いません。

作業ディレクトリはランナーのログが永続的に格納されますが、ステップの実行中に一時ファイルを保存するためにも使用されます。

ホストデバイス上のファイルにアクセスする

Docker ランタイムでは、ローカルファイルにアクセスできません。既定では、ランナーはホストへのアクセスを制限します。これは、ランナーの存在するすべてのマシンにあるとは限らないファイルへの依存関係によって発生するパイプラインの障害を回避するためです。

回避策として、次のコマンドを実行して、ランナーのビルドから SFTP クライアントを使用してホスト上のファイルにアクセスすることをお勧めします。

sftp {user}@{host}:{remoteFileName} {localFileName}

For information on using the OpenSSH sftp command, visit the OpenBSD manual page server — sftp.

安全ではない Docker レジストリのイメージの使用

To use an image from an insecure Docker registry on the Linux Docker runner, use a custom docker-in-docker service. For example:
dockerfile

# my-custom-dind-image
FROM docker:dind
ENTRYPOINT [ "sh", "-c", "dockerd-entrypoint.sh $DOCKER_OPTS" ]

bitbucket-pipelines.yml

definitions:
  services:
    docker:
      image: my-custom-dind-image
      variables:
         DOCKER_OPTS: "--insecure-registry=my.docker.registry"

pipelines:
  default:
    - step:
        runs-on: self.hosted
        services:
          - docker
        script:
          - docker build -t my.docker.registry/$IMAGE_NAME .
          - docker push my.docker.registry/$IMAGE_NAME

この内容はお役に立ちましたか?

正確ではなかった明確ではなかった関係なかった

さらにヘルプが必要ですか?

アトラシアンコミュニティをご利用ください。

コミュニティに質問