macOSとXcodeのバージョンを確認
macOSのバージョン、Xcodeの完全なバージョン、現在のコマンドラインツールのパス、プロジェクト要件を記録します。GUIとコマンドラインで取得されるツールチェーンは一致させてください。
- プロジェクトが必要とする最低バージョンと対象システムバージョンを確認
- 選択中のXcodeとコマンドラインツールが一致していることを確認
- まず最小プロジェクトでビルドとテストを実行
接続・ビルドサポート
問題箇所を特定してから、再現可能なノード情報を送信
クラウドMacの初回接続、リモートデスクトップ、SSH、macOS、Xcode、CI Runner、ストレージ拡張、注文手続きを網羅しています。登録ボードの順に確認し、ネットワーク、認証情報、ビルド環境を同時に変更しないことをおすすめします。
SUPPORT ROUTE
問題の振り分け登録
順番に確認
01
接続情報
ホスト情報、ユーザー名、アクセス方法を確認
入力
02
ノードの状態
コンソールに表示されるノード記録を確認
確認
03
ローカルからノードへのネットワーク
名前解決、ポート、経路の安定性を個別に確認
測定
04
ツールチェーンとタスク
バージョンを固定し、最小タスクで再現
再現
チケットに必要な最小情報
注文ID + リージョン + 時刻 + 匿名化済みログ
4 FIELDS
入口を選択
現在の問題箇所に応じた確認手順へ進む
問題が複数の工程にまたがる場合は、初回接続から順に切り分けます。毎回1つの変数だけを変更し、変更前後の状況と時刻を記録してください。
初回接続
ホスト情報と認証情報の確認
ノードのリージョン、ホストアドレス、ユーザー名、認証情報のバージョン、現在許可されているアクセス方法を確認します。
リモートデスクトップ画面・入力・セッションの確認
セッションを確立できない、画面更新が遅い、入力に問題がある、クライアント設定に問題がある、といった状況を切り分けます。
SSHポート、鍵、コマンドライン
接続先、認証権限、ローカルの鍵の選択、詳細な接続出力を確認します。
Xcode環境バージョンとプロジェクトの分離
まずmacOS、Xcode、コマンドラインツール、依存関係のバージョンを固定し、その後でプロジェクト固有の差異を確認します。
CI Runnerキュー、キャッシュ、ディスク
Runnerのオンライン状態、タスクラベル、並列実行設定、キャッシュディレクトリ、空き容量を確認します。
ストレージとネットワーク容量、拡張、転送経路
プロジェクト、キャッシュ、素材、成果物の規模から必要容量を見積もり、ネットワーク依存も個別に検証します。
接続診断
接続問題を5ステップで絞り込む
最初からクライアントを再インストールしたり環境をリセットしたりしないでください。まず登録情報を確認し、認証情報、ノード、ローカルネットワーク、クライアント、個別セッションのどこで問題が起きているかを段階的に判断します。
-
01
まず入力を確認
現在のノードに対応する認証情報を確認
コンソールから注文ID、ノードのリージョン、ホスト情報、ユーザー名、認証情報の生成状態を再取得します。以前のチケット、古いスクリーンショット、チームメンバーから転送された過去の接続情報は使用し続けないでください。
-
02
次にノードを確認
ノードのオンライン状態を確認
コンソールのノード記録がアクセス可能な状態になっているか確認します。提供登録中は現在の記録を保持し、接続設定を重複作成したり、認証情報を連続して変更したりしないでください。
-
03
経路を測定
ネットワーク接続の問題を切り分ける
現在のネットワークと、別の信頼できるネットワークから、ホストの名前解決と対象ポートをそれぞれテストします。テスト時刻、ネットワーク種別、結果を記録し、単一の遅延値だけで判断しないでください。
-
04
クライアントを固定
クライアント設定を確認
接続プロトコル、ホスト欄、ポート、ユーザー名、認証情報の選択に誤りがないか確認します。リモートデスクトップでは、セッション確立、画面更新、キーボードマッピング、ローカル表示設定も切り分けます。
-
05
証拠を整理
最小再現ログを収集
エラー原文、発生時刻、再現手順、クライアントバージョンを保存します。SSHでは匿名化した詳細接続出力を、リモートデスクトップでは接続開始からエラー発生までの一連の流れを記録できます。
システムとツールチェーン
まずバージョンを固定し、プロジェクト固有の差異を特定
システム更新、Xcodeの切り替え、依存関係の更新は複数の変数を同時に変化させます。作業を始める前に現在の環境を記録し、最小プロジェクトで基本ツールチェーンを検証してください。
インストール前に互換性の範囲を確認
システム、Xcode、パッケージマネージャー、コンパイル依存関係を更新する前に、プロジェクトの互換性、ディスク空き容量、復旧用の資材を確認します。重要なタスクの実行中にバージョンを切り替えないでください。
- 現在のバージョンと依存関係のロックファイルを保存
- 新バージョンに必要な容量とダウンロード元を確認
- 検証タスク用の独立した作業ディレクトリを作成
キャッシュディレクトリを計画
ソースコード、依存関係キャッシュ、ビルド中間ファイル、テスト結果、最終成果物を分離します。ディスク使用量の増加がプロジェクト内容、キャッシュヒット率の変化、ビルド成果物のどれに起因するか判断できます。
- キャッシュのパスと削除条件を明確に設定
- 最終成果物を一時ディレクトリだけに保存しない
- 削除前にディレクトリ容量とタスクへの影響を記録
プロジェクト環境を分離
異なるリポジトリ、ブランチ、実験タスクには、独立したディレクトリ、依存関係の固定、環境変数セットを使用します。問題が発生したら、同じコミットと同じ依存関係のバージョンで再現してください。
- リポジトリまたはタスクごとに作業ディレクトリを分ける
- 環境変数の出所を記録し、機密値はコミットしない
- 繰り返し実行できる初期化スクリプトを使用
CI/CDのトラブルシューティング
Runnerがオフラインのときは、まず管理プレーン、次にビルドスクリプトを確認
ジョブ受け付け、署名環境、キャッシュ、並列実行、ディスクを分けて確認します。1つのタスクでRunner設定、依存関係、キャッシュ方針を同時に変更すると、結果を再現しにくくなります。
RUNNER
出力：オンライン記録とキューのスクリーンショット
Runnerがジョブを受け付けない
プロセスの状態、タスクラベル、プロジェクト権限、キュー割り当て、直近のハートビート記録を確認します。Runnerが実際に紐づいているリポジトリまたは組織の範囲も確認してください。
SIGNING
出力：失敗したステップとエラー原文
署名ステップに失敗する
署名素材が揃っているか、権限が正しいか、スクリプトの読み取りパスが一致しているか確認します。チケットには匿名化したエラーと素材の種類だけを記載し、機密認証情報は送信しないでください。
CACHE
出力：キャッシュキーとヒット状況の変化
キャッシュが無効、またはビルドが遅い
キャッシュキー、依存関係のロックファイル、ヒット記録、作業ディレクトリを比較します。まずキャッシュを無効にした最小タスクを1回実行し、問題が本当にキャッシュ層に起因するか確認してください。
QUEUE
出力：キューの順序と並列数
並列タスクが互いにブロックする
同時実行中のタスク数、共有ディレクトリ、ポート、シミュレータリソース、成果物のパスを確認します。並列タスクには独立したワークスペースを割り当て、相互上書きを防いでください。
DISK
出力：ディレクトリ使用量の比較
ディスク使用量が増え続ける
ソースコード、依存関係、キャッシュ、中間ファイル、ログ、成果物の各ディレクトリを個別に集計します。削除前に対象ディレクトリがタスクで使用中でないことを確認し、必要な成果物を保存してください。
ストレージと拡張
実際のワークセットに基づく容量評価とThunderbolt 5の並列接続
ソースコード、依存関係キャッシュ、ビルド中間ファイル、テストデータ、素材、モデル、最終成果物を合算して評価します。拡張オプションは明確な容量または並列接続の需要に対応するもので、プロジェクトのバックアップに代わるものではありません。
STORAGE CHECK
変更前に確認する4項目
- 現在のモデル、ノードのリージョン、注文IDが正確か
- 現在の空き容量、予想される追加データ量、キャッシュの増加速度
- 拡張用途が長期データ、一時ワークセット、バッチ処理用素材のどれか
- Thunderbolt 5の並列接続デバイス数、接続方法、タスクの依存関係
既存の注文を変更する場合は、コンソールから注文記録を紐づけてチケットを送信します。タスクの実行中にストレージパスを変更したり、使用中のデバイスを取り外したりしないでください。
TB5
並列接続デバイス1台ごとの料金
並列接続に適したタスク
大規模な素材の一括処理、外付け高速ストレージに明確に依存するワークフロー、独立した作業ディスクが必要な長期タスクに適しています。ソフトウェア、ファイルシステム、タスクのパスが並列接続デバイスを正しく利用できることを先に確認してください。
BACKUP
変更前にデータの保存先を確認
ノード上のローカルコピーだけを唯一のコピーにしない
プロジェクトリポジトリ、署名素材、モデル、素材、ビルド成果物は、チームの方針に従って独立したコピーを保持してください。容量拡張は作業スペースの問題を解決するもので、バージョン管理やバックアップの代わりにはなりません。
| 追加項目 | 日額 | 週額 | 月額 | 四半期 |
|---|---|---|---|---|
| +1TB SSD | $2.6 | $7 | $12.9 | $35.1 |
| +2TB SSD | $5.2 | $14 | $25.8 | $70.2 |
| Thunderbolt 5並列接続、1台あたり | $1.9 | $5.2 | $9.7 | $26.4 |
サポート依頼テンプレート
1回の送信で特定に必要な情報を揃える
明確な依頼には、どの注文・どのリージョンで、いつ発生し、どう再現でき、何を期待しているかを記載します。「接続できない」「ビルドに失敗した」だけでは、通常は調査を開始できません。
REQUEST RECORD
コピーして記入
ノード問題の登録票
- 注文ID
- 問題のノードに対応する、コンソール上の注文IDを記入してください。
- ノードのリージョン
- シンガポール、日本（東京）、韓国（ソウル）、香港。
- 発生時刻
- 現地時刻とタイムゾーン、および問題が継続しているかを明記してください。
- 再現手順
- 正常な状態から開始し、実際の操作順に沿って手順を列挙してください。
- 匿名化済みログ
- エラー原文を残し、パスワード、鍵、トークン、プロジェクトの機密情報を削除してください。
- 期待する結果
- 本来表示されるはずだった状態、出力、タスク結果を説明してください。
GOOD SIGNAL
同じ再現事象に対応する情報を記載
あわせて提供するとよい情報
クライアントバージョン、macOSとXcodeのバージョン、Runnerラベル、失敗したタスクID、ネットワーク種別、問題発生前に最後に成功した操作。
REMOVE FIRST
特定に必要な最小限の証拠だけを送信
送信前に必ず削除
パスワード、秘密鍵、アクセストークン、署名素材の原文、決済情報、完全な環境変数ファイル、未処理のプロジェクトソースコード。
アカウントと注文
決済、請求、ノード記録はコンソールで処理
注文金額は、選択したモデル、利用期間、ノードのリージョン、追加項目で構成されます。既存の注文に関する問題は、アカウントとノード記録を自動的に紐づけられるよう、コンソールから送信してください。
利用できる決済方法と決済通貨は？
USDT-TRC20とVisa / Mastercard / Amex（Stripe経由）のみ利用できます。すべての注文は米ドル（USD）で決済されます。実際に利用できる決済ゲートウェイはコンソールの表示に従ってください。
注文金額は何で構成されますか？
金額は、基本モデル、日額／週額／月額／四半期から選ぶ利用期間、ノードのリージョン、選択したストレージまたはThunderbolt 5並列接続の追加項目で構成されます。送信前に請求明細を項目ごとに確認してください。
接続または設定の問題をコンソールから送信する理由は？
コンソールのチケットには注文ID、ノードのリージョン、提供記録を紐づけられるため、確認の往復を減らせます。送信時には発生時刻、再現手順、匿名化済みログ、期待する結果も記載してください。
チームメンバーの変更後、アクセス認証情報はどう扱えばよいですか？
チームの権限範囲を速やかに確認し、関連する認証情報を更新して、不要になったアクセスを取り消してください。メール、チャット、チケットで未加工の認証情報を送信しないでください。
アップグレードサポート窓口
ノード記録と再現証拠を1つのチケットにまとめる
注文、接続、請求、ビルドに関する問題は、まずコンソールから送信してください。構成の相談、複数ノード、業務上の連携については、サービスチームにお問い合わせください。