-
01
ノード情報を確認 注文番号、ノードアドレス、ポート、アカウント名が同じホストに対応していることを確認します。基本
-
02
ネットワーク経路を確認 ネットワークを切り替えて再テストし、ローカル出口と対象ノードの問題を切り分けます。ネットワーク
-
03
接続情報を確認 認証情報の更新時刻、SSH鍵、ホストフィンガープリントを確認します。認証
-
04
macOSセッションを確認 グラフィカルセッション、ロック画面、バックグラウンドタスクが動作中か確認します。セッション
-
05
クライアント差異を切り分け クライアントのバージョン、表示設定、プロキシ、エラー原文を記録します。ローカル
順番に切り分け、適切な担当者へつなぐ
ここではクラウドMacの納品、リモート接続、SSH、Xcode、CI/CD、ストレージ、請求に関する問題を扱います。まず5つの基本確認を行えば、通常は1回のチェックで原因がローカルネットワーク、接続情報、macOSセッション、ビルド環境のどこにあるか判断できます。
エンジニアの対応が必要な場合は、コンソールのチケットに注文番号、対象ノード、発生時刻、スクリーンショット、実施済みの手順を添付してください。パスワード、秘密鍵、復旧用認証情報は送信しないでください。
- 7種類
- 問い合わせ入口
- 5項目
- 基本診断
- 2種類
- 連絡方法
7つの入口から、正しい方向で切り分ける
現在の症状に最も近い入口を選択してください。各カードに最初の確認事項と保存すべき証拠を示しています。
注文済みだが接続情報を確認できない
注文状況、選択したモデル、対象ノードを確認し、コンソールにノードアドレス、ポート、アカウント名、接続手順が生成されているか確認します。
- 注文番号と注文時刻を記録
- 選択したノードが注文内容と一致するか確認
- 同じ注文を繰り返し作成しない
グラフィカル画面が開かない、黒画面になる、頻繁に切断される
まずノードアドレスとポートを確認し、別のネットワークで再テストします。クライアント名、バージョン、表示設定、完全なエラー画面を保存してください。
- セッションがロック画面で止まっていないか確認
- 表示解像度を下げて再テスト
- ローカルプロキシとファイアウォール規則を確認
鍵が拒否される、フィンガープリントが変わった、接続がタイムアウトする
ローカル秘密鍵の権限、公開鍵の内容、対象アカウント、ポート、ホストフィンガープリントを個別に確認します。秘密鍵をチケットやメールに貼り付けないでください。
- 時刻付きのエラー原文を保存
- 公開鍵が改行で壊れていないか確認
- 鍵を交換した後も旧セッションを保持
バージョン不一致、ビルド失敗、キャッシュ異常
macOS、Xcode、プロジェクトのコミット、依存関係のバージョンを記録します。まずコードを変更せず環境を確認し、その後キャッシュ削除を判断します。
- 最初に発生した実際の失敗ログを保存
- 環境エラーとコードエラーを切り分け
- 削除前にキャッシュディレクトリの使用量を記録
runnerがオフライン、ジョブが停止、作業ディレクトリが変わる
runnerのサービスプロセス、登録範囲、作業ディレクトリ、同時実行ジョブ、ネットワーク出口を確認します。まず最小テストを実行してからパイプライン全体を再開します。
- 失敗したジョブ番号を記録
- runnerの最終オンライン時刻を確認
- キャッシュでディスクが満杯になっていないか確認
ディスク容量低下、キャッシュ肥大、書き込み失敗
ディレクトリ別に使用量を集計し、プロジェクトファイル、依存キャッシュ、ビルド成果物、ログ、一時ファイルを区別します。出所不明のシステムディレクトリを直接削除しないでください。
- 空き容量と異常なディレクトリを記録
- 増え続けるログファイルを確認
- 削除後に最小ビルドを再実行
期間、ノード、追加項目、支払い記録を確認したい
米ドルの請求書に記載されたモデル、利用期間、ノード、ストレージ拡張、Thunderbolt 5の並列数を1項目ずつ確認し、支払い記録も照合します。
- 日・週・月・四半期の期間を確認
- 追加項目の数量と単価を照合
- 注文番号を添付し、決済用キーは送信しない
ビルドログ、エラー原文、クライアントバージョン、ディスク使用量、発生時刻を揃えると確認の往復を大幅に減らせます。認証情報に関しては状態だけを記載し、パスワード、秘密鍵、復旧用認証情報は送信しないでください。
「接続できない」を検証可能な5つの段階に分ける
各ステップの結果を記録してください。ネットワーク、鍵、クライアントを同時に変更すると、復旧後も本当の原因を特定できません。
クイック診断パネル
-
01
ノード情報出力:ノード記録
コンソールで注文番号、ノードコード、ノードアドレス、ポート、アカウント名を確認します。情報をコピーする際は前後の空白を確認し、記憶で入力しないでください。
-
02
ネットワーク到達性出力:ネットワーク比較
現在のネットワーク、プロキシ、出口環境を記録し、元のネットワークと別の信頼できるネットワークで再テストします。特定のネットワークだけ失敗する場合は、まずローカル出口の制限を確認します。
-
03
認証情報の状態出力:状態説明
一時認証情報が更新済みか、SSH公開鍵が完全か、秘密鍵の権限が適切かを確認し、ホストフィンガープリントが初回記録と一致するか照合します。
-
04
macOSセッションの状態出力:セッション範囲
ホスト全体に到達できないのか、グラフィカルセッションだけ応答しないのかを判断します。SSH接続が可能なら、まずセッション、ロック画面、関連プロセスを確認します。
-
05
ローカルクライアント設定出力:クライアント比較
クライアント名、バージョン、表示解像度、色設定、プロキシ、エラー原文を記録します。別の互換クライアントで再テストする際は、他の条件を変えないでください。
単一の要因まで特定できた
特定のローカルネットワークだけ失敗する、古い鍵だけ拒否される、特定のクライアントだけ表示異常が起きる場合などです。変数は一度に1つだけ変更して再確認します。
ネットワークとクライアントを変えても再現する
5項目の確認結果、発生時刻、エラー画面を1枚のチケットにまとめてください。エンジニアは証拠に基づいてノードとセッションを続けて確認できます。
対象を統一し、プロトコル・セッション・ホストを混同しない
これらの用語は納品資料、接続手順、チケットの返信に登場します。問題を説明する際は対応する用語を使ってください。
- クラウドMac
- ネットワーク経由で利用するmacOS作業環境。Xcodeビルド、自動テスト、スクリプト処理、ローカルモデル推論に使用できます。利用方法を示す名称であり、仮想化を意味しません。
- 物理ノード
- 注文を実際に処理するApple Siliconホストと、そのネットワーク上の場所。通常、アドレス、ポート、リージョンコードを含みます。
- 専有
- 有効な1件のレンタルにつき専用の物理ホスト1台を利用し、他の利用者と同じホストの計算資源を共有しません。
- 非仮想マシン
- 提供対象は専用物理ホストであり、共有ホストから分割された仮想インスタンスではありません。障害対応ではホスト状態とリモートセッション状態を分けて確認します。
- VNC
- macOSのグラフィカル画面へアクセスするリモートデスクトッププロトコル。Xcode操作、GUIツールの確認、デスクトップセッションの検証に適しています。
- SSH
- コマンドラインログイン、スクリプト実行、ファイル処理、CI/CD管理に使用する安全な接続方式。接続時はアドレス、ポート、アカウント、鍵、ホストフィンガープリントを確認します。
- self-hosted runner
- レンタルしたホスト上に配置する継続的インテグレーション実行環境。プロジェクト範囲、作業ディレクトリ、同時実行数、キャッシュ方針はチームが設定します。
- セッションの復元
- リモートデスクトップ切断後、元のmacOSセッションに再接続すること。復元されるのはグラフィカルセッションであり、ホストの再起動やビルド環境の再作成ではありません。
初回ログイン、鍵の交換、画面異常を個別に対応
現在の症状に一致する項目を開き、順番に実行してください。条件は毎回1つだけ変更し、再テストしてから次へ進みます。
初回のリモートログインに失敗したら、最初に何を確認すべきですか?
まずコンソールからノードアドレス、ポート、アカウント名を再コピーし、同じ注文の情報であることを確認します。次にローカルネットワークでプロキシ、ポート制限、追加のファイアウォール規則が有効になっていないか確認します。
- クライアント名、バージョン、完全なエラー文を記録します。
- 入力欄に余分な空白がなく、アカウント名の大文字・小文字が変わっていないことを確認します。
- 別の信頼できるネットワークで再テストします。ただし認証情報は同時に変更しないでください。
- SSHは到達できるのにグラフィカル画面へ接続できない場合は、その違いをチケットに明記します。
一時認証情報を更新したのに、古い接続が失敗し続けるのはなぜですか?
古い認証情報を保存しているクライアントを完全に終了してから、接続を再作成します。一部のクライアントはアカウント名や認証情報をキャッシュするため、画面上のパスワード欄を変更するだけでは古い記録が消えない場合があります。
新しい認証情報が使えることを確認してから、古い記録を削除します。チケット、スクリーンショット、メールにパスワードを表示せず、更新時刻、使用したアカウント名、エラーの種類だけを記載してください。
SSH鍵を安全に交換し、接続不能を防ぐには?
現在接続中のSSHセッションを維持し、まず新しい公開鍵を追加して検証します。2つ目のターミナルで新しい接続を確立し、新しい鍵が成功したことを確認してから古い公開鍵を削除します。
- このホスト専用の鍵を生成し、出所不明の鍵ファイルを使い回さないでください。
- 公開鍵が1行で完全に記載されているか確認し、コピー時の改行や欠落を防ぎます。
- ローカル秘密鍵の権限と対象アカウントを確認します。
- ホストフィンガープリントを保存します。予期せず変わった場合は接続を停止し、チケットで確認してください。
VNCで黒画面、表示乱れ、入力遅延が発生した場合は?
まずSSHがまだ利用できるか判断します。コマンドライン接続が正常なら、問題はホスト全体のオフラインではなく、グラフィカルセッションまたはクライアントの表示設定にある可能性が高いです。
クライアントの解像度と色品質を下げ、ローカルプロキシを無効にして再テストします。全画面、拡大縮小、複数ディスプレイのどのモードだけで起きるか記録してください。複数のシステムプロセスを連続して強制終了しないでください。
遅延が大きいと感じるとき、再テスト可能な結果を得るには?
ローカルネットワークの種類、対象ノード、テスト時間帯、使用プロトコル、クライアントバージョンを記録します。元のネットワークと別の信頼できるネットワークで同じ手順を実行し、解像度、プロキシ、タスク負荷を揃えてください。
「遅い」という結論だけを記載しないでください。入力応答、画面更新、ファイル転送、コマンドエコーのどれが遅いのか、また継続的に発生するのかをチケットに明記します。
環境を固定してからXcode、runner、ディスクを分析
ビルド障害対応の目的は、すべてのキャッシュをすぐに消すことではありません。どの層が変化したかを特定し、再現可能な記録を残すことが重要です。
XcodeとmacOSのバージョンを確認
現在のXcode完全版、コマンドラインツールのパス、macOSバージョン、プロジェクトのコミットを記録します。チームに基準環境がある場合は、前回成功したビルド記録と照合します。
xcodebuild -version
xcode-select -p
sw_vers
署名環境の範囲を確認
プロジェクト設定、証明書ファイル、プロビジョニングプロファイル、ビルドスクリプトの参照関係を確認します。チケットには機密項目を隠したエラー画面を添付できますが、署名用秘密鍵やパスワードはアップロードしないでください。
- 最初の署名エラー原文を保存
- 失敗したtargetとビルド構成を記録
- ローカルスクリプトエラーとプロジェクト設定エラーを区別
証拠に基づいてキャッシュを削除
まずDerivedData、依存キャッシュ、作業ディレクトリの使用量を記録し、失敗したプロジェクトに関係するディレクトリだけを削除します。削除後は最小ビルドを1回実行し、同時実行ジョブによる結果の上書きを避けます。
du -sh ~/Library/Developer/Xcode/DerivedData
df -h
CI runnerを再接続
runnerのサービスプロセス、登録範囲、作業ディレクトリ、最終オンライン時刻を確認します。リリース処理を含まない最小テストで、ネットワーク、権限、実行環境を検証します。
- 失敗したジョブ番号と時刻を記録
- 同じrunnerが重複登録されていないか確認
- 作業ディレクトリの所有者と空き容量を確認
ディスク増加の原因を確認
プロジェクトファイル、依存関係、ビルド成果物、ログ、一時ファイルに分類して集計します。空き容量が減り続ける場合は、増加しているディレクトリと観測間隔を記録してチケットを送信します。
df -h
du -sh ~/Library/Developer/*
du -sh ~/Library/Caches/*
まずログ、バージョン、ディスク使用量、失敗したジョブ番号を保存します。すべてのキャッシュを直接消去したり設定を上書きしたりすると、一時的に解決しても原因を特定する証拠を失う可能性があります。
期間、構成、ノード、追加項目を明細ごとに確認
すべての注文は米ドルで表示・決済されます。実際に利用できる決済ゲートウェイは、コンソールのリアルタイム表示を確認してください。
まずレンタル期間を確認
請求期間は日、週、月、四半期の場合があります。日額から別の期間を直接推算せず、選択したモデルのカタログ価格に基づく注文内容を確認してください。
対応する決済方法は2種類のみ
USDT-TRC20、およびVisa / Mastercard / Amex(Stripe経由)に対応しています。チケットには注文番号と取引記録の非機密識別子だけを記載してください。
請求の内訳を項目ごとに確認
モデル、利用期間、対象ノード、追加ストレージの種類、Thunderbolt 5の並列数を確認します。利用可能状態はコンソールのリアルタイム表示を基準とします。
| 追加オプション | 日額 | 週額 | 月額 | 四半期額 |
|---|---|---|---|---|
| +1TB SSD | $2.6 | $7.1 | $13.2 | $35.9 |
| +2TB SSD | $5.2 | $14.2 | $26.4 | $71.8 |
| Thunderbolt 5並列接続(1台あたり) | $2 | $5.3 | $9.9 | $26.9 |
注文番号、モデル、レンタル期間、対象ノード、追加項目の名称と数量、支払い記録の非機密取引識別子を記載してください。カード番号全体、認証コード、ウォレット秘密鍵、パスワードは送信しないでください。
エンジニアがすぐ調査を始められる情報を渡す
利用中のノードに関する問題は、まずコンソールのチケットから送信してください。コンソールにログインできない場合は、support@officevps.com へメールを送信できます。
完全なチケットに含める6項目
コンソールから完全な番号をコピーし、モデル名やノードの都市名だけにしないでください。
シンガポール、日本(東京)、韓国(ソウル)、香港、米国東部、米国西部のうち、実際に注文したノードを明記します。
現地時刻とタイムゾーンを記載し、問題が継続的か断続的かも説明します。
エラー原文と前後の文脈を保存し、アカウント認証情報、秘密鍵、署名資料、その他の機密情報を隠してください。
テストしたネットワーク、クライアント、コマンド、各手順の結果を順番に列挙し、「すべて試した」だけで済ませないでください。
接続の復旧、請求の確認、runnerの再接続、具体的なビルド失敗の特定のどれを希望するか説明します。
コンソールチケット
ノード、接続、ビルド、ストレージ、請求の問題に適しています。注文情報は同じアカウント内でチケットに保持されます。
サポートメール
メールにはアカウントのメールアドレス、注文番号、問題の概要を記載します。パスワード、秘密鍵、復旧用認証情報は添付しないでください。
ナレッジ記事で解決しない場合は、状態に沿って進める
チケットの状態は現在の担当者と次の作業を示します。返信時は元のチケットに資料を追加し、同じ問題で複数のチケットを作成しないでください。
資料がキューに入りました
注文番号、ノード、発生時刻、エラー記録、実施済み手順が揃っているか確認します。不足があれば元のチケットに追加してください。
エンジニアが確認中
ノード接続、セッション状態、納品記録、請求内訳を確認する場合があります。この段階では環境を繰り返し変更せず、新しい変数が現状を上書きしないようにしてください。
再テスト可能な情報が必要です
チケットの依頼に従ってログ、画面、ネットワーク比較、クライアントバージョンを追加します。関連部分だけを提出し、機密項目は引き続き隠してください。
復旧を確認して結果を記録
元のワークフローで再テストを1回行い、実際の原因、有効だった手順、環境バージョンを記録して、チームの今後の対応基準として残します。
専用物理ホストを選び、ビルド環境を適切なノードへ配置
3種類のApple Silicon構成で、軽量ビルド、日常開発、並列CI、ローカルモデル推論に対応します。決済はUSDT-TRC20とVisa / Mastercard / Amex(Stripe経由)のみで、すべて米ドル(USD)で精算されます。