メインコンテンツまでスキップ

GitHub Actions向けBuild Hubの概要

Bitrise Build Hubは、GitHub Actions向けの高性能なビルドインフラストラクチャであり、モバイルアプリ開発のために専用に構築されています。業界最速のAppleシリコンとLinuxマシン上でGitHub Actionsワークフローを実行する、完全マネージド型でメンテナンス不要のランナーを提供します。

GitHub Actions向けにBuild Hubを設定する方法については、GitHub Actions向けのmachine poolsの作成をご覧ください。

Bitrise Build Cacheを使用して、Build Hubマシンで実行されるビルドを高速化することもできます。各ビルドツールには専用のGitHub Actionsガイドがあります。例: GitHub ActionsでのBuild Cache for Gradleの設定。

主な機能Click to copy link​

  • iOSおよびAndroidビルドに最適化されたM4 Pro AppleシリコンとAMD EPYC Zen4/Zen5 Linuxマシン。
  • Appleのリリースから24時間以内の最新Xcodeバージョン(ベータ版を含む)。
  • プリインストール済みのツール(Xcode、Android SDK、Flutter、React Nativeなど)を備えた、モバイル向けに最適化されたスタック。
  • レイテンシーがほぼゼロで、ネットワーク送信コストがかからないコロケーションキャッシュ。
  • データレジデンシー要件に対応する米国およびEUのデータセンター。
  • キュー待ち時間なしで即座にビルドを開始できる、事前にウォームアップされたVMプール。

Build HubはGitHub CloudリポジトリとGitHub Enterprise Serverリポジトリの両方で動作します。既存のGitHub Actionsワークフローファイルは変更不要です。ビルドをBitriseインフラストラクチャにルーティングするために、runs-onラベルを更新するだけです。

要件Click to copy link​

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

  • Bitriseのworkspace。
  • GitHubアカウント。
  • Build HubマシンをGitHub Actionsに対して認証する方法。Enterpriseプランでは、Bitrise - Build Hubアプリまたはパーソナルアクセストークンのいずれかを使用できます。その他すべてのプラン(無料トライアル、Starter、Pro)ではアプリのみ使用できます。
  • Bitrise上のマシンプール: machine type、マシンの数、インスタンスの起動に必要なソフトウェア構成を含むシステムイメージを選択できます。

認証Click to copy link​

Enterpriseプランでは、Bitrise - Build Hub GitHubアプリまたはGitHubパーソナルアクセストークンのいずれかを使用してBitrise Build Hubを認証できます。その他すべてのプラン(無料トライアル、Starter、Pro)ではアプリのみ使用できます。

GitHubアプリ認証Click to copy link​

Bitrise - Build Hubアプリは、GitHubアカウントまたはGitHub組織にインストールできます。アプリのアクセス範囲は、次のいずれかに設定できます:

  • All repositories: リソースオーナーが所有する現在および将来のすべてのリポジトリ(パブリックリポジトリを含む)。
  • 特定のリポジトリ: 少なくとも1つのリポジトリを選択する必要があります。Build Hubは、同じリソースオーナーが所有する他のリポジトリにアクセスできません。

このアプリには、次のアクセス権があります:

  • actions、metadata、およびorganization eventsへの読み取りアクセス。
  • organization self hosted runnersへの読み取りおよび書き込みアクセス。

マシンプールの作成時に、任意のGitHubアカウントまたは組織にアプリをインストールできます。

GitHubパーソナルアクセストークンClick to copy link​

Enterpriseプランのみ

パーソナルアクセストークン認証は、Enterpriseプランでのみ使用できます。無料トライアルおよびセルフサーブのworkspacesでは、代わりにGitHubアプリを使用する必要があります。

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

トークンの種類によって、必要なアクセスの種類はターゲットスコープによって異なります。それぞれのターゲットスコープに必要な正確な権限については、以下の表を確認してください。

ターゲットスコープクラシックトークンに必要な権限ファイングレインドアクセストークンに必要な権限
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:adminSelf-hosted runnersへのread/write権限
GitHub Cloud repository: https://github.com/<owner>/<repo>
GHE repository: https://<hostname>/<owner>/<repo>
workflowサポートされていません

マシンプールの作成前に、パーソナルアクセストークンの作成を行ってください。

GitHub Actions用のマシンのプロビジョニングClick to copy link​

マシンプールの作成時に、ビルドを実行する一定数のマシンをリクエストする必要があります。同時に実行し続けるマシンの数は、認証方法によって異なります:

  • GitHubアプリを使用する場合: マシンはオンデマンドで作成・起動されます。GitHub Actionsワークフローが開始されると、マシンがプロビジョニングされます。複数のGitHub Actionsワークフローを同時に開始した場合、マシンプール構成で定義された最大マシン数まで、それぞれに対してマシンが起動されます。GitHub Actionsビルドが終了すると、マシンはシャットダウンされます。
  • GitHubパーソナルアクセストークンを使用する場合: マシンプールでリクエストした数のマシンが常に実行され続けます。特定の時点で必要なマシンの数が少ない場合は、マシンプール構成でマシンの数を手動で減らす必要があります。

ターゲットスコープClick to copy link​

GitHubパーソナルアクセストークンを使用してBuild Hubを認証する場合は、マシンプールの作成時にターゲットスコープを設定する必要があります。ターゲットスコープとは、特定のリポジトリやGitHub組織など、ランナーの動作が許可されるコンテキストです。

使用できるターゲットスコープは次のとおりです:

  • 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>

ウォームアップスクリプトClick to copy link​

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

ビルドの開始が失敗しないように、エラーが発生した場合にスクリプトがゼロ以外の終了コードを返すようにしてください。