エンジニアリングサポート

問題の起点から、トラブルシューティングを始める

注文ステータス、接続経路、開発ツール、請求項目を順番に確認してください。解決しない場合は、注文ID、発生時刻、マスキング済みログを添えてサポートチケットを送信すると、確認のやり取りを減らせます。

サポート手順を確認済み 5つの問題カテゴリ
まず確認 注文ステータスと対象ノード シンガポール、日本(東京)、韓国(ソウル)、香港
次に検証 ローカルネットワーク、アドレス、認証情報、ツールチェーン コマンド、エラー原文、発生時刻を保存
解決しない場合 マスキング済みの状況を送信 パスワード、秘密鍵、完全な決済情報は送らないでください
問題の入口 5つのサポート手順
稼働ノード 365日、年間を通して継続稼働
お問い合わせ先 サポートチケットまたはサポートメール
問題の切り分け

まず問題の種類に合った確認手順を選ぶ

同じ症状でも原因の階層は異なる場合があります。まず注文、接続、環境、請求、安全のどれに該当するかを確認し、その階層に必要な情報を集めてください。

注文・納品

支払い完了後もステータスが更新されない、納品情報が不足している、ノードや利用期間が注文記録と一致しない場合に適しています。

注文ステータスの意味を見る

リモート接続

VNCで画面が表示されない、SSHがタイムアウトする、認証情報が拒否される、ホストフィンガープリントが変わった、再起動後に一時的に再接続できない場合に適しています。

接続を確認する

開発環境

Xcodeのバージョン不一致、コマンドラインツールのパス誤り、署名素材が見えない、Homebrewコマンドがない、runnerの権限不足などに適しています。

ビルド環境を確認する

請求・更新

期間、基本モデル、ノード、SSD追加、Thunderbolt 5連結の項目を確認したい場合や、更新前に請求項目を確認する場合に適しています。

請求に関するQ&Aを見る

安全上の問題

アカウントの異常、未承認アクセス、秘密情報の漏えいが疑われる場合に適しています。まずアクセスを制限し、関連する認証情報をローテーションしてから、必要なマスキング済み記録を保存してください。

セキュリティレポートを送信
注文ステータス

ステータスを見れば、次に確認すべき項目がわかる

コンソールに入ったら、まず注文ID、現在のステータス、選択したノード、利用期間の終了時刻を記録してください。リモートクライアントの表示だけでデバイスの状態を判断しないでください。

  1. 01

    確認中

    注文情報または支払い結果を確認しています。モデル、期間、ノード、追加項目、USDの支払総額が送信内容と一致するか確認してください。

    主な項目:注文ID、支払い方法、作成時刻
  2. 02

    設定中

    物理ノードに注文内容を設定しています。この段階では接続先アドレスや認証情報が完全に表示されないことがあるため、古いアドレスで繰り返し接続しないでください。

    主な項目:対象ノード、設定ステータス、最新のステータス変更
  3. 03

    接続可能

    接続情報が生成されました。コンソールに現在表示されているアドレス、アカウント情報、接続方式を使用し、クライアントが正しいノードを指定していることを確認してください。

    主な項目:接続先アドレス、ノード、有効期限
  4. 04

    利用期間終了

    現在の利用期間が終了したため、以前の接続情報は有効なサービスを示しません。データは期限前に移行し、その後の注文は新しいコンソール記録を基準にしてください。

    主な項目:利用期間の開始・終了時刻、最終移行記録
ノード一覧とリアルタイム結果 ZoomMini M4 CoreとZoomMini M4 Plusは、シンガポール、日本(東京)、韓国(ソウル)、香港の4ノードに対応しています。実際の利用可否と注文結果は、コンソールからのリアルタイム応答を基準としてください。
接続トラブルシューティング

ネットワーク到達性からセッション復旧まで確認する

順番に確認すれば、ローカルネットワークの問題をデバイスの問題と誤認しにくくなります。各手順で発生時刻、対象アドレス、エラー原文を保存してください。

connection-check.sh
$ ping -c 4 <host>
4 packets transmitted, 4 received

$ ssh -vvv user@<host>
debug1: Connecting to <host>
debug1: Server host key verified

$ nc -vz <host> <port>
Connection succeeded
VNCと画面表示

アドレスには到達できるが画面が表示されない

コンソールのステータスが「接続可能」であることを確認し、クライアントでは現在のアドレスと割り当てられた認証情報を使用してください。古いセッションを終了して再接続し、解像度、色品質、アニメーション効果を下げて、低速なネットワークの影響を切り分けます。

リモート接続方法を見る
再起動後の復旧

再起動後、一時的に接続できない

まずシステムの起動完了を待ち、コンソールでデバイスの状態を更新してください。接続先アドレスを再取得し、クライアントに保存された古いセッションを削除してから、VNCとSSHを個別にテストし、問題がグラフィカルセッションとネットワーク層のどちらにあるか確認します。

デバイスの状態を見る
01

ネットワーク到達性を確認

安定している別のローカルネットワークに切り替え、対象アドレス、ポート、タイムアウト結果を記録してください。他のサイトをブラウザーで開けるかどうかだけで判断しないでください。

02

アカウント認証情報を確認

ユーザー名、パスワード、SSHキーが現在の注文情報に記載されたものか確認し、コピー時に空白が入っていないか確認してください。誤った認証情報を連続して送信しないでください。

03

SSHフィンガープリントの変更に対応

まずコンソールで対象アドレスが変わっていないか確認します。対象に間違いがないことを確認してから、該当する古いknown_hostsエントリを削除してください。ファイル全体を消去しないでください。

04

クライアントとノードの問題を切り分ける

信頼できる別のデバイスまたは別の接続方式で再テストしてください。SSHは使えるのにVNCが使えない場合は、グラフィッククライアントのバージョンとセッションの状態を優先して記録します。

ビルド環境

ツールチェーンの依存関係に沿って確認する

まずシステムで実際に選択されているXcodeを確認し、次に署名、パッケージマネージャー、runnerの権限を確認してください。前提確認を省くと、後続エラーの判断材料が失われます。

  1. 01

    Xcodeのバージョンと選択パスを確認

    次を実行: xcodebuild -version および xcode-select -p。プロジェクトが要求するバージョンと、現在のDeveloperディレクトリが一致するか確認してください。

  2. 02

    コマンドラインツールを確認

    次を実行: clang --versionswift --version。ツールが存在しない、またはバージョンが一致しない場合は、まずXcodeの選択パスを修正してから再テストしてください。

  3. 03

    証明書とプロビジョニングプロファイルを確認

    ビルドユーザーが必要な署名素材を読み取れることを確認し、証明書の有効性、プロビジョニングプロファイルの識別子、プロジェクト設定を確認してください。ログには名称とエラー種別だけを残し、秘密情報は含めないでください。

  4. 04

    Homebrewのパスを確認

    Apple Silicon環境では通常、 /opt/homebrew/bin が非対話シェルのPATHに含まれていることを確認し、runnerの起動環境とターミナル環境が一致することを検証します。

  5. 05

    runnerの最小権限を確認

    self-hosted runnerが、作業ディレクトリ、キャッシュディレクトリ、ビルド成果物ディレクトリに必要な権限を持つことを確認してください。システム全体の権限を広げて、特定パスの問題を隠さないでください。

toolchain-check
$ xcodebuild -version
Xcode <required-version>
Build version <build-version>

$ xcode-select -p
/Applications/Xcode.app/Contents/Developer

$ command -v brew
/opt/homebrew/bin/brew

$ test -w "$RUNNER_WORKDIR"
$ echo $?
0

$ xcodebuild -scheme App build
** BUILD SUCCEEDED **
成功判定は最後の1行だけで行わない コマンドの終了コード、実際の成果物パス、テストレポート、署名手順も確認してください。キャッシュがヒットしてもビルド成功とは限らず、runnerがオンラインでも作業ディレクトリの権限があるとは限りません。
用語集

頻出8用語の正確な意味

これらの用語は、ハードウェアの割り当て、接続方式、自動化の役割、注文の範囲を表します。問題を報告する際に正確な用語を使うと、切り分けの曖昧さを減らせます。

物理ノード
macOSワークロードを実際に実行するApple Siliconハードウェアで、注文の接続先アドレスと稼働状態に対応する基盤リソースです。
専有
有効な1件の注文につき1台の専有物理マシンが割り当てられ、計算資源、メモリ、ローカルストレージを他の顧客セッションと共有しません。
非仮想マシン
ワークロードは注文に対応する物理Mac mini上で直接実行され、共有ホストから分割された仮想コンピューティングインスタンスではありません。
VNC
macOSのグラフィカルインターフェースにアクセスするためのリモート表示プロトコルです。ウィンドウ操作、UIテスト、ビジュアル設定に適しています。
SSH
コマンドライン操作、自動化、ファイル転送、診断に使用する暗号化接続方式で、継続的インテグレーションやスクリプト化されたワークフローに適しています。
self-hosted runner
専有クラウドMac上に配置し、チームが権限とツールチェーンを自分で設定する自動実行環境です。パイプラインのタスクを受信して実行します。
利用期間
注文で定められたサービスの開始から終了までの期間で、日、週、月、四半期から選択できます。接続情報、更新確認、データ移行はこの期間を基準にしてください。
ノード
デバイスが配置されているサービス地域です。現在の一覧にはシンガポール、日本(東京)、韓国(ソウル)、香港の4ノードがあります。
請求に関するQ&A

更新前に請求の内訳を確認する

請求書では、基本モデル、期間、ノード、追加項目を分けて表示してください。決済ゲートウェイの実際の利用可否は、コンソールの応答を基準とします。

日・週・月・四半期の料金は?

注文は購入時に選択した1つの期間単位で課金され、異なる期間を組み合わせることはありません。更新前に、モデル、期間、ノード、利用期間の開始・終了時刻、支払総額を再確認してください。

SSDとThunderbolt 5連結はどのように表示されますか?

+1TB SSD、+2TB SSD、Thunderbolt 5連結は、選択した期間ごとに個別表示され、基本モデル名に統合されません。Thunderbolt 5連結はデバイス単位で計算されるため、数量を確認する際は関連デバイスも確認してください。

通貨と支払い方法は?

すべての注文は米ドル(USD)で決済されます。対応する支払い方法はUSDT-TRC20、およびVisa / Mastercard / Amex(Stripe経由)のみです。利用可能なゲートウェイはコンソールのリアルタイム応答を基準とします。

更新前に必ず確認する項目は?

注文ID、基本モデル、選択した期間、対象ノード、SSD追加、Thunderbolt 5連結数、USD小計、支払総額、新しい利用期間の終了時刻を順番に確認してください。項目が一致しない場合は、支払い前にチケットを送信してください。

支払い後にステータスが更新されない場合、何を提供すべきですか?

注文ID、支払い方法、支払い発生時刻、コンソールの現在のステータス、マスキング済みの取引参照情報を提供してください。完全なカード情報、完全な決済情報、アカウントパスワードは送らないでください。

サポートチケットのチェックリスト

調査をすぐ始められる情報を送る

有効なチケットでは、「どの注文か、どのノードか、いつ発生したか、どう再現するか、何が表示されたか」を回答できるようにします。機密情報は先にマスキングしてください。

必須情報

以下の順序でチケット本文を整理

  1. 01
    注文IDとノード

    コンソールの注文IDと、シンガポール、日本(東京)、韓国(ソウル)、香港のいずれかの対象ノードを記載してください。

  2. 02
    問題の発生時刻

    タイムゾーン付きの初回発生時刻、直近の再現時刻、問題が継続的か断続的かを記載してください。

  3. 03
    再現手順と期待結果

    コンソールへのログインまたはコマンドの実行から順を追って説明し、実際の結果と期待結果を分けて記載してください。

  4. 04
    環境と接続方式

    ローカルシステム、クライアントのバージョン、VNCまたはSSH、macOSとXcodeのバージョン、プロキシ経由のネットワークかどうかを記載してください。

  5. 05
    マスキング済みログ

    エラーコード、コマンド、終了コード、必要な状況情報を残し、ユーザー名、アドレス、トークン、リポジトリパス、決済参照情報の機密部分を置き換えてください。

送信してはいけない情報

秘密情報は調査資料ではありません

パスワード、秘密鍵、リカバリーコード、リポジトリトークン、署名用シークレット、完全な決済情報、マスキングしていない顧客データは送信しないでください。秘密情報が漏えいした疑いがある場合は、直ちにローテーションしてください。

データ保護の範囲を見る
送信方法

コンソールチケットで状況を保持する

既存の注文に関する問題は、注文ステータスと関連付けやすいコンソールからチケットを送信してください。ログインできない場合は support@zoommini.com を使用し、件名に問題のカテゴリを記載してください。

コンソールチケットを作成
送信の準備

注文情報を添えて、有効な情報から調査を始める

対応時間は問題の複雑さと必要な確認内容によって異なります。送信後はコンソールでリクエストの状態を確認できます。ログインできない場合はサポートメールを使用してください。