初回接続
SSH公開鍵を準備し、ユーザー名、ホストアドレス、フィンガープリントを確認してから、コマンドラインかブラウザのGUIかを選びます。
タスクを復旧する
まず問題の層を特定してから、次の手順へ進む
一般的なQ&Aの一覧ではありません。各ガイドを確認手順に沿って構成し、問題がローカルネットワーク、接続認証情報、リモートサービス、開発環境、タスクのどこにあるかを判断できるようにしています。
DplyMiniの専用物理Mac mini向けです。仮想マシンではなく、macOSのGUIとコマンドラインを利用できるため、iOS/macOS開発、CI/CDビルド、AI推論の検証に適しています。
- 5種類のタスク
- 接続、ビルド、転送、ネットワーク、請求
- 2つの窓口
- コンソールチケットとサポートメール
- 365日
- ノードは正常稼働を維持
診断ランブック
DM-SUPPORT
パスの利用可否を確認
-
01
影響範囲を確認切り分ける
1つのコマンド、1つのプロジェクト、デバイス全体、それともローカルネットワークのすべての接続かを切り分けます。
-
02
元の証拠を保存記録する
時刻、ノード、エラー行全体、直前に実行した操作を記録します。
-
03
層ごとに変数を切り分ける調査する
コンソールの状態、ローカル経路、認証情報、サービス、対象ポートを順に確認します。
まずクイック診断を完了してから、ビルドを再実行するかセッションを再起動してください。
ORDER → NODE → SERVICE → TASK
現在のタスクから始める
5つの入口、よくある5つのブロッカー
現在の目的に最も近い入口を選択してください。ネットワーク、認証情報、ビルド設定を同時に変更すると、何が解決につながったのか判断しにくくなります。
ビルド環境
Xcodeの選択パス、コマンドラインツール、署名情報、fastlaneの依存関係、CI Runnerの実行アカウントを確認します。
ファイル転送
対象ディレクトリの空き容量、ファイル権限、チェックサム、再開転送の方法を確認し、転送中断をデバイス障害と誤判断しないようにします。
ネットワーク診断
DNS、出口経路、ファイアウォール、対象ポート、リモートサービスを順に検証します。ネットワーク設定を一度にすべてリセットする必要はありません。
アカウントと請求
注文期間、ドル建ての請求記録、支払い状況、注文との関連情報を確認します。稼働中の問題は該当する注文からチケットを送信してください。
5ステップのクイック診断
コンソールの状態から対象ポートまで確認
SSHのタイムアウト、GUIセッションに入れない、ビルドエージェントのオフライン、サーバーポートに到達できない場合に適した手順です。各ステップで1つの質問だけに答え、結果を記録します。
-
01 コンソール
ノードと注文の状態を確認
コンソールにログインして該当する注文を開きます。デバイス名、ノード、利用期間、接続先アドレスが現在のコマンドと一致するか確認してください。利用可否はコンソールのリアルタイム結果を基準にします。
結論注文と対象デバイスが一致し、接続情報の取り違えもありません。
-
02 ローカル経路
現在のネットワーク制限を切り分ける
ローカル環境から他のドメインを名前解決でき、一般的なHTTPSサービスにアクセスできるか確認します。社内ネットワーク、ゲストWi-Fi、プロキシ環境にいる場合は、既知の利用可能な経路に切り替えて比較してください。
結論障害が1つの出口ネットワークだけで発生しているかを確認します。
-
03 認証情報
ユーザー名と鍵の選択を確認
SSH設定が想定した秘密鍵を参照しているか、鍵ファイルの権限が適切か確認します。認証に失敗した場合は詳細出力を使い、クライアントが実際に試した鍵を確認してください。
結論接続がホストまで到達しているのか、それとも認証前にタイムアウトしているのかを確認します。
-
04 リモートサービス
コマンドラインとGUIセッションを切り分ける
SSHは利用できるのにGUIが切断される場合、基本的なネットワークとデバイスには通常到達できます。ブラウザセッション、解像度、クリップボード、デスクトップサービスを確認してください。
結論デバイス全体に影響しているのか、単一のリモートサービスだけなのかを確認します。
-
05 対象ポート
タスクが実際に使用するポートを検証
アプリケーションが想定したアドレスとポートで待ち受けているか、ローカルまたはプロジェクトのファイアウォールルールがアクセスを許可しているか確認します。アプリケーションが起動していないことを、すぐにノードネットワークの問題と判断しないでください。
結論ポートに到達できないのか、サービスが待ち受けていないのか、アプリケーションが起動直後に終了したのかを確認します。
最小限の診断コマンド
クライアントが実際に実行した経路を残す
コマンド内のホスト名を、コンソールに表示される接続先アドレスに置き換えます。ログを共有する前に、ユーザー名、アドレス、鍵のパス、プロジェクトの機密情報を削除してください。
$ ssh -vvv user@host
$ nc -vz host 22
$ scutil --dns
$ lsof -nP -iTCP -sTCP:LISTEN接続トラブルガイド
まずセッションの種類を判断し、その後で接続中断に対処する
SSH、ブラウザのリモートアクセス、GUIデスクトップセッションは同じ専用物理Macを共有しますが、エラーの原因はそれぞれ異なります。まず低い層の接続を検証し、次に上位の操作環境を確認してください。
SSH
コマンドライン接続の失敗
- タイムアウト：ローカルの出口、ファイアウォール、接続先アドレスを確認します。
- 接続拒否：ポートとリモートサービスの状態を確認します。
- 認証失敗：ユーザー名、秘密鍵、クライアントの鍵選択ログを確認します。
- フィンガープリントの変更：接続を停止し、コンソールチケットで確認してください。無視して接続を続けないでください。
判定基準：詳細出力で、DNS、TCP接続、ホスト検証、認証のどの段階で停止したか確認できます。
BROWSER
ブラウザセッションに入れない
- デバイス詳細からセッションを作り直し、期限切れのページを再利用しないでください。
- 影響を与えるスクリプトや接続確立に関係するブラウザ拡張機能を無効にしてから再試行します。
- ブラウザが現在のページでクリップボードと全画面機能を使用できることを確認します。
- SSHでデバイスに引き続き到達できるか検証し、デバイス側かブラウザ側かを切り分けます。
DESKTOP
GUIデスクトップが遅い、または切断される
- まず解像度を下げ、不要な動きのある画面を閉じます。
- 大容量ファイルの同期やバックグラウンドビルドが経路を占有していないか確認します。
- 継続的なビルドをバックグラウンドタスクに切り替え、デスクトップセッションの維持に依存しないようにします。
- SSHも同時に切断される場合は、クイック診断のネットワークとノードの手順に戻ります。
判定基準：ピーク帯域幅よりも操作経路の安定性を優先し、バックグラウンドタスクはブラウザウィンドウを開き続けることに依存させないでください。
開発環境の確認
ビルドに失敗したら、まずツールチェーンと実行アカウントを固定する
同じプロジェクトが対話型ターミナルでは動作し、CI Runnerでは失敗する場合、PATH、権限、環境変数、実行アカウントが異なることが一般的です。まず環境差を再現してから、プロジェクト設定を変更してください。
XCODE
コマンドラインツール
実際に使用する開発ディレクトリを確認
実行： xcode-select -p と xcodebuild -versionを実行し、対話型ターミナルとRunnerが同じツールセットを使用していることを確認します。プロジェクトでバージョンを指定する場合は、選択ロジックをタスクの初期化手順に組み込んでください。
SIGN
証明書と署名
不足、期限切れ、アクセス権を切り分ける
まず証明書の有効性、プロビジョニングプロファイルとの対応、キーチェーンへのアクセス権を確認します。最後の署名エラーだけを見るのではなく、ビルドログで最初に現れた署名診断を探してください。
LANE
fastlane
Rubyと依存関係のバージョンを固定
プロジェクトの依存関係ロックファイルを使ってタスクを実行し、Bundler、プラグイン、環境変数が同じ作業ディレクトリに由来することを確認します。対話型ターミナルでは成功し自動タスクで失敗する場合は、両方のPATHと作業ディレクトリを比較してください。
RUNNER
CI Runner
サービスアカウントがプロジェクトリソースを読み取れるか確認
Runnerの実行アカウント、作業ディレクトリ、キャッシュディレクトリ、一時ディレクトリの権限を確認します。機密変数はタスク環境から注入し、リポジトリ、通常のログ、チケット本文には書き込まないでください。
ストレージとデータ
作業ディレクトリ、転送検証、利用期間終了を1つのデータチェーンとして管理する
専用物理Mac上のプロジェクトデータはユーザーが管理します。タスク開始前にディレクトリを決め、転送後に検証し、重要な時点では別途バックアップを作成し、利用期間終了前に移行してください。
作業ディレクトリを固定
ソースコード、依存関係キャッシュ、ビルド出力、一時ファイルを分けます。CIタスクでは明確な絶対パスを使用し、実行アカウントの違いによって予期しない場所にファイルが書き込まれないようにします。
- ソースコードのディレクトリを追跡可能に保つ
- キャッシュは再構築できるようにする
- 成果物を個別に保管
転送前後に検証
大容量ファイルは分割して転送し、再開転送に対応したツールを優先します。転送前後でファイル数、サイズ、チェックサムを比較し、進捗バーの完了だけを唯一の根拠にしないでください。
- 元ファイルの総量を記録
- チェックリストを保存
- 失敗したバッチを個別に再転送
独立したバックアップを維持
デバイス上の唯一のコピーはバックアップではありません。ソースコードはバージョン管理し、重要な成果物と実験結果はユーザーが管理する独立したストレージにも同期してください。
- リポジトリからソースコードを復元できる
- 成果物を再検証できる
- 機密資料は先に暗号化
終了前に移行を完了
利用期間の最終時刻までデータのエクスポートを待たないでください。転送、検証、失敗時の再試行に必要な時間を確保し、移行先で正常に読み取れることを確認してから一時認証情報を削除します。
- プロジェクトと成果物をエクスポート
- 移行先のコピーを検証
- 一時認証情報を失効
データ移行の責任範囲
プロジェクトデータ、アクセス認証情報、バックアップ、利用期間終了前の移行計画はユーザーが管理します。デバイスへのアクセスに異常がある場合は、できるだけ早く該当する注文からチケットを送信し、未移行のデータ種類とタスクへの影響を記載してください。
アカウントと請求
期間、通貨、支払い方法の3点を先に確認
注文期間は日、週、月、四半期から選択でき、料金はすべて米ドル（USD）で決済されます。支払い方法はUSDT-TRC20とVisa / Mastercard / Amex（Stripe経由）のみです。利用可能な決済ゲートウェイはコンソールの表示を確認してください。
- 利用期間
- 日 / 週 / 月 / 四半期
- 決済通貨
- 米ドル（USD）
- 暗号資産
- USDT-TRC20
- カード
- Visa / Mastercard / Amex（Stripe経由）
注文期間はどのように選べますか？
短期の修正、1回限りのアーカイブ、短期実験なら日単位を検討できます。継続的な反復開発、安定したRunner、長期プロジェクトなら週、月、四半期のプランを比較してください。注文前にタスクの予定期間、データ移行時間、チームの引き継ぎ計画を確認します。
支払い状況と注文状況が一致しない場合は？
同じ注文を何度も作成しないでください。注文番号、支払い時刻、金額、決済チャネルから返された必要な取引識別情報を保存し、該当する注文からチケットを送信します。完全な支払い情報や調査に関係のないアカウントの機密情報は送信しないでください。
ストレージ拡張やThunderbolt 5の並列接続はどう確認しますか？
注文設定と注文詳細で、追加項目、期間、数量を確認します。Thunderbolt 5の並列接続はデバイス1台ごとに計算されます。提供内容と注文詳細が一致しない場合は、その注文からチケットを送信し、情報を隠したスクリーンショットを添付してください。
そのまま調査できるチケットを送信
「接続できない」の一言より、5つのコンテキストで対応を早める
稼働中の問題は、デバイスと注文を正しく関連付けられるよう、該当する注文からチケットを送信してください。一般的な問い合わせはsupport@deploymini.comにもメールできます。
サポート実行ランブック
REQUIRED CONTEXT
送信前に確認
01
注文番号
コンソールから該当する注文番号をコピーし、デバイスのニックネームだけを書かないでください。
02
ノード
シンガポール、日本（東京）、韓国（ソウル）、香港、米国西部のいずれかを明記してください。
03
発生時刻
タイムゾーン付きの時間範囲を記載し、問題が継続しているかどうかも説明してください。
04
再現手順
実際に実行した順序に沿って、コマンド、画面操作、期待される結果を列挙してください。
05
情報を隠したログ
最初のエラーと前後のコンテキストを残し、アドレス、トークン、業務データを削除してください。
稼働中の問題はこちらを優先
該当する注文からチケットを送信
接続中断、ハードウェア異常、注文の引き渡し、請求との関連付けに適しています。コンソールに入り、注文を開いてからチケットを作成してください。
一般的な問い合わせ
サポートメールで問い合わせる
設定の選択、提携に関する相談、安全性・プライバシーに関する質問に適しています。件名に問い合わせの種類を記載し、注文がある場合は注文番号も添えてください。
チケットやメールにパスワード、秘密鍵、完全な支払い情報を送信しないでください
スクリーンショットは関係のないウィンドウを切り取り、ログ内のユーザー名、ホストアドレス、トークン、リポジトリアドレス、プロジェクトデータを置き換えてください。サポートによる調査には通常、エラーの前後関係と必要な識別情報だけで十分です。
問題のエスカレーション経路
影響の種類に応じた対応キューへ進む
問題の種類、影響範囲、現在も発生しているかを明確にすると、追加情報のやり取りを減らせます。以下の4種類は同じチケット入口を使いますが、必要な証拠は異なります。
一般的な問い合わせ
設定の選択、ノードの対応地域、利用期間、支払い基準、チームの長期的な要件。
接続障害
SSHのタイムアウト、認証失敗、ブラウザセッションの切断、対象ポートへの到達不能。
ハードウェア異常
単一のプロジェクトに関係なく、ディスク、メモリ、再起動、デバイスレベルのエラーが継続して発生している。
セキュリティインシデント
不審なアクセス、認証情報の漏えいの疑い、想定外のシステム操作を発見した。
稼働中のデバイスの問題を一般問い合わせメールだけで送らないでください
コンソールでチケットを送信
該当する注文からチケットを送信すると、デバイス、ノード、注文の関連付けを維持でき、初回確認にかかる時間を短縮できます。
準備はできましたか？それとも調査を続けますか？
新しいタスクは開始手順に沿って鍵、ノード、ツールのバージョンを準備してください。すでに問題が発生している場合は、該当する注文からチケットを送信します。