初回利用
注文確認から初回検収まで
選択したモデル、データセンター、利用期間を確認し、自動準備と認証情報の発行を待ちます。初回接続後にノード情報を記録し、CLI、GUI、Xcode環境を個別に検証してください。
- 注文ステータスと有効期限を確認
- ホストフィンガープリントを確認して最初のセッションを確立
- 検収結果を保存し、平文の認証情報は保存しない
タスクから問題を特定
クラウドMac ヘルプセンター：接続からビルドまで順に確認
まず問題が利用開始、接続、ツールチェーン、パイプライン、ストレージ、利用期間のどれに該当するかを確認します。ノード情報、認証情報、ポート、ディスク、システムタスクを順に確認し、各手順で実行内容とサポート依頼に必要な情報を示します。
- 6種類のタスク
- 利用開始、接続、ツール、CI/CD、ストレージ、利用期間
- 5ステップ診断
- ノード範囲から具体的なタスクへ
- 2つのサポート窓口
- コンソールのサポート依頼とサポートメール
診断記録ボード
順番に確認
事実を記録してから設定を変更
-
01
注文ノードを確認 データセンター、ホスト名、注文ステータスを記録
-
02
認証情報の状態を確認 キー、有効期限、直近のローテーションを確認
-
03
ネットワーク経路を検証 DNS、ポート、ローカルネットワークの問題を切り分け
-
04
リソース残量を確認 ディスク容量、メモリ、バックグラウンドタスクを確認
-
05
マスキング済みの証跡を保存 時刻、コマンド、終了コード、ログの抜粋を収集
推奨記録
ノード · 時刻 · コマンド · 終了コード
タスク入口
現在の作業に合う手順を選ぶ
すべてのドキュメントを最初から読む必要はありません。最も近いタスクを選び、カードの確認手順に沿って実行してください。注文ステータス、有効期限、認証情報は、コンソールに現在表示されている内容を基準にします。
リモート接続
SSHまたはVNCセッションを確立
SSHはCLI、自動化、トンネル作業に適し、VNCはmacOSのGUIが必要な操作に適しています。まずノードと認証情報を確認し、ローカルネットワークとポートを確認してください。
- 初回接続では必ずホストフィンガープリントを確認
- 切断時はローカルネットワークとノード上のセッションを切り分け
- 共有デバイスに機密性の高い接続情報を残さない
開発ツール
Xcodeとビルド環境を確認
コマンドでXcodeのバージョン、アクティブなDeveloperディレクトリ、ツールチェーンの状態を記録します。バージョン変更前に現在の出力を保存し、プロジェクトの問題と環境変更を混同しないようにします。
- 記録
xcodebuild -version出力 - プロジェクト、依存関係、キャッシュの保存先ディスクを確認
- 削除前にエラー概要全体を保存
CI/CD
self-hosted runnerを検証
まずrunnerのオンライン状態、ラベルの一致、ワークディレクトリの権限を確認し、最小テストタスクを実行します。最初からパイプライン全体を再実行すると、失敗箇所を特定しにくくなります。
- runnerのラベルとタスク条件を確認
- ワークディレクトリとキャッシュディレクトリの権限を検証
- 失敗したタスクの終了コードとマスキング済みログを保存
ストレージ管理
容量、キャッシュ、拡張ニーズに対応
まずプロジェクトファイル、依存関係キャッシュ、ビルド成果物、ログの使用量を切り分けます。容量が増え続ける場合は、実際の増加量に応じて+1TB SSD、+2TB SSD、またはクリーンアップ方法を選択してください。
- 空き容量と最大ディレクトリを確認
- 再生成可能なキャッシュと業務データを区別
- 拡張前に重要データをバックアップ
利用期間の管理
更新、期限、移行を確認
操作の基準はコンソールに表示される注文の有効期限です。更新後にステータスを再確認し、利用終了時はコード、キー、証明書、ログ、業務データを事前に移行してください。
- 現在の有効期限と必要な期間を記録
- 更新完了後に注文ステータスを再確認
- 終了前にバックアップ、キーの失効、クリーンアップを実行
簡易診断
現在失敗している確認項目を選ぶ
外側から内側へ順に確認します。最初に失敗した項目をクリックすると、記録ボードが優先対応手順を示します。前の項目を確認する前に、後続の手順へ進んでシステム設定を変更することは推奨しません。
診断前の準備
- 問題が発生した時刻とノードのデータセンターを記録
- 元のコマンド、終了コード、マスキング済みログを保存
- 一度に変更する変数は1つにして結果を記録
確認順序
01—05
対応手順
01から確認を開始
まずコンソールで注文ステータス、対象モデル、データセンターを確認します。記録が一致したら、認証情報、ポート、ディスク、システムタスクを確認します。
記録：ノード / 時刻 / 現象 / 直近の変更
ビルドの問題
まずツールチェーンを固定し、プロジェクトの状態を確認
ビルド失敗は通常、単一の変数だけが原因ではありません。まずツールのバージョンと実行環境を記録し、その後に署名、キャッシュ、自動化ログ、runnerの条件を確認します。これにより、クリーンアップで本来のエラー証跡が失われるのを防げます。
Xcodeのバージョンを確認
バージョンを照会してアクティブなDeveloperディレクトリを記録します。プロジェクトの指定バージョンと現在の環境が異なる場合は、互換範囲を確認してから切り替えてください。
xcodebuild -version
xcode-select -p
swift --version検収：バージョン、パス、プロジェクト要件が一致
署名環境を確認
ビルドタスクが必要な証明書、プロビジョニングプロファイル、環境変数を読み取れることを確認します。依頼やログには名称、時刻、エラー概要だけを残し、有効なキーは提出しないでください。
security find-identity -v -p codesigning
env | sort検収：対象の署名項目が表示され、権限が正しい
DerivedDataを範囲を限定してクリーンアップ
まず最初の失敗出力を保存し、対象プロジェクトに関係するディレクトリだけを削除します。最初から全ディスクをクリーンアップすると、次回のビルド時間が増え、比較情報も失われます。
du -sh ~/Library/Developer/Xcode/DerivedData
df -h検収：容量解放後もエラーが安定して再現する、または解消する
Fastlaneの失敗箇所を特定
ログをlane、action、下位コマンドの3層に分けます。最後の要約行だけでなく、最初の実際のエラー、終了コード、実行ディレクトリを記録してください。
bundle exec fastlane lane_name --verbose
echo $?検収：失敗したactionと最初のエラーを特定できる
runnerのラベルと権限を確認
self-hosted runnerがオンラインで、タスクのラベルとrunnerのラベルが完全に一致することを確認します。実行ユーザーがワーク、キャッシュ、ビルドの各ディレクトリに適切な権限を持つことも検証してください。
whoami
pwd
ls -ld .
df -h検収：最小テストタスクを取得して完了できる
利用期間とリソース
有効期限、ストレージ増加、並列接続のニーズを分けて管理
更新は利用期間を解決し、ストレージ拡張は容量を解決し、Thunderbolt 5の並列接続は特定の複数ノードワークフローを解決します。3つは独立したオプションなので、操作前に現在の状態と目標を個別に記録してください。
更新と有効期限
コンソールの注文記録で現在の有効期限を確認し、更新期間を選んで決済します。更新後に注文を再度開き、ステータスと新しい有効期限を確認してください。ローカルカレンダーの通知だけを注文情報の代わりにしないでください。
- 操作場所
- コンソールの注文・利用期間記録
- 操作前
- 現在の有効期限と必要な期間を記録
- 操作後
- 注文ステータスと更新後の有効期限を確認
ストレージ拡張
まずディレクトリ使用量と増加速度から必要性を判断します。再生成可能なキャッシュを優先して削除し、コード、署名素材、ビルド成果物、業務データは先にバックアップしてから容量追加を決めてください。
- +1TB SSD
- 増え続ける依存関係、キャッシュ、ビルド成果物
- +2TB SSD
- 複数プロジェクト、大容量アセット、より長い保存期間
- 操作場所
- コンソールの注文で利用可能な追加オプション
Thunderbolt 5並列接続
複数デバイスの連携が明確に必要なワークフローに適しています。注文前にデバイス数、接続先、データ経路、検収方法を記録してください。並列接続オプションはデバイスごとに個別料金です。
- 確認対象
- 並列接続に参加する各物理ノード
- 検収条件
- 対象デバイスを認識でき、リンクが安定し、タスクを実行できる
- 操作場所
- 注文設定時に対応する追加オプションを選択
| 追加オプション | 日額 | 週額 | 月額 | 四半期 |
|---|---|---|---|---|
| +1TB SSD | $2.9 | $7.9 | $14.6 | $39.7 |
| +2TB SSD | $5.8 | $15.8 | $29.2 | $79.4 |
| Thunderbolt 5並列接続（1台あたり） | $1.1 | $2.9 | $5.3 | $14.4 |
用語集
よく使う8つの用語を操作範囲で解説
用語の定義は、チームで操作範囲をそろえるために役立ちます。ここでは実際の利用に焦点を当て、製品名、接続プロトコル、自動化の役割を混同しないように説明します。
- クラウドMac
- ネットワーク経由でリモート利用するMacリソース。ArmCLIのクラウドMacはリモート接続可能なApple Silicon物理ノードで、開発、ビルド、テスト、実験に利用できます。
- 物理ノード
- 実際に提供される1台のハードウェア。ノード情報にはデータセンター、ホスト名、接続情報、注文ステータスが含まれ、問題の切り分けでは最初に対象を確認します。
- 専有
- 1つの注文につき1台の専有物理マシンが割り当てられ、テナント間でOSインスタンスを共有しません。ユーザーは自身のプロセス、権限、キー、業務データを管理する必要があります。
- 非仮想マシン
- 計算タスクが、他のテナントと同じ仮想化OSインスタンスを共有せず、レンタルした物理ノード上で直接実行されます。
- VNC
- macOSのGUIをリモートで表示・操作する接続方式。ウィンドウ、シミュレータ、GUIツールが必要なタスクに適しており、接続情報はコンソールの注文から取得します。
- SSH
- CLI接続、ファイル転送、ポートフォワーディング、自動化タスクに使用するプロトコル。初回接続ではホストフィンガープリントを確認し、キー認証を優先してください。
- self-hosted runner
- チームが自ら登録し、クラウドMac上で実行するパイプライン実行環境。タスクを取得できるかどうかは、オンライン状態、ラベル条件、権限、ワークディレクトリの設定で決まります。
- ビルドキャッシュ
- 重複するダウンロードやコンパイルを減らすために保持する中間データ。繰り返しタスクの効率を高めますが、容量計画、無効化方針、定期確認が必要です。
認証情報とセキュリティ
接続が復旧したら、認証情報を整理する
アクセスが復旧しても、切り分けが終わったわけではありません。不審なセッションを確認し、漏えいした可能性のあるキーをローテーションし、一時ファイルを削除して、終了前のデータ移行と権限撤回が完了していることを確認してください。
信頼性とセキュリティの説明を見る- 01 キーをローテーション 人員変更、デバイス紛失、認証情報の誤送信、不審なログインの兆候がある場合は、古いキーを失効させて新しいキーを発行します。
- 02 権限を最小化 ビルドタスクには、作業に必要なディレクトリ、コマンド、環境変数への権限だけを付与し、長期間有効な高権限認証情報で設定を代替しないでください。
- 03 不審なセッションを終了 現在のユーザー、アクティブな端末、バックグラウンドプロセスを確認し、説明できないセッションを終了して、時刻と関連タスクを記録します。
- 04 ログをマスキング コマンド、時刻、終了コード、エラーの前後関係を残し、アクセストークン、秘密鍵、証明書の内容、業務データ、内部アドレスを削除します。
- 05 終了時のクリーンアップを完了 コードと業務データを移行し、リモートキーを失効させ、一時キャッシュと機密ファイルを削除して、コンソールで利用期間の状態を確認します。
サポートへのエスカレーション
再現可能で確認しやすい問題を3ステップで提出
情報がそろっているほど、重複した確認を省けます。まずタスクドキュメントの最小確認を完了し、ノード、時刻、コマンド、マスキング済みログを提出してください。
-
01
該当するタスクドキュメントを実行
問題が接続、ツールチェーン、CI/CD、ストレージ、利用期間のどれに該当するかを確認します。完了した手順と各結果を記録し、同じテストで複数の変数を同時に変更しないでください。
-
02
最小限の問題パッケージを準備
ノードとデータセンター、発生時刻、実行コマンド、終了コード、最初のエラー、直近の変更、試した手順を含めます。ログは必ず先にマスキングしてください。
-
03
コンソールからサポート依頼を送信
注文をお持ちの場合は、コンソールのサポート依頼を優先して使用し、問題をノードとサービス記録に関連付けます。購入前の問題やコンソールに入れない場合は、サービスチームに連絡できます。
緊急の問題を伝える方法
件名に「接続できない」「ビルドが停止」「注文ステータス異常」などを明記し、本文にノード、開始時刻、影響を受けるタスク、マスキング済みの証跡を記載します。公開された場所に有効な認証情報を送らないでください。
開始する
タスク規模を決めたら、専有物理Macをそのまま設定
3種類の販売モデルを、シンガポール、日本（東京）、韓国（ソウル）、香港、米国東部の5つのデータセンターで提供しています。具体的な在庫状況はコンソールのリアルタイム表示を確認してください。