Skip to main content

GitHub アクション用ビルドハブ

概要

Bitrise Build Hub is a high-performance build infrastructure for GitHub Actions, purpose-built for mobile app development. It provides fully managed, zero-maintenance runners that execute your GitHub Actions workflows on the industry's fastest Apple silicon and Linux machines.

Bitrise Build Hubは、モバイルアプリ開発を目的として構築された、GitHub Actions用の高性能ビルドインフラストラクチャです。業界最速の Apple シリコンおよび Linux マシンで GitHub Actions ワークフローを実行する、フルマネージドかつメンテナンス不要のランナーを提供します

主な機能

  • M4 Pro アップルシリコンと AMD EPYC Zen4/Zen5 iOS および Android ビルド用に最適化された Linux マシン。

  • Appleのリリースから24時間以内の最新のXcodeバージョン（ベータ版を含む）。

  • ツールがプリインストールされたモバイル向けに最適化されたスタック (Xcode、 Android SDK、 Flutter、 React Nativeなど)。

  • 同時キャッシュにより、レイテンシーがほぼゼロで、ネットワークの外部へのコストもかかりません。

  • データレジデンシー要件を満たす米国およびEUのデータセンター。

  • 事前ウォーミングされた VM プールにより、キュー時間なしで即座にビルドを開始できます。

ビルドハブは GitHub Cloud と GitHub エンタープライズサーバーのリポジトリの両方で動作します。既存の GitHub Actions ワークフローファイルは変更されません。ビルドを Bitrise インフラストラクチャーにルーティングするには runs-on ラベルを更新するだけです

必要条件

Bitrise Build Hub インフラストラクチャーで GitHub Actions ワークフローを実行するには、以下が必要です。

  • ビットライズのワークスペース。

  • GitHub アカウントと GitHub パーソナルアクセストークン:このトークンは GitHub 上のランナーを認証し、ワークフロー管理とランナー設定を可能にします。

  • Bitriseのマシンプール:マシンタイプ、マシンの数、インスタンスの起動に必要なソフトウェア設定を含むシステムイメージを選択できます。

[認証]

Bitriseビルドハブには以下が必要です GitHub パーソナルアクセストークン 認証用。このトークンはランナーを認証し、GitHub Action のワークフローとランナー設定を適切に管理できるようにします

次の 2 種類のトークンを使用できます。

トークンタイプが異なれば、必要なアクセスタイプも異なります。 ターゲットスコープ。以下の表で、それぞれのターゲットスコープの正確な権限を確認してください

表 1. トークンの権限

ターゲットスコープ

クラシックトークンに必要な権限

きめ細かなアクセストークンに必要な権限

GitHub Enterprise (GHE) Cloud: https://github.com/enterprises/<enterprise>

GHE Server: https://<hostname>/enterprises/<enterprise>

manage_runners:enterprise

サポートされていません

GitHub Cloud organization: https://github.com/<org>

GHE organization: https://<hostname>/<org>

org:admin

read/write の許可 セルフホストランナー

GitHub Cloud repository: https://github.com/<owner>/<repo>

GHE repository: https://<hostname>/<owner>/<repo>

workflow

サポートされていません

ターゲットスコープ

GitHub Actions のマシンプールを設定するときは、ターゲットスコープを指定する必要があります。ターゲットスコープは、特定のリポジトリや GitHub Organization など、ランナーが操作を許可されているコンテキストです

受け入れられるターゲットスコープは次のとおりです。

  • GitHub Cloud organization: https://github.com/<org>

  • GitHub Cloud repository: https://github.com/<owner>/<repo>

  • GitHub Enterprise (GHE) Cloud: https://github.com/enterprises/<enterprise>

  • GHE Server: https://<hostname>/enterprises/<enterprise>

  • GHE organization: https://<hostname>/<org>

  • GHE repository: https://<hostname>/<owner>/<repo>

ウォームアップスクリプト

ウォームアップスクリプトを使用してビルド環境をカスタマイズし、速度とパフォーマンスを向上させます。マシンプールを作成するときに、任意のスクリプトを設定に追加できます。このスクリプトは、マシンのセットアップ時に実行されます。

エラーが発生した場合は、必ず 0 以外の終了コードを返すようにしてください。スクリプトが失敗するのは、スクリプトが 0 以外の終了コードを返した場合だけです

ローリングアップデートのパーセンテージ

Build Hub のマシンプールを作成するときに、ローリングアップデートの割合を設定できます。これは、既存のマシンプールを再構成した後に、同時に再起動されるマシンの割合です

これにより、ユーザーは進行中のビルドを失うことなくランナー設定を更新できます。値を 100 に設定すると、すべてのマシンがすぐに再起動され、進行中のビルドは中止されます

マシンプールの作成

BitriseハードウェアでCIビルドを実行できるマシンプールを作成します。

  1. ワークスペースの設定ページを開いて、以下を選択します ビットライズ・クラウド。

  2. クリック マシンプール。

  3. プールに一意の名前を設定します。

  4. で画像を選択します [イメージ] ドロップダウンメニューと必要なマシンの数 マシン数 フィールド。

    で画像を確認できます スタックレポートページ。

    2026-02-04-machine-pool-image.png

  5. マシンタイプを選択します。

    Bitriseマシンの詳細については、以下をご覧ください マシンを構築する。

  6. ローリングアップデートの割合を設定します。これは、再構成後に同時に再起動されるマシンの数です。

    ウォームアップスクリプトが必要ない場合は空のままにしてください。

  7. 完了したら、をクリックします [次へ]。

  8. オプションで、ラベルを使用してプールを整理および分類できます。

    デフォルトでは、Bitriseはプール名、イメージ、マシンタイプのラベルを提案します。これらはいつでも変更できます

  9. オプションで、ウォームアップスクリプトを追加してビルド環境をカスタマイズします。完了したら、をクリックします [次へ]。

    0 以外の終了コード

    エラーが発生した場合は、必ず 0 以外の終了コードを返すようにしてください。スクリプトが失敗するのは、スクリプトが 0 以外の終了コードを返した場合だけです

  10. [選択] GitHub から CI ツール ドロップダウンメニュー。

  11. ターゲットスコープ URL を設定します。

    ターゲットスコープの詳細については、こちらをご覧ください。 ターゲットスコープ

    20260204-machine-pool-target-scope.png

  12. GitHub 個人アクセストークンを追加します。

  13. オプションで、ランナーバージョンとランナーグループを追加します。

    • ランナーのバージョンは v2.328.0 のように正確である必要があります。ランナーバージョンを指定しない場合、最新バージョンが使用されます

    • ランナーグループ 複数のランナーを集め、その周囲にセキュリティ境界を設けるために使用されます。

  14. クリック プールを作成。

GitHub アクションワークフローを設定する

マシンプールを正常に作成したら、ビルドの実行時にマシンプールを使用するように GitHub Actions ワークフローを設定する必要があります。

を使う runs-on Bitrise マシンを指定するためのワークフロー内のプロパティ。ランナーに割り当てられたラベル、グループメンバーシップ、またはこれらの組み合わせに基づいてランナーをターゲットにすることができます

  1. GitHub リポジトリを開いて選択してください アクション。

  2. 左側で、ワークフローの名前をクリックします。

  3. ワークフローの名前の下で、をクリックします デプロイ.yml。

  4. を追加 runs-on Build Hub で実行したいジョブのプロパティ。

    • ランナーグループがない場合は、 self-hosted 値として:

      jobs:
  build:
    runs-on: self-hosted

    • If you use a runner group, the value should be group:<group-name>. For example:

      jobs:
  build:
    runs-on: 
      group: Bitrise-M4Pro

    • GitHub では、設定でラベルを使用できます。例えば、以下の設定では 3 つのラベルをすべて持つランナーのみが許可されます

      jobs:
  build:
    runs-on: [self-hosted, linux, x64, gpu]

      ラベルは次の場合に作成および編集できます。 マシンプールの作成または更新。

についての詳細は runs-on プロパティ、チェックして GitHub アクションドキュメンテーション。

このセクションの内容: