注文情報からビルドログまで、目的別に問題を解決
最初からガイド全体を読む必要はありません。現在の作業に合う章を開き、利用期間、ノード、接続情報、開発環境、ログの証拠を順に確認してください。それでも原因を特定できない場合は、完全な状況を添えてコンソールから問い合わせてください。
どの段階で困っているか教えてください
作業内容、ステータス項目、エラーの症状を入力すると、このページの該当チェックリストに直接案内します。5つの入口から始めることもでき、章の順番に読む必要はありません。
注文内容を確認してから、インスタンスの異常を判断する
注文によってチップ、メモリ、ストレージ、ノード、利用期間が決まります。コンソールのステータス項目は、現在の提供または稼働段階を示します。両者を混同しないでください。カタログに含まれる組み合わせの実際の利用可否は、コンソールのリアルタイム表示を基準とします。
5つの項目群を1つずつ一致確認
- 利用期間
- 日、週、月、四半期単位で課金されます。現在の期間とプロジェクトの継続期間を確認し、異なる期間の料金を同じ予算に混在させないでください。
- 物理ノード
- シンガポール、日本(東京)、韓国(ソウル)、香港、米国東部の5ノードです。チームのアクセス経路、コードソースの場所、データフローを優先して検討してください。
- 基本構成
- ArmVMS M4はM4、16GB RAM、256GB SSD。ArmVMS Pro(M4 Pro)はM4 Pro、64GB RAM、2TB SSDです。
- 追加オプション
- +1TB SSD、+2TB SSD、Thunderbolt 5パラレル接続を個別に確認し、追加項目と基本構成が同じ注文期間に含まれていることを確認してください。
- 決済方法
- USDT-TRC20およびVisa / Mastercard / Amex(Stripe経由)のみ利用できます。すべて米ドル(USD)で決済され、利用可能な決済ゲートウェイはバックエンドの応答を基準とします。
処理中と接続可能
「処理中」は通常、注文情報が提供手続き中であることを示します。「接続可能」は接続情報が生成済みであることを示します。ステータスが変わったら、まず注文詳細を更新し、詳細ページの最新の接続項目を使用してください。
注文が正しくても環境の準備完了とは限らない
構成とノードに問題がなくても、システムアカウント、ディスク空き容量、Xcodeのバージョン、プロジェクトの依存関係を確認する必要があります。環境の問題を注文の再作成で解決しないでください。
構成と価格を確認| 項目 | 内容 | 確認すること | 不一致時に記録する内容 |
|---|---|---|---|
| ORDER ID | 注文を一意に識別する関連ID | 問い合わせ、請求、インスタンスが同じ番号を参照しているか | 完全な注文番号 |
| REGION | 物理ノードの所在リージョン | 注文時に選択したノードと一致しているか | ノードコードと表示名 |
| TERM | 現在の利用期間 | 日、週、月、四半期と開始・終了情報 | 期間名と注文画面のスクリーンショット |
| ACCESS | 接続情報が生成済みか | アドレス、アカウント、接続方法が揃っているか | 不足している項目名 |
| STATE | インスタンスの現在の稼働段階 | 更新後にステータスが変わるか、接続が復旧するか | ステータス原文と発生時刻 |
まず再現可能なビルドを実現し、その後で高速化する
クラウドMacへ移行する際は、ツールチェーン、依存関係、プロジェクトパスの一貫性を優先して復元します。最初から古い環境全体をコピーせず、チェックリストで再構築してください。アーキテクチャの不整合、古いパス、キャッシュ汚染を減らせます。
Xcodeプロジェクトの準備
プロジェクトが必要とするXcodeのメジャーバージョン、プロジェクトまたはワークスペースの入口、ビルドScheme、対象プラットフォーム、最小システムバージョンを記録します。初回起動後は依存関係の解決を完了してから、完全ビルドを実行してください。
- プロジェクトファイルとサブモジュールが揃っていることを確認
- Schemeがコマンドラインビルドに利用できることを確認
- 署名設定とコードバージョンを分けて確認
コマンドラインツール
まず現在選択されている開発者ディレクトリを確認し、コンパイラ、バージョン管理ツール、スクリプトインタープリターを確認します。自動化タスクでは実際のツールパスとバージョンを出力し、対話セッションとランナーで異なる環境が使われないようにします。
- 現在のXcodeの選択結果を記録
- shellの初期化ファイルが対話入力で停止しないことを確認
- スクリプトでは明示的なパスまたは管理可能な環境変数を使用
依存関係管理
ロックファイルとソフトウェア一覧から依存関係を復元することを優先します。インストール後、Apple Siliconアーキテクチャ、バイナリの取得元、コマンドの解決パスを確認し、古い環境のコンパイル済みファイルがそのまま使えるとは考えないでください。
- 依存関係ロックファイルとインストールログを保存
- スクリプトに古いマシンのディレクトリが固定されていないか確認
- プライベート依存関係の認証情報を管理対象の変数に入れる
ビルドキャッシュ
キャッシュには再生成できるデータだけを保存します。まずキャッシュなしでビルドして基準値を確認し、その後に依存関係キャッシュと派生データを段階的に戻してください。説明できないビルド差異が出た場合は、プロジェクトデータ全体を削除せず、現在のタスクのキャッシュを優先して削除します。
- 依存関係キャッシュ、コンパイルキャッシュ、最終成果物を区別
- キャッシュキーにツールチェーンと依存関係のバージョンを含める
- キャッシュ容量とディスク空き容量を定期的に確認
ランナーを監査可能な物理ノードとして使う
自動化タスクでは、誰がトリガーしたか、どのコードバージョンを使ったか、どの認証情報を読み取ったか、何を成果物として生成したか、終了後に何をクリーンアップしたかを説明できる必要があります。専有リソースは競合を減らしますが、パイプライン自体の権限制御に代わるものではありません。
-
01
CREDENTIALS
最小限の認証情報を注入
リポジトリ、依存関係の取得元、配布先ごとに認証情報を分け、現在のタスクに必要な権限だけを付与します。認証情報は管理対象の変数から渡し、リポジトリ、ビルドスクリプト、ログには書き込みません。
-
02
CONTEXT
実行コンテキストを固定
コミット、ブランチ、Scheme、対象プラットフォーム、Xcodeのバージョン、依存関係の概要を記録します。並列タスクには独立した作業ディレクトリを使い、共有派生データの上書きを防ぎます。
-
03
ARTIFACTS
追跡可能な成果物を出力
アーカイブ、テストレポート、シンボルファイル、ビルドログにはタスク識別子を付け、出力前に完全性を確認します。失敗したタスクも、原因特定に必要な十分なログを保存してください。
-
04
CLEANUP
タスク環境をクリーンアップ
一時的な認証情報、マウントファイル、一時ワークスペース、不要になった中間成果物を削除します。長期的に再利用するキャッシュは指定ディレクトリに置き、プロジェクトソースや機密資料と混在させないでください。
モデル、ストレージ、セッションを計画してから長時間タスクを開始
AI実験で起きやすい問題は、起動コマンドよりもモデルファイルの重複、ディスク容量の増加、セッション切断、結果の未出力です。開始前にデータの境界を決めておくと、実行途中で容量不足に気付く事態を減らせます。
モデルファイルを3層のディレクトリで整理
取得元、バージョン、ライセンス情報、チェックサムの概要を保存します。元ファイルは1つだけ保存し、実験ディレクトリへの重複コピーを避けてください。
ダウンロードキャッシュ、変換キャッシュ、一時チャンクは独立したディレクトリに置きます。容量が不足したら削除して再生成できます。
チェックポイント、メトリクス、ログ、出力ファイルをタスク番号ごとにアーカイブし、完了後に長期保存先へ移します。
長時間タスクのセッション
トレーニング、変換、バッチ推論は一時的なグラフィカルセッションから切り離して実行します。起動後、プロセスID、作業ディレクトリ、ログパス、復旧方法を記録し、接続切断後もタスクが継続することをテストしてください。
- ログを継続的にファイルへ書き込む
- チェックポイントの間隔を明確に設定
- 出力ディレクトリに増加分の空きを確保
バックアップの範囲
コード、モデルの取得元情報、再生成できないチェックポイント、最終結果は個別にバックアップする必要があります。ダウンロードキャッシュ、一時チャンク、再生成可能な中間ファイルに同等のバックアップ容量を割り当てる必要はありません。
AIワークロードの構成を相談層ごとに確認し、複数の条件を同時に変更しない
各層の確認が終わるたびに、変更する条件は1つだけにして結果を記録します。ネットワーク、認証情報、システム、ディスク、ビルドログには明確な順序があります。前提確認を飛ばすと、接続問題を開発環境の問題と誤認しやすくなります。
ローカルネットワークから接続先アドレスに到達できるか
アドレスが完全か、現在のネットワークが該当する接続を制限していないか、ネットワーク切り替え後も症状が同じかを確認します。クライアントのシステム、ネットワーク種別、エラー発生時刻を記録してください。
接続認証情報は現在の注文詳細のものか
コンソールで注文詳細を開き直し、アカウント、アドレス、認証情報の入力方法を一字ずつ確認します。古いスクリーンショット、ブラウザー履歴、他のインスタンスの接続情報は使用しないでください。
インスタンスの状態はセッションの確立を許可しているか
インスタンス詳細を更新し、ステータス項目が変化したか確認します。ステータスと実際の接続結果が一致しない場合は、注文番号、ノード、ステータス原文、最初に確認した時刻を記録してください。
ディスクに十分な作業領域があるか
プロジェクトディレクトリ、派生データ、依存関係キャッシュ、モデルファイル、一時成果物を確認します。容量不足が確認できたら、まず再生成可能なキャッシュを削除し、まだ出力していないビルド結果は削除しないでください。
ビルドログから最初の実際のエラーを特定できるか
タスクの終了ステータスからさかのぼって最初のエラーを探し、最後の1行だけを切り取らないでください。コマンド、ツールチェーンのバージョン、コミット、エラーの前後関係を保存し、トークン、秘密鍵、その他の機密情報を削除します。
自力で解決できない場合は、すぐ調査に入れる状況を送信
既存の注文に関する問題は、注文に紐付けてコンソールの問い合わせから送信してください。購入前の構成相談やコンソールにアクセスできない場合は、support@armvms.comまでメールでご連絡ください。同じ会話で資料を追加し、同一問題の問い合わせを重複して作成しないでください。
注文とノードの情報
完全な注文番号、ノード名、基本構成、追加オプションを提供してください。特定のインスタンスで問題が起きた場合は、コンソールに表示される現在のステータス項目も記載します。
最初に失敗した操作を説明
発生時刻、操作手順、期待した結果、実際の結果を記載します。複数回試した場合は、変更した条件と変更していない条件を説明してください。
エラー原文とマスキング済みログを添付
完全なエラーメッセージをコピーし、関連するビルド手順と前後関係を添付します。スクリーンショットには項目名を含め、機密認証情報とプロジェクトの秘密情報は必ず隠してください。
送信後に新しいログや再現結果を追加するには?
同じ問い合わせ、または同じメールスレッドに返信し、追加テストの実施時刻、変更した条件、結果を記載してください。サポートチームが時系列で比較でき、状況を最初から説明し直す必要がなくなります。
コンソールの問い合わせを優先すべきなのはいつですか?
注文ステータス、請求、ノード、インスタンス接続、提供項目など既存注文に関する問題は、コンソールの問い合わせを優先してください。注文番号に紐付けられるため、確認のやり取りを減らせます。
購入前の構成相談にはどんな情報が必要ですか?
プロジェクトの種類、同時実行タスク数、必要なXcode環境、想定ストレージ、利用期間、対象ノードをお知らせください。大規模プロジェクトや大規模モデルの推論では、ピークメモリとモデルファイルの容量も記載するとスムーズです。
注文を紐付けて問い合わせを送信し、問題を正しい状況で調査できるようにする
注文番号、ノード、発生時刻、再現手順、マスキング済みログを添付してください。購入前の相談では、2つの構成を確認したうえで、プロジェクトの継続期間と必要なリソースをお知らせください。