プロジェクトと必要なファイルを移行
まずはバージョン管理システムからコードをチェックアウトし、未登録の設定ファイルやビルドリソースを洗い出します。転送前に機密情報を確認し、認証情報をリポジトリやログに含めないようにしてください。
完了の確認：クラウド上のディレクトリに必要なプロジェクトファイルがあり、機密ファイルへのアクセス範囲も確認できています。
初めての方へ · 操作ガイド
クラウドMacを注文して、最初のビルド成果物を手に入れるまで。
専有物理MacでXcodeやmacOS CIを実行する開発者向けのガイドです。機種と拠点を確認し、接続情報とツールチェーンをチェックしてから、再現可能なビルドを実行します。
ページ内のコマンドや応答はサンプルであり、お客様のプロジェクト向けに設定済みという意味ではありません。実際の接続情報、デバイスの状態、提供状況はコンソールでご確認ください。
初回ビルドのチェックリスト
01 / 04
リモートノードにプロジェクトを渡す前に、次の4項目を確認しましょう。
- デバイス
- M4またはM4 Proの専有物理Macを選択
- 拠点
- チームに必要な提供中の拠点を確認
- 接続
- コンソールに表示された情報で接続
- ビルド
- ツールチェーンのバージョンと成果物の保存先を記録
チェックリスト例 · 実際の構成は注文内容とコンソールをご確認ください
目的から探す
今いるステップから始めましょう。
操作の流れに沿った5つのガイドです。注文済みの方は、接続またはトラブルシューティングから始められます。
01
注文・利用開始
機種、拠点、利用期間、注文状況を確認し、次に接続情報をどこで取得するか把握できます。
利用開始の流れを見る → 02リモート接続
SSHの接続情報を確認し、コマンドラインで行う作業とGUIが必要な操作を区別します。
接続例を見る → 03ビルド環境
プロジェクトをチェックアウトし、Xcodeと依存関係を確認して、成果物が所定の場所に出力されたか検証します。
ビルド手順を見る → 04CIの導入
Runnerの識別情報、ジョブタグ、署名権限を確認してから、自動ビルドを開始します。
導入前の確認を見る → 05請求・注文管理
利用期間とオプションを確認します。注文内容の確認や問い合わせはコンソールで行えます。
管理方法を見る →
利用開始まで · 手順例
4ステップで初回ログイン。
右側の所要時間は操作例の目安であり、デバイスの提供時間ではありません。実際の提供時期や接続情報の発行状況は、コンソールの注文・デバイス状況をご確認ください。
約4分操作例の合計時間（デバイス提供待ち時間を除く）
- 01操作例：約1分
機種と拠点を選ぶ
プロジェクトに必要なメモリとストレージをもとに提供中の構成を選び、チームの所在地や連携するタイムゾーンに合わせて拠点を選択します。提供内容を確認してから注文へ進みましょう。
- 02操作例：約1分
注文する
利用期間と任意のオプションを確認して注文します。提供状況と利用可能な決済ゲートウェイは、コンソールに表示される最新情報をご確認ください。
- 03操作例：約1分
接続情報を取得する
デバイスが準備完了になるまで待ち、コンソールでそのインスタンスに割り当てられたアドレス、アカウント、接続手順を確認します。公開されているサンプルから認証情報をコピーしないでください。
- 04操作例：約1分
初回ログインと環境確認
接続して現在のアカウント、ディスク容量、Xcodeツールチェーンのバージョンを確認します。条件が合わない場合は自動ジョブを停止し、出力を記録してください。
接続とコマンド · 情報を伏せたサンプル
ノードに接続し、ビルドを実行して確認しましょう。
SSHはコードのチェックアウト、ビルドの実行、ログの確認に適しています。XcodeのGUI操作が必要な場合は、インスタンスに記載されたリモートデスクトップの接続手順をご利用ください。
$ ssh developer@192.0.2.10
Last login: example session
$ xcodebuild -version
Xcode
Build version: example
$ xcodebuild -workspace App.xcworkspace \
-scheme App -configuration Release \
-destination 'generic/platform=iOS' build
** BUILD SUCCEEDED **
$ fastlane build
[example] Build completed
[example] Artifact: ./build/App.ipa実行前に置き換える項目
- アドレスとアカウント：サンプルのアドレスでは接続できません。現在のインスタンス用にコンソールで案内されている情報のみを使用してください。
- プロジェクトとScheme：コマンド内のプロジェクトファイル名とSchemeを実際のリポジトリ名に置き換え、対象プラットフォームも確認してください。
- 成功の確認：終了コード、ビルドログ、成果物ファイルをすべて確認してください。サンプル出力はお客様のプロジェクトの実行記録ではありません。
ローカルからクラウドへ
移行するのはプロジェクトファイルだけでなく、再現可能な手順です。
ローカルMacからクラウドMacへ：まずソースコードと依存関係を取得できるようにし、ツールチェーンを確認してから、CIジョブの実行先を新しいノードに切り替えます。
Xcodeと依存関係を確認
ローカルで使用しているXcode、コマンドラインツール、パッケージ管理ツールのバージョンを記録します。クラウド環境で依存関係を再解決し、プロジェクトの最低OSバージョンとアーキテクチャ要件を照合してください。
完了の確認：同じSchemeでコマンドラインからビルドを開始でき、バージョンの違いも記録されています。
CI Runnerを導入
新しいノードに専用のRunner識別情報とジョブタグを設定します。まず公開用認証情報を必要としない検証ジョブを実行し、その後、ビルドに必要な権限を確認してください。
完了の確認：テストジョブが想定したノードで実行され、ログと成果物を追跡できます。
Xcodeクラウドビルド
最初のビルドを検証可能な基準にしましょう。
まず手動でビルドを最後まで実行し、バージョン、コマンド、エラー出力を記録してから自動化するか判断します。署名や依存関係の要件はプロジェクトごとに設定してください。
01
プロジェクトをチェックアウト
チームで承認された方法でリポジトリを取得し、対象コミット、サブモジュール、ロックファイルを確認します。まず git statusを実行し、不明な変更がある状態でビルド結果を判断しないようにしてください。
02
署名情報を管理
証明書、プロビジョニングプロファイル、必要な鍵を誰が管理し、誰が読み取れるかを決めます。秘密鍵を公開リポジトリに置いたり、認証情報一式を問い合わせに貼り付けたりしないでください。
03
ビルドを実行
まず xcodebuild -version とプロジェクトのSchemeを確認してから、実際に使用するビルドコマンドを実行します。ログ末尾だけを切り取るのではなく、終了コードと最初の有効なエラーを記録してください。
04
成果物を取得
成果物のファイル、サイズ、保存先を確認し、チームの手順に従って保管または移動します。ビルド成功の表示だけで判断せず、実際のファイルと署名結果も確認してください。
CI/CDの導入
Runnerを検証してから自動ビルドを開始。
GitLab CI macOS Runnerを導入するには、ノードにRunnerをインストールして登録し、権限を持つプロジェクトに関連付け、ジョブタグで実行先を指定します。登録方法、アクセス範囲、並列実行の設定は、チームのCI管理方針に従ってください。
最初の検証ジョブでは、システムとXcodeのバージョンだけを出力する方法があります。これにより、ジョブが想定したApple Siliconノードに到達したことは確認できますが、署名、依存関係のダウンロード、リリース工程が利用可能であることまでは確認できません。
ビルド前の権限チェック
- Runnerの識別情報：登録範囲、実行アカウント、ジョブタグを確認し、別のノードでジョブが実行されないようにします。
- プロジェクトへのアクセス：リポジトリ、サブモジュール、非公開の依存関係に実行アカウントからアクセスできることを確認します。
- 署名情報へのアクセス：ビルドに必要なジョブにのみ必要な情報を渡し、ログに機密情報が出力されないことを確認します。
- 成果物の保存先：完全なビルドを実行する前に、アーカイブ先、読み取り権限、削除の担当者を決めておきます。
fastlaneは既存のビルド工程に活用できますが、プロジェクトごとの権限、署名、バージョン確認に代わるものではありません。
注文と請求
利用条件と実行するジョブを分けて確認。
注文前に機種、拠点、日・週・月・四半期単位の利用期間、SSD拡張やThunderbolt 5の並列接続が必要かを確認してください。オプションは個別に料金が発生します。最終的な選択内容と金額は注文確認画面をご確認ください。
お支払いはUSDT-TRC20、Visa / Mastercard / Amex（Stripe）のみ対応しています。すべて米ドル（USD）で決済されます。利用可能な決済ゲートウェイはコンソールの表示をご確認ください。
注文済みの場合の確認項目
コンソールで注文番号、利用期間、拠点、オプション、デバイスの状態を確認してください。注文に関する請求の質問は、ログイン後に注文番号と確認したい項目を添えてお問い合わせください。公開メッセージに決済情報を記載しないでください。
コンソールへ
トラブルシューティング
まず、どの段階で問題が起きたか確認しましょう。
サポートに問い合わせる前に、発生日時、インスタンスの注文番号、実行した操作、機密情報を伏せたエラー内容を記録してください。パスワード、秘密鍵、署名証明書、マスキングしていないプロジェクト資料は送信しないでください。
接続できない
まずコンソールでデバイスの状態、アドレス、アカウントを確認し、ローカルネットワークと接続方法をチェックします。接続コマンド、エラーの種類、発生時刻を記録し、認証情報は伏せてください。
ビルドに失敗する
コミット、Xcodeのバージョン、Scheme、実行したコマンド全体、最初の有効なエラーを記録します。依存関係の取得、コンパイル、署名、エクスポートのどの段階で失敗したかを特定し、「ビルドに失敗しました」という末尾だけを共有しないでください。
ディスク容量が足りない
プロジェクトのディレクトリ、ビルドキャッシュ、成果物の使用量を確認し、チームで安全に削除できるファイルを先に特定します。機密情報を伏せた容量の内訳とエラーが発生したパスを添え、保管が必要な成果物を誤って削除しないようにしてください。
アクセス権限に問題がある
現在の実行アカウント、ファイルの所有者、リポジトリや署名情報へのアクセス権を確認します。影響のあるパスとエラーを記録し、すべてのファイルの権限を拡大して問題を回避しないでください。
準備はできましたか？
拠点を選んで、次のビルド環境を整えましょう。
3つの機種プランと利用期間を確認し、コンソールで最新の提供条件をご確認ください。接続したら、再現可能な検証ビルドから始めましょう。