マシン、リージョン、期間を選ぶ
ZSH 16は、まずビルドを1つ動かしてみたい場合に適しています。並列ビルドや常時稼働のランナーにはZSH 24をご検討ください。MLXの実験により大きなユニファイドメモリが必要なら、ZSH Pro 64をご覧ください。次に、チームの主な接続場所に合わせてリージョンを選びます。
確認項目：マシン、SSD容量、リージョン、日・週・月・四半期の利用期間。
開発環境の引き継ぎガイド
契約から初回ビルドまで
専有物理マシンのクラウドMacを借りて、既存のリポジトリやツールチェーン、パイプラインを接続しましょう。操作順に沿って解説します。リポジトリとビルドスクリプトがある場合、環境移行に約30～60分を見込んでください。データ転送とXcodeのダウンロード時間は別途必要です。
インスタンスをお持ちですか？コンソールで接続情報を確認以下のコマンドと出力は操作例です。実際のアドレスと認証情報はコンソールに表示される内容をご確認ください。
構成を選ぶ認証情報を確認環境を移行ビルドを検証
始める前に
まず契約し、接続情報を記録
契約時に決めるのは3点です。マシンの種類はコンパイルや並列タスクに使えるリソースを左右し、リージョンはリモート操作の遅延に影響します。利用期間は課金サイクルで決まります。3つのプランはいずれもマシン全体を専有できる物理マシンで、仮想マシンではありません。利用可能状況はコンソールの最新表示をご確認ください。
米ドルで支払う
USDT-TRC20、またはStripe経由のVisa / Mastercard / Amexに対応しています。USDTの送金前にTRC20ネットワークを確認してください。カード決済はチェックアウト画面に表示される決済ゲートウェイをご利用ください。
確認項目：決済結果とコンソール上の注文ステータス。利用可能な決済ゲートウェイはバックエンドの表示をご確認ください。
SSHと画面共有の認証情報を確認
インスタンスの引き渡し後、コンソールで接続先アドレス、ユーザー名、初回ログイン用認証情報、ホストフィンガープリントを記録してください。これらの情報をリポジトリやビルドログ、チームの共有ドキュメントに記載しないでください。
確認項目：SSHでログインでき、macOSのデスクトップ画面を開けること。
移行の順序
データ、ツールチェーン、CIの順に引き継ぐ
まず新しいマシンでリポジトリを単独でビルドし、成功を確認してから自動化タスクに接続します。エラーが発生した場合、データ不足、ツールのバージョン不一致、ランナーの設定問題のどれが原因か切り分けやすくなります。
01データ
リポジトリと署名用データを移行
次の方法で rsync リポジトリを転送するか、管理されたリモートリポジトリから再度チェックアウトします。証明書、プロビジョニングプロファイル、キーチェーンの書き出しファイルは、それぞれ暗号化して転送してください。秘密鍵を通常の同期フォルダに置かないでください。
- リポジトリのブランチ、サブモジュール、Git LFSのファイルがそろっていることを確認します。
- 署名用データを読み込んだら、ビルド用ユーザーのセッションでキーチェーンにアクセスできるか確認します。
- ビルドに必要な環境変数を照合し、ローカルの秘密鍵を平文のままコピーしないでください。
手作業での確認時間の目安：10～20分。転送時間はデータ量によって異なります。
02ツールチェーン
バージョンを固定してからキャッシュを復元
Homebrewでコマンドラインツールをインストールし、xcodesでプロジェクトに必要なXcodeのバージョンを管理します。まず、 xcode-select の参照先を確認してから、fastlane、CocoaPods、SPMに必要な依存関係をそろえます。
- 以下を記録します：
xcodebuild -versionとプロジェクトで指定されているバージョン。 - 依存関係の解決を一度実行し、古いマシンの絶対パスをキャッシュに持ち込まないようにします。
- まず1つのschemeでローカルビルドを成功させてから、並列テストに進みます。
手作業での確認時間の目安：10～20分。ソフトウェアのダウンロード時間は別途必要です。
03パイプライン
最後に専用ランナーを登録
マシンを既存のGitHub ActionsまたはGitLab Runnerのワークフローに接続します。リポジトリまたは組織が提供する登録手順に従い、専用のシステムアカウントでビルドタスクを実行してください。
- マシンの種類とリージョンがわかるランナーラベルを設定します。
- テストタスクでXcode、署名、成果物の出力先を確認します。
- 同時実行数を制限し、タスク終了後に機密性の高い一時ファイルが残らないことを確認します。
手作業での確認時間の目安：10～20分。初回タスクの時間は別途必要です。
ここに記載した時間は手作業での確認に必要な時間の目安であり、開通やダウンロードにかかる時間を保証するものではありません。キャッシュに大きく依存するビルドでは、まず再現可能な設定を移行し、キャッシュファイルを転送するかどうかはその後に判断してください。
動作確認
3つのコマンドで環境を確認
以下はターミナル操作の例であり、インスタンスの実際のアドレス、フィンガープリント、ビルド結果ではありません。例のアドレスとschemeは、コンソールとプロジェクトに記載された値に置き換えてください。SSHで初めて接続するときは、コンソールに表示されたホストフィンガープリントと一字一句照合してください。
接続とフィンガープリントの確認
zsh % ssh -o StrictHostKeyChecking=ask mac@203.0.113.10
The authenticity of host '203.0.113.10' can't be established.
Host key verification required before continuing.ビルドを検証
zsh % xcodebuild -version
Xcode 16.2
zsh % xcodebuild -scheme App -configuration Release build
** BUILD SUCCEEDED **配布ワークフローを検証
zsh % fastlane beta
Running lane 'beta'
Archive complete
Upload to TestFlight complete
グラフィカルインターフェース
デスクトップ操作が必要な場合は画面共有
SSHは依存関係のインストール、コードの取得、ビルドの実行に適しています。Xcodeの設定やシミュレーター、グラフィカルツールにはmacOSの画面共有を使用してください。コンソールでインスタンスの画面共有アドレスと認証情報を確認し、手元の画面共有クライアントから接続します。
初めてデスクトップに接続したら、現在のネットワークに適した解像度とスケーリングか確認してください。リモート操作が遅い場合は、まず解像度を下げ、不要なアニメーションを無効にしてから、ネットワークごとの接続品質を比較します。クリップボード同期は機密情報を含まないテキストに限って使用してください。証明書や秘密鍵の転送には、管理された暗号化経路を利用してください。
DISPLAY / CONNECT接続前の確認
- アドレスと認証情報
- 現在のインスタンスのコンソールページで確認してください。他のインスタンスの記録を流用しないでください。
- 画面設定
- まず見やすく安定した解像度を選び、帯域に合わせて画質を調整します。
- クリップボード
- 必要なテキストだけを同期してください。機密ファイルには別の転送手順を使用します。
- 接続の問題
- インスタンスの状態とアドレスを確認し、次にローカルネットワークとファイアウォールの設定を確認します。
引き渡し後の確認
初回のセキュリティ設定を完了
接続できただけでは、引き継ぎは完了していません。次の4項目を終えてから、インスタンスを常時稼働のCIに接続してください。ログイン成功時のスクリーンショットだけに頼らず、実際にこのマシンを使うチームが各項目を確認してください。
- 01 初期パスワードを変更 macOSで引き渡しアカウントの新しいパスワードを設定し、チームで管理している認証情報の記録も更新してください。チャット履歴やパイプライン変数の説明に、パスワードを平文で貼り付けないでください。
- 02 SSH鍵に切り替え まず公開鍵を登録し、新しいターミナルを開いてログインできることを確認してから、パスワード認証の設定を変更します。設定ミスで接続できなくなるのを防ぐため、現在のセッションは開いたままにしてください。
- 03 ファイアウォールを確認 macOSのファイアウォールを有効にし、開発と画面共有に必要なアクセスを項目ごとに確認してください。変更前に現在のルールを記録し、管理用の接続を維持できることを確認します。
-
04
システムアップデートを計画
定期的に
softwareupdate -lを実行してアップデートを確認します。ビルド環境に影響するアップグレードを行う前にデータをバックアップし、Xcodeとプロジェクトの互換性を確認してください。
利用期間の管理
更新前に期間を確認し、解約前にデータを退避
現在の利用期間、請求内容、更新手続きはコンソールの注文ページで確認してください。期限のお知らせもコンソールと実際に届いたサービス通知をご確認ください。ローカルのカレンダーだけで期限を判断しないでください。引き続き利用する場合は、コンソールでマシン、リージョン、期間、金額を確認してから更新します。
利用を終える前に、未プッシュのリポジトリ変更、署名用データ、ビルド成果物、必要な監査記録をバックアップしてください。別のデバイスでバックアップを読み取れることを確認してから、コンソールで解約手続きを行います。解約後はディスクの消去とOSの再インストールが実行されます。解約をバックアップ手段として使わないでください。
関連記事
状況に合った次のガイド
SSH、VNC、日常的な開発環境について詳しく知りたい場合は、技術記事一覧からリモートMac開発環境の構築方法をご覧ください。ビルドパラメーター、キャッシュ、ランナー設定については、クラウドXcodeビルドガイドをご覧ください。インスタンスの不具合や請求に関するお問い合わせは、テクニカルサポートをご利用ください。
リモートMac開発環境の構築
SSH鍵、Homebrewの初期設定、画面共有、エディターからのリモート接続について詳しく解説します。
クラウドXcodeビルド完全ガイド
Xcodeのバージョン、ビルドキャッシュ、テストコマンド、セルフホストランナーの接続方法を詳しく確認できます。
テクニカルサポートセンター
接続できない、ビルド環境に問題がある、更新方法がわからない場合は、まずトラブルシューティング項目を確認し、コンソールからサポートチケットを送信してください。
次のステップ / 設定を始める
最初のビルドを実行
まずマシン、リージョン、期間を選びます。インスタンスが準備できたら、このページのチェックリストに沿って接続、移行、検証を進めてください。