このページでは、リモートデスクトップ、SSH、コードリポジトリ、セルフホステッドRunner、ファイル転送を実際の接続順に説明します。まずノードと認証情報を確認し、問題が起きたら症状ごとに切り分けます。強制電源断を通常の解決策にしないでください。
アクセス先、アカウント名、一時認証情報、ノードコードが同じ注文に紐づいていることを確認します。
まず1つのクライアントだけで接続し、複数端末の同時接続や古いキャッシュの影響を切り分けます。
初回ログイン後すぐに更新し、新しい認証情報をチームで承認された安全な保管ツールに保存します。
SSH公開鍵を登録し、Xcodeコマンドラインツールを確認してから、自動化用Runnerを登録します。
注文通知メールとコンソールには同じ納品情報が表示されます。接続前に注文番号、ノードコード、アクセス先、アカウント名を確認してください。内容が一致しない場合は古いアドレスを繰り返し試さず、コンソールからチケットを送信します。
完全なGUI、Xcodeプロジェクト操作、クリエイティブソフトにはリモートデスクトップを使用します。スクリプト実行、ビルド状態の確認、小規模なファイル転送だけならSSHを優先してください。不要なGUIセッションを減らすと、低速なネットワークでの操作負荷を抑えられます。
| 接続方式 | 適した作業 | 接続前の準備 | クライアント設定 | セッション終了 |
|---|---|---|---|---|
| VNCリモートデスクトップ | Xcode GUI、シミュレータ確認、Logic Pro、Final Cut Pro、通常のデスクトップ操作 | アクセス先、ポート、アカウント名、現在の認証情報を確認し、同じアカウントの重複セッションを閉じる | まず自動画質とシステム解像度を使用し、低速時は色深度とフレームレートを段階的に下げる | プロジェクトを保存してアプリを終了し、システムセッションから正常にログアウトする。ファイル書き込み中のタスクを直接終了しない |
| macOSシステムレベルのリモートアクセス | チームで統一したクライアント、固定解像度の作業環境、長時間のデスクトップ作業 | クライアントが対象プロトコルに対応していることを確認し、必要なネットワークポートをローカルファイアウォールで許可する | ホスト名には納品されたアドレスを入力し、アカウント名はそのまま使用する。初回接続時にホストの確認情報を確認する | エクスポート、圧縮、同期を停止してからログアウトする。クライアントウィンドウを閉じるだけではバックグラウンドプロセスは終了しない |
| SSHコマンドライン | リポジトリ操作、ビルドスクリプト、Runner管理、ログ確認、自動化タスク | 公開鍵を登録し、秘密鍵が管理下の端末だけに保存されていることを確認して、ノードのホストフィンガープリントを記録する | ユーザー名、ホストアドレス、ポートを明示する。自動化スクリプトには適切なタイムアウトと終了コードの確認を設定する | 対話セッションを終了する前にフォアグラウンドタスクの完了を確認する。長時間タスクは管理対象プロセスまたはRunnerに任せる |
セッション終了の順序：ファイルを保存し、書き込みタスクを停止し、アプリを終了して、デスクトップセッションからログアウトします。バックグラウンドビルドを続ける場合は、開いたままのデスクトップウィンドウではなく、Runnerまたは管理対象プロセスに引き継がせます。
個人のリモートデスクトップアカウント、SSHキー、CI/CD Runnerで同じ長期認証情報を共有しないでください。権限を分けると、ビルド失敗の原因を特定しやすく、メンバー変更時もアクセスを個別に取り消せます。
管理下の作業端末で新しい鍵を生成するか既存の鍵を選び、公開鍵を対象アカウントの認証済みキー一覧に登録します。秘密鍵をノードにアップロードしたり、メールやチケットに貼り付けたりしないでください。
ssh -i ~/.ssh/team_build user@assigned-host現在のリポジトリだけを対象にするアクセストークンまたはデプロイキーを優先します。初回取得後にリモートアドレスを確認し、機密パラメータを含むURLをシェル履歴やビルド出力に残さないでください。
git clone <repository-url>
git remote -v現在のツールチェーンのパスとバージョンがプロジェクト要件を満たすことを確認します。バージョンを切り替えたら再確認し、チーム文書の想定値だけでなく、ビルドスクリプトから実際に使用したツールチェーンを出力させます。
xcode-select -p
xcodebuild -version
swift --versionチップ、ノード、タスク種別など、分かりやすいRunnerラベルを付けます。1台あたりの同時実行数を制限し、作業ディレクトリにクリーンアップポリシーを設定して、メンバーの離脱やプロジェクト終了後に登録トークンを取り消します。
./config.sh --labels apple-silicon,macos,build
./run.shプロジェクトファイル、キャッシュ、ビルド成果物は用途別に異なるディレクトリへ保存します。ワークスペースと一時キャッシュを混在させると、容量不足の判断が難しくなり、クリーンアップ時にプロジェクトファイルを誤削除するリスクも高まります。
ネットワーク、クライアント、認証情報、ノード設定を同時に変更しないでください。各回で1項目だけ変更し、時刻、エラー内容、結果を記録します。そうすればチケット送信時に、サポート担当者が確認済みの手順から続けられます。
まずローカルネットワークから他のHTTPSサービスにアクセスできることを確認し、次にホストアドレスとポートを確認します。プロキシや企業ネットワークポリシーを一時的に無効にして比較テストを行い、クライアントが古いセッションキャッシュを使い続けていないことを確認してください。
解像度、色深度、フレームレートを下げ、大容量アップロードを一時停止して、有線と無線の結果を比較します。SSHが正常でデスクトップだけ遅い場合は、グラフィックエンコードとクライアント設定を優先的に確認してください。
アカウント名の大文字小文字と貼り付け時の空白を確認し、初回納品時の一時値を使い続けていないか確認します。短時間に繰り返し試行せず、コンソールで注文状態を確認してチケットを送信し、サポート担当者にアカウント状態を確認してもらいます。
ワークスペース、ビルドキャッシュ、シミュレータデータ、アーカイブ、ダウンロードの各ディレクトリを個別に確認します。保持する成果物を先に移動し、再生成可能なキャッシュを削除してください。出所不明のシステムディレクトリを直接削除しないでください。
終了コードと失敗した手順を保持し、Runnerサービス、ツールチェーンのパス、空き容量、リポジトリ権限を確認します。同じコミットで最小タスクを1回再実行してから、環境の問題かプロジェクトスクリプトの問題かを判断します。
すべてのノードは365日、年間を通じて正常に稼働します。システム更新、プロジェクト依存関係の変更、ユーザーによる再起動は、チームがタスク状況に応じて実施してください。ノードが完全に応答しなくなった場合は、サポート担当者がノードを確認します。
Runnerが新しいタスクを受け付けないようにし、書き込み完了を待ってデスクトップ上のプロジェクトを保存し、macOSから正常に再起動します。再接続後、時刻、ネットワーク、ディスク、ビルドサービスを確認してください。
SSHに接続できる場合は、電源を直接切らないでください。リモートデスクトッププロセス、ディスク容量、システム負荷を確認し、最後に正常終了したセッションの時刻を記録します。
注文番号、ノードコード、発生時刻、ネットワーク比較結果を送信します。サポート担当者がまずノードの電源、ネットワーク、システム状態を確認し、復旧操作が必要か判断します。
ファイルシステムへの書き込み中、ビルド成果物のアーカイブ中、キャッシュデータベースの更新中に電源断を繰り返すと、問題が拡大する可能性があります。操作のたびに状態が戻るまで待ち、操作時刻を記録してください。
コンソールのチケットは注文済みの接続、ノード、請求に関する問題に適しています。メールは未注文の構成相談に適しています。どちらの経路でも、秘密鍵、完全なアクセス認証情報、未加工の業務データを送信しないでください。
2つの構成、6つのノード、すべての期間料金を公開しています。注文前に、タスクのメモリ、ストレージ増量、接続地域を基準に選択できます。