デバイスの状態
ログインコンソール注文に対応するデバイスへアクセスできることを確認し、正しいインスタンスを表示しているか確認します。古い注文のスクリーンショットにあるアドレスは再利用しないでください。
このガイドは、すでにデバイス情報を取得している開発者向けです。まずノード、ホストアドレス、ローカルネットワークを確認してからVNCセッションを確立します。接続後は画面、キーボード、クリップボードを調整し、ネットワークの問題をホスト障害と取り違えないようにします。
リモート接続でよくある誤りは、デバイスの状態、アドレス、ローカルネットワークを確認しないままクライアントを何度も切り替えることです。次の順番で確認すれば、アカウント、ネットワーク、画面の問題を分けて対処できます。
ログインコンソール注文に対応するデバイスへアクセスできることを確認し、正しいインスタンスを表示しているか確認します。古い注文のスクリーンショットにあるアドレスは再利用しないでください。
デバイスがシンガポール、東京、ソウル、香港、米国西部のどのノードにあるか確認します。地域をまたぐ経路は、入力の応答性と画面更新に直接影響します。
アドレスを1文字ずつ確認し、ポート、スペース、説明文まで一緒にコピーしないでください。アドレスが変わった場合は、コンソールに現在表示されている情報を使用します。
接続アカウントとパスワードは、信頼できるデバイスでのみ入力してください。接続認証情報をコードリポジトリ、グループチャットのスクリーンショット、公開チケット、共有ドキュメントに保存してはいけません。
安定した有線ネットワーク、または電波状態の良いWi-Fiを優先し、上り帯域を使い切る同期タスクを一時停止します。ローカルネットワークがリモート接続を遮断していないことも確認してください。
以下ではmacOSクライアントを例に説明します。各ステップを完了するたびに結果を確認し、アドレス、認証、画面設定の間を行き来しないでください。
コンソールで対象デバイスの詳細を開き、ノード、ホストアドレス、接続アカウントを記録します。チームで複数のデバイスを管理している場合は、まず注文番号とデバイスタグを照合します。
確認:注文、ノード、デバイスタグが一致macOSの画面共有クライアントを開き、アドレス欄にコンソールで提供されたホストアドレスを入力します。プロジェクト名、ノード、デバイスタグなど、識別しやすい名前を付けます。
確認:クライアントがアドレスエラーをすぐに表示せず、接続を開始するデバイスに対応する接続アカウントとパスワードを入力します。初回接続時はホスト情報を確認し、コンソールの記録と一致しない場合は操作を停止してアドレスを再確認してください。
確認:認証に成功し、対象デバイスに入れるデスクトップ要素の読み込みを待ち、マウス、キーボード、ウィンドウのドラッグ、クリップボードを順にテストします。その後ターミナルを開いてホスト名を確認し、別のデバイスで誤ってコマンドを実行しないようにします。
確認:画面、入力、クリップボード、ホスト名がすべて正しい高解像度、多言語キーボード、マルチディスプレイは、リモートデスクトップの変動要因を増やします。調整時は一度に1つの設定だけを変更し、変更前後の入力遅延と画面の鮮明さを記録してください。
初回接続では低めの解像度を使って経路の安定性を確認し、その後段階的に上げます。文字がぼやける場合は、まずクライアントの拡大率を調整し、リモート解像度とローカル表示倍率を同時に変更しないでください。
ローカルの入力ソースとリモート側のレイアウトが一致しているか確認します。中日韓入力では英数・日本語切り替えと候補ウインドウを重点的に確認し、欧州キーボードではOption、AltGr、バックスラッシュ、記号キーのマッピングを確認します。
まず1行のプレーンテキストを双方向コピーし、その後複数行のコマンドをテストします。パスワード、秘密鍵、マスキング前の設定をクリップボードで転送しないでください。大容量ファイルには管理された転送手順を使用します。
まず1台のディスプレイで接続検証を完了してから、2台目の画面を追加します。黒帯、倍率の不一致、カーソルのずれが発生した場合は単一画面に戻し、主画面と副画面の配置を再確認してください。
下表は相対的な距離を比較するためのもので、すべてのユーザー回線で固定的に得られる結果ではありません。数値はローカル通信事業者、国際経路、Wi-Fi品質、測定時間帯の影響を受けます。注文前に実際のネットワークで再測定できます。
| アクセス都市 | シンガポール | 東京 | ソウル | 香港 | 米国西部 |
|---|---|---|---|---|---|
| 上海 | 73 ms | 48 ms | 55 ms | 34 ms | 142 ms |
| 深圳 | 42 ms | 66 ms | 72 ms | 21 ms | 151 ms |
| 台北 | 58 ms | 31 ms | 46 ms | 37 ms | 126 ms |
| 大阪 | 78 ms | 18 ms | 35 ms | 61 ms | 113 ms |
| ソウル | 89 ms | 37 ms | 9 ms | 67 ms | 128 ms |
| シンガポール | 8 ms | 72 ms | 86 ms | 39 ms | 168 ms |
| ロサンゼルス | 176 ms | 112 ms | 128 ms | 151 ms | 24 ms |
ハイライト値は、今回のサンプルで各アクセス都市から最も低かった中央値を示します。VNCの操作感はジッター、パケットロス、上り帯域幅にも左右されるため、1回のPingだけでノードを選ばないでください。
専用物理マシンはリソースを分離できますが、接続の安全性はアカウント、認証情報、操作習慣にも左右されます。チームでは操作者ごとに追跡可能なアクセス境界を設定してください。
注文番号、ノード、発生時刻、macOSバージョン、クライアントバージョン、再現手順、マスキング済みエラーログ。
パスワード、秘密鍵、完全な接続認証情報、リポジトリキー、マスキングされていない設定ファイルを公開の連絡先に送ってはいけません。
まず発生時刻と現在の症状を記録し、最も確認しやすい条件から調べます。各確認が終わるたびに1回再試行し、どの変数が接続に影響したかを特定できるようにします。
リモートデスクトップとself-hosted runnerは同時に使用できますが、同じ専用物理Macのプロセッサ、メモリ、ディスク、ネットワークを共有します。チームで監視指標と操作範囲を明確にしてください。
大容量ファイルのコピー、依存関係のインストール、グラフィック操作を開始する前に、プロセッサ、メモリ、ディスク容量、ネットワーク使用量を確認し、実行中のビルドがないか確認します。
手動デバッグでrunnerが使用中のワークスペースを直接変更しないでください。一時検証には独立したディレクトリを作成し、クリーンアップスクリプトが別タスクのファイルを削除しないようにします。
ビルド実行中は、重要なプロセスの終了、キャッシュの一括削除、ツールチェーンバージョンの切り替え、デバイスの再起動を不用意に行わないでください。変更が必要な場合は、まず新しいタスクのキュー投入を停止します。
異常の発生時刻、対象リポジトリ、runnerタグ、タスク番号、手動操作を記録します。タイムラインにより、問題がネットワーク、リソース競合、環境変更のどれに起因するか判断しやすくなります。
サポートガイドにツールのバージョン、作業ディレクトリ、runnerタグを記録してください。接続に問題が残る場合は、発生時刻、ノード、クライアントバージョン、マスキング済みログを保管し、コンソールのチケットまたはサポートメールでチームに連絡してください。
support@globemini.com