ランナー

ランナーを使用すると、独自のインフラストラクチャ上のパイプラインでビルドを実行でき、自社ホストのランナーで使用するビルド時間に対して課金されなくなります。以下のガイドは、Piplelines を使用してオペレーティング システムを設定し、リポジトリ内でランナーを使用する際に役立ちます。

サポート対象プラットフォーム

現在、サポートしているのは次のみです。

• x64 および ARM アーキテクチャで Linux カーネル v4.0.0 以降を搭載した Linux。ランナーは、次の Linux ディストリビューションでテストされています。

  • Ubuntu 22.04

  • Debian 11

  • Centos 7

  • Fedora 36

  • Oracle Linux 8.6

  • Amazon Linux 2

• Windows 10 以降または Windows Server 2019 以降

• MacOS Catalina 10.15 以降

最小要件

Linux Docker

Linux Shell

Windows

MacOS

Bitbucket のランナー

ランナーは、さまざまなレベルで構成して管理できます。

• リポジトリ ランナーは、1 つのリポジトリで利用できます。

• ワークスペース ランナーは、ワークスペース内で複数のリポジトリのビルドを実行して、異なるリポジトリとチーム全体で同じランナーを共有できます。

ステップのキュー

各ワークスペースには、セルフホスト ランナーで実行されるすべてのステップのグローバル キューがあります。このキューは、そのワークスペース内のすべてのパイプラインで共有されます。各ステップは、互換性のあるランナーが使用可能になるのを待機する間、キューに残ります。ステップが完了または停止すると、ステップ キューから削除されます。

ランナー変更ログ

View the Bitbucket Pipelines Runner Changelog.

使用制限

Bitbucket Pipelines ランナーに適用される使用制限またはクォータは次のとおりです。

• ステップのビルド時間。Cloud と同様に、ステップあたりの最大ビルド時間は 120 分です。合計実行時間を短縮するには、CI/CD ワークフロー内でより多くの並列ステップを使用することをお勧めします。

• 利用可能なメモリの最大数。ランナーでは、ビルドを実行するために最大 32GB (8x) のメモリを構成できます。

• API レート制限:

  • Bitbucket のレート制限: ランナーには、このドキュメントで説明されている同じ API レート制限: API リクエスト制限が適用されます。

  • アーティファクト/キャッシュ/ログ レート制限: レート制限は、ランナーあたり毎分 2,000 リクエストです。

  • Download rate-limit on Docker Hub: Docker Hub has its own rate limits that can affect you. Authenticated users have a better image pull rate so we recommend to login to your docker hub account on a docker host.

• パイプラインごとのステップの総数: YAML ファイルでは、パイプラインごとに最大 100 ステップを構成できます。

• Total number of steps running concurrently: In a workspace on a Standard or Premium plan, you can choose to use Premium Runners.

  • Standard workspaces using Premium Runners include 1 step running concurrently across multiple pipelines.

  • Premium workspaces using Premium Runners include 2 concurrently running steps. Increasing the runner concurrency limit for your workspace above the included quota may incur a charge, depending on the usage within the billing period.

  • Free workspaces can run up to 100 steps concurrently.

• ステップのキュー時間: ステップは最大 2.5 時間キューに入れられます。

• ステップ キュー サイズ: キューは最大 1,000 ステップまで設定できます。キューが満杯になると、追加を試みたステップはすぐに失敗します。

• Total number of runners: You can configure up to 1000 runners per workspace and 1000 runners per repository.

Linux Docker のみ

• ビルド スクリプトからランナー ホスト上のローカル ファイルにアクセスできない: 分離と再現性を実現するために、ランナーはホスト ファイル システムに直接アクセスできないので、必要に応じて SCP/Rsync を使用することをお勧めします。

上記の制限は、将来変更される可能性があります。

Premium runners

Premium runners provides you with up to 1,000 runners per workspace with priority build queueing, dedicated support, pluggable storage, runner groups, automatic updates, and other advanced capabilities.

Upgrade to premium runners

By default, all workspaces are set to use free runners, which support up to 100 runners with none of the other features provided by premium runners available.

1. Select the Settings cog icon on the top navigation bar.

2. Select Workspace settings.

3. Select Pipelines.

4. Select Workspace runners.

5. Select More options … to the right of the Add runner button.

6. Select Upgrade to Premium runners.

7. Select Premium runners.

8. Optional: Set your concurrency limit. A recommended limit based on your usage is provided. You can also update the concurrency limit at any time (see the note above).

9. [次へ] を選択します。

10. Select Confirm. This upgrade takes effect immediately.