注文から最初のビルドまで

クラウドMacを
開発フローに組み込む

この入門ガイドでは、準備物、2種類の専用物理マシン、4つのノード、初回SSHログイン、Xcodeビルド検証を扱います。順番に進め、各手順を完了してから次へ進んでください。

2種類のモデル 4つのノード SSHとGUI
シンガポール 東京 ソウル 香港
準備 アカウント、SSH公開鍵、ツールチェーン要件
納品 コンソールの確認時刻を基準
受け入れ確認 接続・システム・ビルドの3項目を確認
ステップ 01 · 開始前の確認

接続情報とツールチェーンを事前に揃える

注文前に、接続、ビルド、権限管理の担当者を明確にすると、納品後の情報補完を減らせます。以下の5項目にはすべて明確な担当者を設定してください。

コンソールアカウント

注文担当者がコンソールにログインし、注文、請求、ノード、デバイスの状態を確認できることを確認します。技術責任者は、誰がチケットを送信し、更新手続きを行うか把握しておきます。

完了条件:アカウントページにアクセスできる

SSH公開鍵

チームで承認したEd25519公開鍵を用意し、公開鍵の内容だけを提出します。秘密鍵は管理対象のデバイスまたは鍵管理システムに保管し、メール、チケット、リポジトリで共有しないでください。

完了条件:公開鍵フィンガープリントを登録済み

Xcodeバージョン

プロジェクト、CI設定、依存関係から対象のXcodeバージョンを確認し、最低macOS要件も記録します。「最新版」とだけ記載せず、照合可能なバージョン番号を残してください。

完了条件:バージョンマトリクスを確認済み

コードリポジトリの権限

制限付きデプロイキーまたは短期トークンで必要なリポジトリを読み取れることを確認します。まず最小権限の範囲を定め、その後に成果物の書き込みやステータス更新を許可するか判断します。

完了条件:読み取りと書き戻しの範囲が明確

リモートデスクトップクライアント

GUI操作が必要な場合は、VNCまたはmacOS画面共有クライアントを事前に用意します。自動化、診断、ファイル操作にはSSHを優先し、GUIセッションへの依存を減らします。

完了条件:接続方法を決定済み
ステップ 02 · プランとノードを選ぶ

同時実行数、ワーキングセット、利用期間で2つの構成から選ぶ

2種類のモデルはいずれもApple Silicon物理ノード上の専用物理マシンで、仮想マシンではありません。シンガポール、東京、ソウル、香港を選択でき、実際の利用可否は注文時にコンソールが返すリアルタイム情報を基準とします。

基本ビルド

ZoomMini M4 Core

M4 · 16GB RAM · 256GB SSD

$20.7 1日
1日 $20.7 1週間 $56 1か月 $103.7 1四半期 $282.1

単一のiOSビルドパイプライン、日常的なmacOSコンパイル、依存関係の検証、継続稼働する軽量なセルフホストrunnerに適しています。

選定基準:クリーンビルドのピークメモリとディスクのワーキングセットを一度測定し、依存キャッシュ、ログ、成果物のための容量を確保します。

ノードの範囲

4つのノードを遅延と連携の観点から評価する

主な開発者、コードソース、自動化のスケジューリング入口に近いノードを選びます。単一のpingだけでなく、稼働時間帯の安定性とリモートデスクトップ体験も確認してください。

  • シンガポール東南アジアとの連携とビルド接続に適しています
  • 東京日本および周辺チームからのアクセスに適しています
  • ソウル韓国および北東アジアのワークフローに適しています
  • 香港華南および東南アジアとの連携に適しています
期間と追加オプション

支払い前に構成全体を確認する

日、週、月、四半期単位でレンタルできます。短期検証では想定テスト時間に合わせて期間を選び、安定したパイプラインではリリースの頻度と更新担当を踏まえて期間を決めます。

+1TB SSD
1日 $2.9 · 1週間 $7.7 · 1か月 $14.3 · 1四半期 $38.9
+2TB SSD
1日 $5.8 · 1週間 $15.4 · 1か月 $28.6 · 1四半期 $77.8
Thunderbolt 5の並列接続
1台あたり1日 $1.9 · 1週間 $5.2 · 1か月 $9.6 · 1四半期 $26.1
ステップ 03 · 支払いを完了する

注文のUSD明細に従って決済する

注文には基本モデル、期間、ノード、追加オプションが個別に表示されます。価格と決済はすべて米ドル(USD)で統一され、支払いの送信前に注文担当者が再確認してください。

USDT-TRC20

コンソールに表示された支払い情報で、ネットワーク、金額、注文IDを確認します。送金前にTRC20ネットワークであることを確認し、送信後は照合用の取引記録を保管してください。

決済通貨:USD

Visa / Mastercard / Amex

カード決済はStripeで処理されます。支払いページから戻ったら、コンソールで注文ステータスと請求額を確認してください。ブラウザの戻り先ページをデバイス納品の根拠にしないでください。

決済通貨:USD
01モデルを確認

モデル名、M4チップ、メモリ、標準SSDが選択したプランと一致していることを確認します。

02期間を確認

日、週、月、四半期のいずれかを確認し、テスト期間を長期期間と間違えないようにします。

03ノードを確認

シンガポール、東京、ソウル、香港のいずれかが接続計画と一致していることを確認します。

04追加オプションを確認

SSD拡張とThunderbolt 5の並列接続数を確認してから、支払いを送信します。

実際に利用できる決済ゲートウェイはコンソールの表示を基準とします。支払い完了はデバイスに接続できることを意味しないため、注文ステータスと納品情報を引き続き確認してください。

ステップ 04 · 納品情報を確認する

コンソールのデバイス記録を接続の根拠にする

デバイスの状態が接続可能になってから、アドレス、アカウント情報、利用期間を確認します。チャット履歴、古いスクリーンショット、別の注文の接続情報は使用しないでください。

納品記録

初回接続前に必ず確認する6項目

各項目は同じ注文の情報である必要があります。ノード、アドレス、利用期間が想定と異なる場合は接続を停止し、コンソールからチケットを送信してください。

デバイスの状態
記録に接続可能と明記されていることを確認してから、SSHまたはGUIセッションを開始します。
ノード
シンガポール、東京、ソウル、香港のいずれが注文時に選択したノードか確認します。
接続アドレス
割り当てられたホストアドレスとポートをコピーし、手入力による文字ミスを避けます。
アカウント情報
割り当てられたユーザー名、初回認証情報の扱い、利用可能な接続プロトコルを確認します。
利用期間の開始
サービス開始時点を確認し、注文記録と一致させるために使用します。
利用期間の終了
更新、成果物のアーカイブ、データ移行、権限回収を計画するために使用します。

まだ接続できない状態

コンソールで注文ステータスを確認し続けてください。納品時間はコンソールの確認時刻を基準とし、まだ提供されていない接続アドレスを繰り返し試さないでください。

コンソールの状態を見る

項目を確認する必要があります

チケット送信時には、注文ID、想定ノード、現在のデバイス状態、問題を確認した時刻を記載し、パスワード、秘密鍵、完全な支払い情報は記載しないでください。

コンソールからチケットを送信
ステップ 05 · 初回接続

まずホストフィンガープリントを確認し、システム情報を取得する

初回SSH接続で重要なのは、すぐに依存関係をインストールすることではありません。対象アドレス、ホストフィンガープリント、ログインユーザー、ハードウェア情報が現在の注文に属することを確認します。

first-connection · zsh
$ export ZOOMMINI_HOST=assigned-host
$ ssh-keyscan -t ed25519 "$ZOOMMINI_HOST" | ssh-keygen -lf -
256 SHA256:7qV3mL9kR2nF4cX8 assigned-host (ED25519)

$ ssh build@"$ZOOMMINI_HOST"
Last login: remote session
build@zoommini-node ~ %

$ sw_vers
ProductName:            macOS
ProductVersion:         15.2
BuildVersion:           24C101

$ system_profiler SPHardwareDataType
Hardware:
    Model Name: Mac mini
    Chip: Apple M4
    Memory: 16 GB

$ uname -m
arm64
01

コンソールから接続アドレスをコピー

割り当てられたアドレスを一時環境変数またはSSH configに設定し、コマンド履歴に誤ったアドレスが残るのを防ぎます。標準以外のポートを使う場合は、ポートパラメータも記録してください。

02

ホストフィンガープリントを個別に確認

ローカルで取得したEd25519フィンガープリントを納品記録と1文字ずつ比較します。一致しない場合は接続を停止し、変更後の記録をそのまま受け入れないでください。

03

システムとハードウェアを確認

sw_vers でmacOSのバージョンを確認し、system_profiler でチップとメモリを確認し、uname -marm64を返す必要があります。

ステップ 06 · ビルド検証

3つのコマンドでツールチェーンがパイプラインに入れるか判断する

まずXcodeの選択を確認し、次にプロジェクトをビルドし、最後に自動テストを実行します。成功を画面だけで判断せず、各手順の終了コードと主要ログを保存してください。

確認 01 Xcodeバージョンを確認
$ xcodebuild -version
Xcode 16.2
Build version 16C5032a
成功の判定

Xcodeのバージョンとビルドバージョンがプロジェクトのマトリクスと一致し、コマンドの終了コードが0であること。

確認 02 プロジェクトをビルド
$ xcodebuild -scheme App build
Prepare packages
CompileSwiftSources normal arm64
Ld App normal arm64
** BUILD SUCCEEDED **
成功の判定

出力の末尾に BUILD SUCCEEDEDが表示され、署名、依存関係、ディスク容量のエラーがないこと。

確認 03 自動テストを実行
$ fastlane ios test
Resolving Swift Package Manager dependencies
Test Suite 'All tests' passed
Executed 48 tests, with 0 failures
fastlane.tools finished successfully
成功の判定

テスト数が想定どおりで失敗数が0、fastlaneが正常終了し、プロセスの終了コードが0であること。

バージョンが一致しない

まず xcode-select -p で現在の開発者ディレクトリを確認し、チームのバージョンマトリクスに従って切り替えます。バージョン問題を回避するためにプロジェクトファイルを直接変更しないでください。

依存関係の解決に失敗

リポジトリ権限、パッケージマネージャーのパス、ネットワークアクセス範囲を確認します。キャッシュを消去する前にエラーログを保存し、最初の失敗の証拠を失わないようにしてください。

署名手順に失敗

証明書、プロビジョニングプロファイル、runner権限の読み込み方法を確認します。秘密情報は管理対象の鍵管理システムから注入し、スクリプトやビルドログに記載しないでください。

ステップ 07 · 納品後のセキュリティ強化

ビルド成功後、一時アクセスを長期運用の構成に切り替える

受け入れ確認の成功は、ツールチェーンが利用可能になったことを示すだけです。正式にCI/CDへ接続する前に、認証情報の更新、公開鍵管理、権限回収、runnerの最小権限設定も完了してください。

01

アカウント認証情報を更新

納品案内に従い、交換が必要な初期認証情報を更新します。固有の管理されたパスワードを使用し、ローカル開発マシン、リポジトリ、他のノードで使い回さないでください。

確認方法 現在のセッションを終了して再ログインし、古い認証情報が無効になっていることを確認します。
02

SSH公開鍵を設定

アクセスが必要なユーザーと自動化IDごとに公開鍵を設定します。複数人で同じ秘密鍵を共有せず、公開鍵のコメントから具体的な用途を追跡できるようにしてください。

確認方法 認証キーを1つずつテストし、対応する担当者とローテーション計画を記録します。
03

不要なアクセス権を削除

テスト中に一時的に追加した公開鍵、リポジトリトークン、管理者権限、リモートデスクトップ認証を削除します。離脱したメンバーと無効化したrunnerのアクセスは直ちに回収してください。

確認方法 認証キー、ユーザーグループ、起動項目、runnerの登録記録を確認します。
04

CI runnerの権限を制限

runnerには、必要なリポジトリの読み取り、指定スクリプトの実行、指定された成果物保存先への書き込みだけを許可します。システム管理権限やプロジェクト横断トークンを標準で付与しないでください。

確認方法 最小権限のIDでビルドを1回実行し、権限外の操作が拒否されることを確認します。
利用開始可能

最終受け入れチェックリスト

次の5項目をすべて満たしてから、ノードを正式なスケジュールに追加します。注文項目、SSHフィンガープリント、システム仕様が一致し、ビルドとテストの終了コードが0で、一時権限が回収済みであること。

  • ノードと利用期間を記録済み
  • ホストフィンガープリントを照合済み
  • Xcodeバージョンを確認済み
  • ビルドとテストに合格
  • 最小権限が有効

最初のビルドパイプラインに接続する準備が整いました

まずモデル、ノード、期間を選択します。デバイスに接続できるようになったら、このページの順序に従ってフィンガープリント照合、システム確認、ビルド検証、権限強化を完了してください。