Bitbucket Cloud の使用を開始する
Bitbucket Cloud を初めてお使いですか? 新規ユーザー用のガイドをご利用ください。
ランナーを使用すると、独自のインフラストラクチャ上のパイプラインでビルドを実行でき、自社ホストのランナーで使用するビルド時間に対して課金されなくなります。以下のガイドは、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 以降
ランナー用のホストとして少なくとも 8GB の RAM を持つ 64 ビット Linux インスタンス。
2 つ以上のステップまたはビルド サービスによるビルドでは、より多くの RAM が必要になる場合があります。
ランナー コンテナーには少なくとも 512MB のメモリを割り当てます。
Docker v19.03 以上 - Docker をインストールする
OpenJDK 11 (11.0.15 以上) をインストール済み
Git 2.35.0 以上
Bash 3.2 以降
ランナー用のホストとして少なくとも 8GB の RAM を持つ 64 ビット Linux インスタンス。
OpenJDK 11 (11.0.15 以上) をインストール済み
Git 2.35.0 以上
PowerShell 5.0 以降
ランナーのホストとして 8GB 以上の RAM を搭載した 64 ビットの Windows 10 以降または Windows Server 2019以降のインスタンス。
Windows ページファイルとスワップファイルを無効にする (オプション、推奨)
OpenJDK 11 (11.0.11 以上) をインストール済み
Git 2.35.0 以上
ランナー用のホストとして少なくとも 8GB の RAM を搭載した 64 ビット MacOS インスタンス。
Bitbucket Pipelines のランナー変更ログを表示します。
ランナーは、さまざまなレベルで構成して管理できます。
リポジトリ ランナーは、1 つのリポジトリで利用できます。
ワークスペース ランナーは、ワークスペース内で複数のリポジトリのビルドを実行して、異なるリポジトリとチーム全体で同じランナーを共有できます。
Bitbucket Pipelines ランナーに適用される使用制限またはクォータは次のとおりです。
ステップのビルド時間。Cloud と同様に、ステップあたりの最大ビルド時間は 120 分です。合計実行時間を短縮するには、CI/CD ワークフロー内でより多くの並列ステップを使用することをお勧めします。
利用可能なメモリの最大数。ランナーでは、ビルドを実行するために最大 32GB (8x) のメモリを構成できます。
API レート制限:
Bitbucket のレート制限: ランナーには、このドキュメントで説明されている同じ API レート制限: API リクエスト制限が適用されます。
アーティファクト/キャッシュ/ログ レート制限: レート制限は、ランナーあたり毎分 2,000 リクエストです。
Docker Hub 上のダウンロード レート制限: Docker Hub には、影響を与える可能性のある独自のレート制限があります。認証されたユーザーはイメージのプル レートが向上するため、Docker ホストの Docker Hub アカウントにログインすることをお勧めします。
パイプラインごとのステップの総数: パイプラインごとに最大 100 ステップを構成して実行できます。
同時に実行されているステップの総数: ワークスペースがすべてのパイプラインで一度に実行できるステップ数は、プランによって異なります。
Standard と Premium の各ワークスペースでは、複数のパイプラインで同時に実行する 600 ステップをサポートできます。
無料のワークスペースでは、複数のパイプラインで同時に実行する 10 ステップをサポートできます。
この制限に到達すると、超過したステップは失敗します。
ステップのキュー時間: ステップは最大 2.5 時間キューに入れられます。
ランナーの総数: ワークスペースごとに最大 100 個、リポジトリごとに最大 100 個のランナーを設定できます。
ビルド スクリプトからランナー ホスト上のローカル ファイルにアクセスできない: 分離と再現性を実現するために、ランナーはホスト ファイル システムに直接アクセスできないので、必要に応じて SCP/Rsync を使用することをお勧めします。
上記の制限は、将来変更される可能性があります。
Bitbucket で新しいランナーを追加する
ランナーを追加すると、独自のインフラストラクチャ上の Pipelines でビルドを実行できます。
bitbucket-pipelines.yml でランナーを設定する
ランナーを bitbucket.pipelines.yml ファイルで設定する
Linux Docker 用のランナーをセットアップする
Linux 環境を設定して、Docker ベースのランナーを Pipelines で使用する
Linux Shell 用のランナーをセットアップする
Linux 環境を設定して、Shell ベースのランナーを Pipelines で使用する
Windows 用のランナーをセットアップする
Pipelines でランナーを使用できるように Windows 環境を設定する
MacOS のランナーをセットアップする
Bitbucket Pipelines のビルドを自分の MacOS インフラストラクチャで実行する
プロキシを使用するようにランナーを設定する
セルフホスト ランナーをプロキシ サーバーの背後で実行できるようにする方法
自社ホスト ランナーへのログインを設定する
高度に洗練されたオンプレミス ランナー操作のためのロギングを設定する
会社のファイアウォールの背後で実行されているランナーの IP アドレス
ランナーが Bitbucket Pipelines に接続できるようにするには、ファイアウォールでどの IP アドレスを許可する必要がありますか?
Docker イメージを自社ホスト ランナーで使用する
独自の Docker イメージを自社ホスト ランナーで使用する
Docker ベースのランナーを Kubernetes にデプロイ
Linux Docker Pipelines ランナーを Kubernetes にデプロイする方法の例
Autoscaler for Runners on Kubernetes
オートスケーラーによって、実行可能なジョブに応じて Linux エージェントの数が自動的にスケーリングされます。
この内容はお役に立ちましたか?