注文とホスト状態
注文ID、利用期間、ホスト状態、提供情報を確認します。新規購入、更新、ホスト管理はコンソールで行い、利用可能状態はコンソールのリアルタイム表示を基準にしてください。
状態確認から始める
まず問題を特定し、そのまま対応できる資料を提出しましょう。
MiniDebug クラウドMacの利用開始、接続、システムログイン、Xcodeビルド、ストレージ追加、更新、解放に対応します。ページ内の確認を終えたら、注文情報とマスキング済みログをコンソールの問い合わせから送信してください。
サポート範囲
問題の層を先に特定する
リモート接続、ビルド、注文状態の異常は似た結果になることがありますが、確認箇所は異なります。以下6種類の問題はすべてコンソールから報告できます。
ノードとリモート接続
シンガポール、日本（東京）、韓国（ソウル）、香港、米国東部の5ノードについて、アドレス、ポート、ネットワーク経路、リモートセッションを確認します。
システムログインと権限
初回ログイン、認証情報の更新、SSH鍵、グラフィカルセッション権限、アカウントのアクセス範囲を確認します。チーム利用では追跡可能な個別認証情報を使用してください。
ビルド環境
Xcodeバージョン、コマンドラインツール、依存関係キャッシュ、署名情報、ディスク容量、ビルドログから xcodebuild または fastlane のタスクを切り分けます。
ストレージ追加
注文したストレージ容量、マウント状態、空き容量、タスクディレクトリを確認します。容量不足の場合は再生成可能なキャッシュを先に削除し、構成変更の必要性を判断します。
更新と解放
更新前に期間と追加オプションを確認します。解放前にはコード、証明書、モデル、素材、ビルド成果物をバックアップし、自動化タスクが書き込みを停止していることを確認してください。
初回利用の手順
5ステップで初回接続を確認する
保存済みの古いアドレスから接続を試さないでください。各注文では、コンソールに表示されたホスト状態と接続情報を基準にします。
-
01
入力：注文ID
注文とホスト状態を確認
コンソールにログインして対象の注文を開き、モデルが MiniDebug M4、構成が M4、16GB RAM、256GB SSD であることを確認し、選択したノードを記録します。ホストが接続可能な段階に達するまで、リモートログインを繰り返さないでください。
-
02
出力：接続パラメータ
今回の注文の接続情報を取得
接続先アドレス、ポート、アカウント、対応する接続方式をコピーします。アドレスとポートはセットで保存し、SSHのパラメータとVNCまたは画面共有のパラメータを混在させないでください。
-
03
確認：ホストの本人性
初回システムログインを完了
信頼できるローカルデバイスから接続してください。初回のSSH接続ではホストフィンガープリントを確認し、グラフィカル接続では対象ノードと注文が一致することを確認します。共有デバイスに認証情報を保存しないでください。
-
04
操作：認証情報を更新
認証情報とアクセス範囲を更新
ログイン後すぐに初期認証情報を更新し、SSH自動化では鍵を優先して使用します。チーム利用では許可メンバーを限定し、同一アカウントの長期共有やスクリプトへの平文パスワード記載を避けてください。
-
05
結果：基盤環境を利用可能
ネットワークとビルド基盤を確認
コードリポジトリへのアクセス、DNS解決、ディスク容量、Xcodeのパス、コマンドラインツールを確認します。まず軽量な確認コマンドを実行し、その後に依存関係の完全取得や時間のかかるビルドを開始してください。
ビルド障害の切り分け
安定して再現する最初のエラーから始める
ログ末尾はタスク終了の結果にすぎないことが多くあります。上に戻って最初に安定して現れるエラーを探し、以下6種類に分類してから、プロジェクトを変更するか基盤インフラの問い合わせを行うか判断します。
ID、対象、書き出し段階を切り分ける
- ビルド対象、Bundle Identifier、署名設定が一致していることを確認します。
- archive成功後にexport段階で失敗していないか確認します。
- 最初の署名エラーと、その前後20行のログを記録します。
対応方針：プロジェクトの署名設定はユーザーが確認します。署名情報を読み取れない場合は、ファイル権限と自動化による注入パスを確認してください。
有効性、対応関係、読み取り権限を確認
- 必要なファイルが、現在のタスクで実際に使用される場所にあることを確認します。
- 証明書、プロビジョニングプロファイル、対象環境の対応を確認します。
- パスワード、証明書の原本、完全な鍵を問い合わせに記載しないでください。
対応方針：まず対話セッションで読み取りを確認し、その後に自動化タスクを再現して、両者の環境変数と実行アカウントを比較します。
グラフィカル環境とコマンドラインで同じツールチェーンを使う
- Xcodeバージョン、SDKバージョン、対象プラットフォームを記録します。
- 実行
xcode-select -p現在のパスを確認します。 - CIプロセスが想定した開発者ディレクトリを継承しているか確認します。
対応方針：まずバージョンとパスを固定し、新しいバージョンと互換性のない派生データを削除します。複数の変数を同時に変更しないでください。
ロックファイルを確認してからキャッシュ削除を判断
- 依存関係のロックファイルを保持し、パッケージ管理ツールのバージョンを記録します。
- クリーンなディレクトリでのビルドと、キャッシュを利用したビルドの差を比較します。
- 再生成可能なディレクトリだけを削除し、バックアップしていないプロジェクトファイルは削除しないでください。
対応方針：キャッシュ問題は空のキャッシュで再現比較して確認します。ネットワークからのダウンロード失敗は、対象、時刻、エラーコードを別途記録してください。
総容量、空き容量、大容量ディレクトリを同時に確認
- 作業ディレクトリ、派生データ、アーカイブ、依存関係キャッシュの使用量を確認します。
- ログと一時ファイルが増え続けていないか確認します。
- 削除前に成果物がアーカイブ済みで、別の場所から復元できることを確認します。
対応方針：再生成可能なキャッシュを優先して削除します。長期的な容量の必要性は、次回以降の注文でストレージ追加を確認してください。
コマンド、時刻、最初のエラーを保持
- トリガー方法、実行ディレクトリ、マスキング済みの完全なコマンドを添付します。
- 発生時刻を記録し、タイムゾーンを明記します。
- 期待結果、実際の結果、再現頻度も記載します。
対応方針：スクリーンショットだけでなく、テキストログを優先して提出します。リポジトリトークン、アップロード鍵、パスワード、ソースコードの断片を削除してください。
接続トラブルシューティングツリー
順番に確認し、上流の条件を飛ばさない
以下の7項目は依存関係のチェーンを形成します。上流が通過していない場合、下流のクライアント設定を変えても結果は変わりません。
-
01
通過後に続行
ホスト状態
コンソールで注文とホスト状態を確認します。状態が想定と異なる場合は、注文IDと画面表示を記録して問い合わせを送信してください。
-
02
対象の一致を確認
接続先アドレス
現在の注文の接続先アドレスを一字ずつコピーし、余分な空白、古いアドレス、ローカルの hosts による上書きを除外して、別の注文に接続していないことを確認します。
-
03
エラー種別を記録
ポートと接続方式
SSH、VNC、画面共有に対応するポートとクライアントを使用していることを確認します。接続タイムアウト、接続拒否、認証失敗はそれぞれ記録してください。
-
04
ネットワーク比較を完了
ローカルネットワーク
同じパラメータを使い、別の信頼できるネットワークからテストします。会社の出口、プロキシ、通信事業者の経路が接続に影響していないか判断し、テスト中に認証情報を公開しないでください。
-
05
送信ルールを確認
ファイアウォールルール
ローカルデバイスと組織ネットワークが対象ポートへの送信を許可しているか確認します。トラブルシューティングのために保護機能をすべて無効にせず、最小限の範囲で検証してください。
-
06
認証結果を明確化
アカウント権限
ネットワーク接続の成功とアカウント認証の成功を区別します。アカウント名、鍵の権限、グラフィカルログイン権限、認証情報の更新状況を確認してください。
-
07
再試行結果を保持
セッションの占有
終了していないグラフィカルセッション、重複した自動化タスク、リソース占有がないか確認します。古いセッションを安全に終了してから、制御された再試行を1回行ってください。
問い合わせ資料テンプレート
一度の送信で再現可能なコンテキストを十分に伝える
コンソール問い合わせは既存の注文に関する問題に適しています。コンソールにログインできない場合は、唯一のサポートメール support@minidebug.com を使用し、必要なアカウント確認情報を記載してください。
推奨する問い合わせ構成
項目名をコピーして順に記入
- 注文ID
- コンソール上の注文IDを記載し、支払い情報は送信しないでください。
- ノード
- シンガポール、日本（東京）、韓国（ソウル）、香港、米国東部のいずれか。
- 発生時刻
- 日付、時刻、タイムゾーンを明記し、初回発生か継続的な再現かを記載します。
- 再現手順
- コンソールを開く、コマンドを実行する、クライアントを起動するなど、実際の順序で番号を付けます。
- マスキング済みログ
- 最初のエラーとコンテキストを含め、パスワード、トークン、秘密鍵、プロジェクトの機密情報を削除します。
- 期待結果と実際の結果
- 期待される結果、実際の結果、安定して再現できるかを分けて説明します。
既存の注文
コンソール問い合わせを作成
コンソール問い合わせを利用
問い合わせには注文情報が保持されるため、ホスト状態、ノード接続、追加オプション、更新、解放の問題に適しています。送信前に該当する確認手順を完了してください。
ログインできない場合
support@minidebug.com
サポートメールを送信
メール件名に問題の種類と注文IDを記載し、本文は左側の項目構成を使用します。メールアドレスが長い場合は直接コピーしてください。
対応範囲
問題の所在が対応方針を決める
問い合わせ資料をもとに、問題が物理ノード、macOSの利用、プロジェクトコード、外部依存のどこにあるかを判断し、次の検証方針を案内します。
ノード基盤の問題
コンソールに表示されるホスト状態の異常、接続情報と注文の不一致、ノードのネットワーク到達性の異常、注文構成が選択内容どおりに表示されない問題が含まれます。
- 注文ID、ノード、発生時刻を提供します。
- 異なるローカルネットワークでの接続比較結果を添付します。
- コンソール状態とクライアントのエラー種別を記録します。
macOSの利用に関する問題
システム設定、ファイル権限、Shell環境、ディスク整理、リモートクライアントのパラメータ、ローカルアカウント権限など、操作レベルの問題が含まれます。
- 制御されたセッションで操作を再現します。
- システムバージョン、実行アカウント、対象パスを記録します。
- 画面のスクリーンショットだけでなく、エラーテキストを提出します。
プロジェクトコードとビルド設定
コンパイルエラー、テスト失敗、署名設定、依存関係のバージョン競合、スクリプトパス、環境変数、アプリの実行ロジックが含まれます。
- 最小限の変更で最初のエラーを再現します。
- ローカルとクラウドMacのツールチェーンの差を比較します。
- プロジェクトのメンテナーがコードまたはパイプライン設定を変更します。
サードパーティサービスの問題
コードホスティング、依存関係ミラー、パッケージリポジトリ、通知システム、アップロード先が返す認証、レート制限、サーバーエラーが含まれます。
- 対象サービスの状態とアカウント権限を確認します。
- レスポンスコード、リクエスト時刻、再試行結果を記録します。
- マスキング済みログを該当サービスの提供元に提出します。
セルフサービス資料
該当ガイドを先に読み、重複した問い合わせを避ける
接続パラメータ、料金、データ保護、よくあるビルド問題については個別の説明があります。ガイドの確認項目で解決しない場合は、結果を問い合わせに記載してください。
リモートアクセス
SSH、VNC、macOS画面共有を比較し、遅延、帯域幅、セッション状態から接続を切り分けます。
よくある質問
デバイス形態、利用期間、ノード、追加オプション、支払い方法、ビルドツール、データ処理の範囲を確認します。
セキュリティと信頼性
専有物理マシンの分離、認証情報管理、リモートアクセス保護、データライフサイクル、責任範囲について確認します。
プランと料金
MiniDebug M4の固定構成、4種類の利用期間、ストレージ追加、Thunderbolt 5の並列接続、ノード一覧を確認します。
連絡先と振り分け
購入前の構成相談、既存注文、接続障害、ビルド環境、セキュリティ、提携相談を区別します。
注文情報を準備して次へ進む
新規購入、更新、ホスト管理はコンソールで行います。既存注文の問題はコンソール問い合わせを優先してください。支払いは USDT-TRC20 と Visa / Mastercard / Amex（Stripe）のみ対応し、すべての注文は米ドル（USD）で決済されます。利用可能なゲートウェイはバックエンドAPIの応答を基準とします。