プロファイル
プロファイルは、アカウントスコープで名前付きのマシンシェイプです。ワークフローのruns-onから参照すると、Tuist は一致するランナーにジョブをルーティングします。プロファイルを使えば、プラットフォーム、サイズ、Ubuntu リリース、Xcode バージョンといったインフラ選択を各ワークフローファイルに散らばらせることなく一箇所で管理でき、CI が参照できる安定したラベルを提供します。
jobs:
build:
runs-on: tuist-macos
ラベルはプロファイル名にtuist-プレフィックスを付けたものです。名前がmacosのプロファイルはruns-on: tuist-macos、名前がlinux-largeのプロファイルはruns-on: tuist-linux-largeとなります。マッチングは大文字小文字を区別しません。
デフォルトプロファイル#
Runners が有効なすべてのアカウントには、設定なしでフリートを利用できるように 2 つのプロファイルが用意されています。
| Profile | Label | Default shape |
|---|---|---|
linux |
tuist-linux |
2 vCPU / 8 GB |
macos |
tuist-macos |
8 vCPU / 24 GB, Xcode 27.2 |
どちらも、そのプラットフォームのデフォルトシェイプを指しています。これらは保護されているため削除できず、ワークフローが依存するラベルは常に解決されます。シェイプや Xcode バージョンは変更でき、他のサイズや Xcode バージョン向けに追加のプロファイルを作成することもできます。
マシンシェイプ#
Runner は macOS(Apple silicon、Mac フリート上で仮想化)および Linux で利用できます。各プロファイルは、以下のカタログから 1 つのマシンシェイプ、つまり(vCPUs, memory)のペアを固定します。
Linux#
| vCPUs | Memory |
|---|---|
| 1 | 2 GB |
| 2 | 4 GB |
| 2 | 8 GB (default) |
| 4 | 8 GB |
| 4 | 16 GB |
| 8 | 16 GB |
| 8 | 32 GB |
| 16 | 32 GB |
| 16 | 64 GB |
Linux プロファイルでは、macOS プロファイルが Xcode バージョンを選ぶのと同様に、Ubuntu リリースも選択します。
- Ubuntu 24.04(
ubuntu-24.04)。新しいプロファイルのデフォルトです。 - Ubuntu 22.04(
ubuntu-22.04)。引き続き必要なワークフロー向けです。GitHub は 22.04 のホストイメージを非推奨とし、2027 年 4 月 17 日に削除します。それまでに移行を計画してください。
プロファイルは変更するまで選択したリリースのまま維持されるため、新しいデフォルトが自動的にジョブを別の OS に移動することはありません。24.04 でビルドされたバイナリは新しい glibc(2.39)を必要とし、古いシステムでは実行できない場合があります。また、システム Python は仮想環境外でのpip installを拒否します(PEP 668)。ランナーは GitHub ホストランナーと同様にImageOS(ubuntu24またはubuntu22)を設定するため、セットアップアクションは適切なリリース向けのビルドを選択します。
すべての Linux プロファイルは、/dev/kvmを通じてハードウェアアクセラレーション対応の Android エミュレータをサポートしています。別途 KVM プロファイルは不要です。
macOS#
| vCPUs | Memory |
|---|---|
| 8 | 24 GB (default) |
| 16 | 48 GB |
大きな macOS シェイプはフリート内のマシン数が少ないため、そのシェイプを要求するジョブは、小さいシェイプの場合よりも開始までの待ち時間が長くなる可能性があります。ジョブが CPU 律速の場合は大きいシェイプを選び、それ以外はデフォルトシェイプのままにしてください。迷う場合は両方で実行し、ダッシュボードで所要時間を比較してください。
macOS プロファイルではXcode バージョンも固定します。バージョンにより、その Xcode がプリインストールされたランナーイメージが選択されるため、ジョブはツールチェーンが整った状態で開始されます。現在サポートされているバージョンは次のとおりです。
27.3-beta27.2(default)27.127.026.626.526.4.126.326.1.126.0.1
ハードウェアや Xcode のリリースを追加するにつれてカタログは進化します。ダッシュボードの新規プロファイルフォームとtuist runner profile catalogには、アカウントで現在利用可能なシェイプ、Xcode バージョン、Ubuntu リリースが常に表示されるため、これらを信頼できる情報源として扱ってください。
macOS ランナーの名前には、実行中の macOS バージョン、プロファイルの Xcode バージョン、シェイプが含まれます。例:tuist-macos-26.6-xcode-27.0-8vcpu-24gb-1a2b3c4d5e6f。この名前は、GitHub 上のジョブのSet up jobステップと、Tuist ダッシュボードのジョブ詳細に表示されます。
プロファイルの作成#
- アカウントダッシュボードのRunners → Profilesセクションを開きます。
- 新規プロファイルを選択します。
- 名前を付け、プラットフォームを選び、シェイプを選択します。Linux の場合は Ubuntu リリースも選択し、macOS の場合は Xcode バージョンを選択します。
- 保存し、ワークフローから
runs-on: tuist-<name>で参照します。
コマンドラインからプロファイルを管理することもできます。プロファイルの作成、変更、削除には、ダッシュボードと同様のアカウント管理者権限、またはaccount:runners:writeスコープを持つアカウントトークンが必要です。
tuist runner profile catalog
tuist runner profile create linux-large --platform linux --vcpus 8 --memory-gb 32
tuist runner profile update linux-large --vcpus 16 --memory-gb 32
tuist runner profile delete linux-large --yes
エージェントは、MCP サーバーを通じて同じ操作を行えます。
例えば、8 vCPU / 32 GB シェイプで名前がlinux-largeのプロファイルの場合。
jobs:
integration-tests:
runs-on: tuist-linux-large
あるいは、Xcode 26.4.1に固定された名前がxcode-26-4の macOS プロファイルを使用すれば、デフォルトのmacosプロファイルが最新を追跡している間、ジョブを古いツールチェーンで実行できます。
jobs:
build-legacy:
runs-on: tuist-xcode-26-4