接続 / ツールチェーン / 診断
このガイドは専有物理ノードへの接続を対象としています。まずノードのアドレスとシステム認証情報を確認し、SSH、VNC、Xcode、CI runnerを設定します。問題が発生した場合は、ネットワーク、認証、システム、ツールチェーン、ストレージの順に確認し、無駄な再試行を減らします。
01 / First connection
ネットワークを推測したり、先にシステムをリセットしたりしないでください。コンソールのノード情報を唯一の確認基準とし、アドレスをコピーする際はプロトコルの接頭辞、空白、ポート以外の文字を含めないでください。
現在のインスタンスのノードID、リージョン、ホストアドレス、接続ポートを確認します。リージョンは注文内容と一致している必要があります。チームでネットワーク許可リストを使用している場合は、クライアントの現在のパブリック出口IPアドレスも記録してください。
確認：NODE ID / HOST / REGION / PORT
アカウント名では大文字と小文字が区別されます。SSHコマンド、VNCログイン画面、コンソールに表示されるアカウント名を一致させ、メールアドレスをシステムユーザー名の代わりに使用しないでください。
形式：username@host
初回利用前に、認証情報がコンソールの最新バージョンであることを確認します。ログイン後はすぐに一時パスワードを変更してください。すでに変更済みの場合は、新しい値で接続します。古い値は引き続き使用できません。
操作：ログイン → 変更 → 安全に保存
macOSと一般的なLinux環境では、ターミナルをそのまま使用できます。まずポートの疎通を確認してからSSH接続を開始してください。初回にホストフィンガープリントが表示されたら、ノードアドレスを確認してから承認します。
推奨：接続タイムアウト10秒 / keepalive 30秒
VNC対応クライアントを用意し、接続先に正しいポートが含まれていることを確認します。初回接続では低めの解像度と自動画質を使用し、入力が安定してから表示設定を上げてください。
開始設定：1920×1080 / 24-bit / 自動
02 / Glossary mini
以下の用語は、注文、コンソール、接続ドキュメント、障害記録に登場します。それぞれが明確なリソース範囲または技術操作を示します。
03 / Terminal mock
ターミナル出力から、正しいノードに入れているか、Xcodeが想定したバージョンを選択しているか、ビルド成果物がパイプラインに受け取られたかを確認できます。
$ ssh -o ConnectTimeout=10 developer@node.example
Last login: Tue Mar 11 09:42:18
node: M4-Core / memory: 16GB / storage: 256GB
$ xcode-select -p
/Applications/Xcode.app/Contents/Developer
$ xcodebuild -workspace Demo.xcworkspace \
-scheme Demo -configuration Release build
Resolve Package Graph
CompileSwiftSources normal arm64
** BUILD SUCCEEDED **
$ bundle exec fastlane upload_build
[09:47:22]: Validating archive
[09:47:36]: Uploading artifact
[09:48:04]: Upload complete
[09:48:04]: Pipeline result: success例のホスト名はコマンド構造を示すためのものです。実際のアドレス、ポート、アカウント、ノードIDはコンソールの記録を確認してください。ログを収集する際はタイムスタンプと失敗したコマンドを残し、パスワード、秘密鍵、署名素材を削除します。
04 / Migration path
すべてのディレクトリを一度に移行しないでください。まずプロジェクトデータを移行し、次にツールチェーンを再現し、最後にCIへ接続します。各段階に検証可能な完了条件を設定してください。
コードリポジトリ、ビルドスクリプト、必要なリソースを優先して同期します。大容量ファイルは個別に転送し、転送前後にチェックサムを計算してください。旧マシンのキャッシュをすべて直接コピーしないでください。
Xcodeのメジャーバージョン、コマンドラインツールのパス、Rubyとfastlaneのバージョンを明確にします。署名素材は管理された手順でインポートし、ファイル権限と有効範囲を確認してください。
runner専用の作業ディレクトリとサービスアカウントを作成します。ラベルのマッチ範囲と同時実行数を制限し、キャッシュ、ログ、成果物のパスをソースコードのディレクトリから分離します。
05 / Remote desktop
リモートデスクトップの体感は帯域幅だけで決まりません。ノード遅延、解像度、色深度、フレームレート、クライアントのスケーリング、バックグラウンドのファイル転送が入力反応に影響します。
Macクライアントからグラフィカルインターフェースに入る用途に適しています。接続先にはコンソールに表示されたホストアドレスとポートを使用し、ログインアカウントはシステムアカウントと完全に一致させてください。
画面が遅れる場合は、まずバックグラウンド同期を停止し、次にリモート側の解像度を下げます。解像度、色深度、圧縮レベルを同時に変更すると、影響要因を特定しにくくなります。
クロスプラットフォームアクセスに適しています。自動圧縮を有効にし、不要なアニメーション効果を無効にしてください。画質と色深度を個別に設定できる場合は、画質を自動のままにして、先に色深度だけを下げます。
入力に明らかな遅延があるのに画面が鮮明な場合は、クライアントからノードまでの往復遅延を優先して確認します。高解像度ではネットワークの揺らぎは改善せず、エンコードと転送の負荷が増えるだけです。
| 用途 | 解像度の目安 | 色深度 | 推奨帯域幅 | 優先して調整する項目 |
|---|---|---|---|---|
| ターミナルと軽量編集 | 1600×900 | 16-bit | ≥ 8 Mbps | 動きの多い画面を減らす |
| Xcodeでのコーディングとデバッグ | 1920×1080 | 24-bit | ≥ 15 Mbps | 低遅延の経路を維持 |
| マルチウィンドウ開発 | 2560×1440 | 24-bit | ≥ 25 Mbps | まず安定性を確認 |
| 画面変化が多い作業 | 1920×1080 | 24-bit | ≥ 30 Mbps | フレームレートまたは画質を下げる |
帯域幅は設定開始点であり、遅延を保証する数値ではありません。リモートデスクトップを主に開発や管理に使う場合は、クライアントに近いノードを優先し、実際のネットワーク環境で検証してください。
06 / CI/CD
CI接続の完了条件は、一度グリーンの結果を見ることではありません。作業ディレクトリをクリーンアップした後も同じコミットを繰り返しビルドでき、失敗時にも十分なログを保持できることが重要です。
07 / Diagnosis tree
毎回変更する変数は1つだけにし、時刻、コマンド、戻り値、クライアントのネットワークを記録します。接続ボタンを繰り返しクリックしても、有効な情報は通常増えません。
08 / Security operations
専有物理マシンではリソース境界が明確になりますが、ノード内のアカウント、鍵、プロジェクトファイル、アクセス元は、チームが最小権限の原則に従って管理する必要があります。
初回ログイン後、すぐに新しい強力なパスワードを設定し、チームで承認された認証情報管理ツールに保存します。ビルドログや通常の文書でパスワードを共有しないでください。
SSHとVNCの公開範囲を、実際に必要なチームの出口IPアドレスに限定します。メンバーのネットワークが変わったらルールを更新し、テスト用のアクセス元を長期間残さないでください。
日常のビルド、リモート操作、runnerサービスには、それぞれ役割を明確にしたアカウントを使用します。インストールやシステム設定時だけ一時的に権限を昇格し、完了後はすぐに戻してください。
移行、トラブルシューティング、外部との共同作業が終わったら、一時公開鍵、短期トークン、テストアカウントを削除します。自動化スクリプトが古い認証情報を参照していないかも確認してください。
09 / Support escalation
技術的な問題は、インスタンスと関連付けてログを継続的に追加できるよう、まずコンソールのチケットから提出してください。コンソールに入れない場合や導入前の確認には、メールを利用できます。
コンソールにログインしてチケット画面を開き、新しいテクニカルサポート依頼を作成し、該当ノードを関連付けます。1件のチケットでは主な問題を1つに絞り、無関係な異常を同じ記録に混在させないでください。
メールの件名は「問題の種類 + ノードIDまたは注文識別子」とすることをおすすめします。本文には実施済みの確認内容を時系列で記載し、パスワード、秘密鍵、マスキングしていない署名素材は送信しないでください。
Ready to connect
まずノードアドレス、システムアカウント、現在の認証情報をコピーし、SSH接続を1回確認してからリモートMacデスクトップに入ります。新しい専有物理マシンが必要な場合は、固定モデルと契約期間の料金を確認できます。