初回接続、VNCセッション、Xcodeビルド、注文に関する操作ガイドです。ローカルネットワーク、ノードの状態、接続情報、クライアント、タスクログを順に確認し、手当たり次第の再試行を避けます。
6つの入口を同時に表示しています。入口を選ぶと該当する確認項目へ移動しますが、他のガイドは非表示になりません。
ローカルネットワーク、接続先アドレス、クライアントバージョン、セッション使用状況から確認します。
接続の問題解決へ 認証情報：アドレス、アカウント名、認証情報が同じ注文のものか確認し、余分な空白のコピーを避けます。
初回利用の手順を確認 パフォーマンス：ネットワーク遅延、デスクトップ画質設定、タスクのリソース状況を分けて記録し、1つの結論にまとめません。
確認の順番を見る 注文：注文番号、請求期間、米ドル額、支払い結果を準備してから、コンソールチケットを送信します。
サポート手順を見る ストレージ：選択した追加項目、システムの認識結果、マウントパス、問題が初めて発生した時刻を記録します。
依頼情報を準備 ビルド：バージョン、ラベル、作業ディレクトリ、ログ全文、最小再現手順を保存します。
ビルドの問題解決へ各手順には明確な確認結果があります。前の手順が通らない場合は、状況を保存してから進み、複数の変数を同時に変更しないでください。
コンソールにログインして該当する注文を開き、ノードが接続可能になっていること、リージョンが購入時の選択と一致することを確認します。
サーバーアドレス、アカウント名、接続認証情報を別々にコピーします。項目をまとめて保存したり、公開文書やチャットで共有したりしないでください。
信頼できるVNCクライアントに接続先アドレスとアカウント名を入力し、まず既定の画質で接続します。その後、実際のネットワークに合わせて解像度と色品質を調整します。
macOSのグラフィカルインターフェースに入ったら、キーボード入力、表示倍率、ターミナル起動、プロジェクトディレクトリへのアクセスを確認してから、リポジトリを同期するかrunnerを起動します。
問題がローカル、接続先情報、認証情報、クライアント、既存セッションのどこで起きているかを先に判断します。各結果を記録すると、連続して再接続するより原因を特定しやすくなります。
| 順番 | 確認対象 | 具体的な操作 | 記録する内容 | 合格条件 |
|---|---|---|---|---|
| 01 | ローカルネットワーク | 既知の安定したネットワークに切り替え、ファイアウォールやプロキシがVNC接続を遮断していないことを確認します。 | ネットワークの種類、プロキシの有無、失敗時刻 | 同じネットワークから接続先アドレスに到達できる |
| 02 | 接続先アドレス | 現在の注文からサーバーアドレスを再コピーし、古いスクリーンショットや別注文の保存アドレスは使いません。 | 注文番号、ノードのリージョン、アドレスの取得元 | アドレスが現在のノード記録と一致 |
| 03 | 接続認証情報 | アカウント名と認証情報を別々に確認し、コピー前後に空白や改行がないか確認します。 | エラー文。実際のパスワードは送信しない | クライアントが認証エラーを返さない |
| 04 | クライアントバージョン | クライアント名、バージョン、表示設定を記録し、必要なら別の信頼できるクライアントでも検証します。 | クライアントバージョン、OSバージョン、画質設定 | 同じ情報で安定したセッションを確立できる |
| 05 | セッション状態 | 既存セッションの使用、画面のフリーズ、クライアントに残った無効な接続がないか確認します。 | 切断前の操作、再接続時の状況、セッション時刻 | 古いセッションを閉じると再接続できる |
入力遅延、画面更新の遅さ、ビルドタスクの所要時間は異なる3つの指標です。ネットワーク条件、VNC画質設定、タスクログをそれぞれ記録し、すべてをノード性能のせいにしないでください。
失敗時の状況を保存してから、最小再現を作ります。以下6項目は同じ失敗タスクから取得し、異なる時刻のログを混在させないでください。
Xcodeの完全なバージョン、コマンドラインツールの選択結果、タスクが実際に実行したビルドコマンドを記録します。
確認ポイント 同じプロジェクトが固定バージョンで繰り返し失敗するか。失敗手順の前後のコンテキストを保存し、最後のエラー1行だけを切り出さないでください。
確認ポイント エラーが依存関係、コンパイル、テスト、エクスポート、スクリプトのどの段階で発生したか。タイムゾーン、開始時刻、失敗時刻、タスクの継続時間を記録し、ノード記録と照合できるようにします。
確認ポイント 問題が特定の手順、または一定時間経過後に集中するか。ワークフローが想定したラベルに一致することを確認し、作業ディレクトリ、キャッシュディレクトリ、実行アカウントを記録します。
確認ポイント タスクが正しいself-hosted runnerにルーティングされているか。関係のないスクリプトと並列タスクを取り除き、最少のコマンドで同じエラーを再現します。
確認ポイント 失敗が現在のプロジェクト設定、キャッシュ、環境変数に依存するか。同じノードのクリーンな作業ディレクトリで再テストするか、最小サンプルで同じツールチェーンを実行します。
確認ポイント 最小サンプルも失敗した場合は、ノード環境の問題としてチケットを送信します。特定のブランチ、依存関係、キャッシュ、スクリプトだけが失敗し、クリーンなサンプルは実行できる。
複数の独立したプロジェクトが同じツール手順で失敗し、最小サンプルも安定して再現する。
明確な用語を使うと、「マシン」「インスタンス」「サーバー」の混用による確認の往復を減らせます。
処理可能な依頼には、注文の背景、発生時刻、エラー全文、試した手順が必要です。機密性の高い認証情報は調査資料に含めません。
注文記録の特定に使います。モデル名だけでは不十分です。
シンガポール、日本・東京、韓国・ソウル、香港、米国東部、米国西部のいずれかを明記します。
BookAMini M4 CoreまたはBookAMini M4 Plusを記入します。
ノード記録と照合できるよう、日付、時刻、タイムゾーンを含めます。
原文をコピーし、エラーコードとコンテキストを保持します。「使用できない」とだけ書かないでください。
実行順に列挙し、各手順の結果を説明します。
毎回発生するのか、断続的なのか、特定のプロジェクトやネットワークだけで起きるのかを説明します。
既存注文の問題は、注文、ノード、追加記録を関連付けられるコンソールチケットを優先してください。コンソールにログインできない場合は、サポートメールを利用します。
コンソールでチケットを作成し、該当する注文を選択して、リージョン、モデル、時刻、エラー文、ログ抜粋、再現手順を添付します。
サポート担当者が証拠にもとづいて問題の範囲を判断します。情報が不足している場合は、追加が必要な項目をチケットに示します。
新しいログを追加する際は、新たな発生時刻とテスト条件を明記します。同じ問題で複数のチケットを作成しないでください。
コンソールで対応状況、推奨操作、確認が必要な結果を確認します。検証が完了したら、元の記録で復旧したか確認します。
BookAMini M4 CoreとBookAMini M4 Plusは、いずれもクラウドMacの専有物理マシンで、仮想マシンではありません。注文は米ドルで決済され、利用可能状態はコンソールのリアルタイム表示を基準とします。