ランナー

ランナーを使用すると、独自のインフラストラクチャ上のパイプラインでビルドを実行でき、自社ホストのランナーで使用するビルド時間に対して課金されなくなります。以下のガイドは、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 つのリポジトリで利用できます。

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

ステップのキュー

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

ランナー変更ログ

Bitbucket Pipelines のランナー変更ログを表示します。

使用制限

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

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

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

• API レート制限:

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

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

  • Docker Hub 上のダウンロード レート制限: Docker Hub には、影響を与える可能性のある独自のレート制限があります。認証されたユーザーはイメージのプル レートが向上するため、Docker ホストの Docker Hub アカウントにログインすることをお勧めします。

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

• 同時に実行するステップの総数: Standard プランまたは Premium プランのワークスペースでは、すべてのパイプラインにわたってワークスペースがセルフホスト ランナーで一度に実行できるステップの最大数を設定できます。

  • Standard ワークスペースには、複数のパイプラインで同時に実行される 1 つのステップが含まれます。

  • Premium ワークスペースには、同時に実行できるステップが 2 つ含まれています。ワークスペースのランナーの同時実行制限を、含まれているクォータを超えて増やすと、料金が発生します。

  • 無料のワークスペースには、複数のパイプラインで同時に実行できるステップが 1 つ含まれており、この制限は設定できません。

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

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

• ランナーの総数: ワークスペースごとに最大 100 個、リポジトリごとに最大 100 個のランナーを設定できます。

Linux Docker のみ

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

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