技術トラブル振り分け

まず工程を特定して、クラウドMacの問題を解決

注文・開通、ノード接続、iOSビルド、ストレージ拡張、請求確認まで、問題が発生した箇所を順番に確認します。各項目に判断基準、コマンド、チケット提出時に保存すべき情報を示します。

01 / 初回開通

設定を決められた順序で行い、納品後のやり直しを減らす

初回レンタルでは、まずメモリとストレージの要件を確認し、コードリポジトリ、チームメンバー、配信市場に近いノードを選びます。先に支払ってから構成を決めるのではなく、注文確定前にモデル、ノード、期間、追加項目をまとめて確認してください。

  1. 01

    3つのプランからモデルを選択

    ZoneMini M4 Core M4、16GBメモリ、256GB SSDを搭載し、軽量なiOSビルドや単一プロジェクトの自動化に適しています。ZoneMini M4 Plus M4、24GBメモリ、512GB SSDを搭載し、日常の開発や複数プロジェクトのパイプラインに適しています。ZoneMini M4 Pro M4 Pro、64GBメモリ、2TB SSDを搭載し、大容量メモリを使う推論や高負荷の並列タスク向けです。3プランともクラウド上の専有物理Macで、仮想マシンではありません。

  2. 02

    販売中の5ノードから場所を選択

    シンガポール、日本(東京)、韓国(ソウル)、香港、米国東部から選択できます。コードリポジトリと主な利用者の場所を優先し、配信市場やチームのタイムゾーンも考慮してください。5ノードすべてで3モデルを利用できますが、実際の利用可否はコンソールの最新表示に従います。

  3. 03

    日・週・月・四半期から期間を選択

    一時的な互換性テストには日単位、1回の継続的な開発サイクルには週単位、固定Runner、長期アーカイブ、継続的な推論タスクには月単位または四半期単位が適しています。表示価格は換算・丸め処理を行わず、選択したモデル、追加項目、期間に基づいて注文金額を計算します。

  4. 04

    USDで決済し、注文内容を確認

    支払い方法はUSDT-TRC20とVisa / Mastercard / Amex(Stripe経由)のみです。送信前にモデル名、ノード、期間、追加ストレージ、Thunderbolt 5接続台数、連絡先を確認してください。利用可能な決済ゲートウェイはコンソールの表示に従います。

  5. 05

    接続情報を取得して初回確認を完了

    納品後、ノードアドレス、ユーザー名、一時認証情報、接続手順を確認します。初回接続に成功したら一時認証情報を更新し、ホストフィンガープリントを記録して、SSHコマンドラインとmacOS画面共有を個別に検証します。接続情報は機密情報のため、公開リポジトリや通常のチャットに貼り付けないでください。

開通前に準備しておきたい最小限の情報

プロジェクトの種類、同時実行タスク数、Xcodeのバージョン範囲、1回のアーカイブ所要時間、依存キャッシュの容量、希望ノード、想定レンタル期間を整理します。モデルを判断できない場合は、3プランの仕様と期間別料金を確認してから、タスク情報をチームに共有してください。

02 / 接続診断

インスタンスの状態からローカルネットワークまで順に切り分ける

接続に失敗しても、認証情報、ポート、ファイアウォールを同時に変更しないでください。状態、認証、ネットワーク、ポート、サービス設定の順に確認し、各結果を保存すると、問題がローカル、伝送経路、対象ノードのどこにあるか判断できます。

CONNECTION CHECK 6項目を順番に確認
  1. 01

    インスタンスの状態を確認

    コンソールにログインし、注文に対応するインスタンスが接続可能な状態か確認します。現在表示しているノードとモデルも確認してください。納品直後は、古いメールや記録のアドレスではなく、コンソールの表示を優先します。

  2. 02

    アクセス認証情報を確認

    ユーザー名、パスワード、SSHキーの用途を区別し、キーファイルの権限、入力方式、コピー時の余分なスペースを確認します。認証に連続して失敗した場合は試行を止め、認証情報の入手元を確認し直してください。

  3. 03

    ローカルネットワークの制限を切り分ける

    信頼できる予備ネットワークに切り替えて比較し、会社の出口ポリシー、プロキシ、セキュリティソフトが対象アドレスを遮断していないか確認します。すべてのセキュリティ保護を無効にする方法を恒久的な解決策にしないでください。

  4. 04

    SSHポートを確認

    まずTCP 22ポートに到達できるかテストし、その後詳細なSSHログを取得します。ポートのタイムアウトは通常、ネットワーク経路またはルールの問題を示します。ポートに到達できても認証に失敗する場合は、ユーザー名、キー、権限を確認します。

  5. 05

    画面共有の設定を確認

    納品情報に記載されたアドレスと認証情報を使用しているか確認します。画面が黒い、または解像度に異常がある場合は、古いセッションを切断して再接続し、クライアントOS、ディスプレイ数、拡大縮小設定を記録します。

  6. 06

    ファイアウォールルールを確認

    ローカルファイアウォール、チームの出口ルール、ノード側の許可範囲を確認します。ルール変更は最小限の開放原則で行い、送信元、ポート、時刻、変更者を記録してください。

ネットワークとポートの確認
nc -vz <节点地址> 22
ssh -vvv -o ConnectTimeout=10 用户名@节点地址
route -n get <节点地址>

プレースホルダーを納品情報のノードアドレスとユーザー名に置き換えてください。

結果の読み方

タイムアウトと認証失敗を区別する

接続タイムアウト
ローカルの出口、プロキシ、ファイアウォール、対象ポートへの到達性を優先して確認します。
接続拒否
時刻、ノード、完全なエラー行を記録し、対象アドレスとポートが正しいか確認します。
認証失敗
ユーザー名、キーのパス、ファイル権限、納品された認証情報を確認し、パスワードを繰り返し推測しないでください。
ホストフィンガープリントの変更
接続を停止してチケットで確認し、記録済みのフィンガープリントを削除して接続を続けないでください。
接続手順をすべて読む
03 / ビルド環境

ビルド失敗をツールチェーン、署名、依存関係、成果物の4層に分ける

同じパイプラインが対話セッションでは成功し、CI Runnerでは失敗する場合、環境変数、キーチェーンのコンテキスト、作業ディレクトリ、キャッシュ権限が異なる可能性があります。調査では失敗したタスクと同じユーザー、同じ実行経路を使用してください。

A

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

システムバージョン、Xcodeバージョン、現在の開発者ディレクトリを記録します。Xcodeが複数インストールされている場合は、パイプラインが呼び出すパスとプロジェクト要件が一致するか確認してください。GUIで開いているバージョンだけを確認しないでください。

  • xcodebuild -version 実際のビルドツールのバージョンを取得
  • xcode-select -p 現在の開発者ディレクトリを取得
  • swift --version Swiftツールチェーンを確認
B

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

現在の実行ユーザーが署名素材にアクセスでき、ターゲット、構成、エクスポート方式が正しい項目を参照しているか確認します。記録するのは証明書名、状態、照合結果だけにし、証明書の秘密鍵や完全なプロファイルをチケットにアップロードしないでください。

  • プロジェクトのTeam、Bundle Identifier、署名方式を確認
  • ビルド構成のプロビジョニングプロファイルがターゲットと一致するか確認
  • ローカルセッションとRunnerセッションで見える署名IDを比較
C

キーチェーンへのアクセスコンテキストを確認

CIタスクが非対話環境で署名素材にアクセスする場合、パイプラインの設計どおりキーチェーンがロック解除され、自動化アカウントのアクセス範囲が制限されているか確認します。ロック解除パスワードをリポジトリのスクリプトや通常のログに直接書かないでください。

  • 実行ユーザーと署名素材をインポートしたユーザーが一致するか確認
  • Runnerの起動方法によってセッションコンテキストが変わっていないか確認
  • ログからパスワード、トークン、秘密鍵のパスを削除
D

依存キャッシュの問題を切り分ける

まずロックファイルに変更がないことを確認し、CocoaPods、Swift Package Manager、Node.js、Flutterの依存関係を個別に確認します。キャッシュに異常がある場合は、対象プロジェクトに関係するディレクトリだけを削除し、チーム共有キャッシュを一括削除しないでください。

  • ロックファイルのハッシュと依存解決の出力を保存
  • 失敗ブランチと成功ブランチの依存バージョンを比較
  • キャッシュディレクトリの所有者、権限、現在の容量を記録
E

再現可能なアーカイブログを収集

完全なコマンド、作業ディレクトリ、Scheme、Configuration、SDK、Destination、終了コードを保存します。ログはエラーが初めて現れる前後のコンテキストを含め、最後の1行だけを切り取らないでください。

  • 今回のビルド出力を専用の結果ディレクトリに保存
  • 実行方法、コミット識別子、Runnerラベルを記録
  • 機密情報を除去してから重要部分をコンソールのチケットに添付
F

まず最小コマンドで検証

完全なアーカイブの前に、バージョン、プロジェクト構成、Schemeの可視性を確認します。最小コマンドが失敗したらツールチェーンを修正し、最小コマンドが成功してアーカイブだけ失敗する場合は署名、依存関係、エクスポート設定を確認します。

ビルド構成を相談
ビルド環境情報の収集
sw_vers
xcodebuild -version
xcode-select -p
swift --version
xcodebuild -list -workspace <项目工作区>

コマンドはプロジェクトの秘密情報を読み取りません。ただし結果を送信する前に、内部パスやリポジトリ名が含まれていないか確認してください。

04 / ストレージ・接続構成

容量の用途を確認してから、マウントとタスクの境界を確認

追加ストレージは依存キャッシュ、ビルド中間ファイル、モデルファイル、短期的な素材処理に適しています。プロジェクト本来のバージョン管理や長期アーカイブの代わりにはなりません。Thunderbolt 5接続は1台ごとに課金され、複数マシンの協調を明確に設計したタスクに適しています。独立した2つのタスクを自動的に1つの並列ジョブにするものではありません。

ストレージ・接続オプションの掲載価格
追加項目 日額 週額 月額 四半期額 用途
+1TB SSD $2 $5.5 $10.1 $27.5 依存キャッシュ、ビルド成果物、中規模素材
+2TB SSD $4 $11 $20.2 $55 モデルファイル、バッチ処理素材、大容量アーカイブ作業セット
Thunderbolt 5接続(1台あたり) $1.7 $4.6 $8.6 $23.4 複数マシンのタスク分割、ノード間の高速データ連携
マウント確認

システムが対象ディスクを認識しているか確認

次のコマンドで diskutil list ディスクとパーティションを確認し、続いて df -h 実際のマウントポイントと空き容量を確認します。デバイスだけが表示され、正しいマウントポイントがない場合は、コマンド出力を記録してチケットを送信してください。不明なディスクを直接フォーマットしないでください。

容量監視

総容量と増加しているディレクトリを同時に確認

アーカイブに失敗する前に、ワークスペース、DerivedData、依存キャッシュ、一時ディレクトリを確認します。ビルドログの「容量不足」はシステムボリュームや一時ディレクトリが原因で、プロジェクトのあるボリュームとは限りません。

タスク分割

入力、実行、成果物でホストの役割を定義

複数マシンのワークフローでは、コード取得、ビルドまたは推論、成果物の保存先、失敗時の再試行方法を明確にします。複数ホストが同じ作業ディレクトリや変更可能な共有キャッシュを同時に変更しないようにしてください。

ディスクとキャッシュの確認
diskutil list
df -h
du -sh ~/Library/Developer/Xcode/DerivedData
du -sh ~/Library/Caches

大きなディレクトリの集計には時間がかかる場合があります。まず出力を確認し、用途を確認する前にディレクトリを削除しないでください。

05 / 請求・支払い

注文番号でモデル、期間、追加項目を確認

ZoneMiniのすべての注文はUSDで決済され、支払い方法はUSDT-TRC20とVisa / Mastercard / Amex(Stripe経由)のみです。利用可能な決済ゲートウェイはコンソールの表示に従います。請求に関する問い合わせは具体的な注文を基準に確認し、支払い画面のスクリーンショットや曖昧な取引時刻だけを送らないでください。

決済通貨 USD

モデル、期間、追加項目はすべてページ掲載の米ドル価格で計算され、ページ上での通貨換算は行いません。

暗号資産決済 USDT-TRC20

支払い前に、コンソールに表示されたネットワーク、金額、注文情報を確認します。問い合わせ時は注文番号とマスキング済みの取引IDを提供してください。

カード決済 Visa / Mastercard / Amex

カード決済はStripeで処理されます。失敗した場合は、コンソールのエラー情報、発生時刻、注文番号を記録し、カード情報全体は送信しないでください。

最終金額でモデル、期間、追加項目をすべて確認する必要があるのはなぜですか?

注文金額は、選択したモデルの期間料金に、同じ期間のストレージまたはThunderbolt 5接続オプションを加えて算出されます。確認時は、注文のモデル名、ノード、日・週・月・四半期の期間、追加容量、接続台数を項目ごとに比較してください。

支払いが完了しない場合、どの情報を保存すべきですか?

注文番号、支払い方法、発生時刻、コンソールに表示された完全なエラーテキスト、マスキング済みの取引IDを保存します。カード番号全体、確認コード、ウォレット秘密鍵、リカバリーフレーズ、アカウントの完全なパスワードは送信しないでください。

既存の注文はどの入口から確認できますか?

コンソールにログインして、注文、インスタンス、請求の状態を確認します。表示内容と支払い記録が一致しない場合は、その注文のコンテキストから注文番号を添えてチケットを送信し、関連情報のない依頼を同じ問題について複数作成しないでください。

06 / チケット送信

処理可能なチケットに必要な6種類のコンテキスト

チケットの目的は「問題がある」と証明することではなく、サポート担当者が影響範囲、再現手順、期待する結果を特定できるようにすることです。重要情報を1つの依頼にまとめると、追加確認の往復を減らせます。

01

ノード

シンガポール、日本(東京)、韓国(ソウル)、香港、米国東部のいずれかを明記し、コンソールのインスタンスIDを添えてください。

02

モデル

ZoneMini M4 Core、ZoneMini M4 Plus、ZoneMini M4 Proのいずれかを明記し、「M4ホスト」とだけ書かないでください。

03

発生時刻

タイムゾーンを含む時間帯を示し、初回発生、安定して再現、断続的な発生のいずれかを説明してください。

04

再現手順

作業ディレクトリへの移動または接続開始から、コマンド、入力条件、実際の結果、終了コードを順に記載してください。

05

マスキング済みログ

エラー前後のコンテキストを残し、リポジトリトークン、署名素材、内部アドレス、個人情報を削除してください。

06

期待する結果

本来どう動くべきか、また問題が接続、テスト、アーカイブ、支払い、成果物の納品のどれを阻害しているかを説明してください。

送信前に機密情報を削除

証明書の秘密鍵、リポジトリトークン、完全なパスワードをアップロードしない

署名証明書は名前と有効状態だけを提供し、トークンは種類と権限範囲だけを説明します。認証情報の問題ではエラー情報とマスキング済みの識別子だけを提供してください。ログ内のメールアドレス、リポジトリアドレス、内部ホスト名、ファイルパスも必要に応じてマスキングします。

  • 請求の問題には注文番号を添付
  • 接続の問題にはコマンド出力とクライアント環境を添付
  • ビルドの問題にはXcodeバージョン、Scheme、終了コード、重要なログを添付
  • ストレージの問題にはマウントポイント、容量、関連ディレクトリの増加状況を添付
診断情報の準備ができたら

注文のコンテキストからチケットを送信

既存の注文がある場合は、コンソールにログインしてチケットを送信し、注文番号、ノード、モデル、発生時刻、再現手順、マスキング済みログ、期待する結果を添えてください。購入前の選定については、サポートメールでチームに問い合わせできます。