画面操作
グラフィカルデスクトップ
初回のシステム確認、Xcodeの実行、署名資材の処理、ビルド画面の確認、手動確認が必要な作業に適しています。
- 入力
- ホストアドレス、アカウント、一時認証情報
- 確認
- 画面が鮮明で、キーボード、マウス、クリップボード設定が正しい
接続・移行ガイド
ローカル開発フローをクラウドMacへ安全に移行
PingMiniはクラウドMac専用物理マシンを提供します。作業方法に応じてグラフィカルデスクトップ、SSH、自動化タスクを選び、コード、ツールチェーン、ビルド設定を移行しましょう。各手順で入力、操作、確認結果を示します。
- 3つの経路
- グラフィカルデスクトップ、SSH、自動化タスク
- 4種類の移行対象
- コード、ツールチェーン、署名資材、CI設定
- 1つの原則
- まず検証し、その後に段階的に移行
接続オーケストレーション票
ローカルMac → クラウドMac
実行待ち
対象ノード
SG / JP / KR / HK / US-E
提供対象
専用物理マシン
デスクトップ
解像度とキーボードレイアウトを確認
確認：画面、入力、クリップボード設定が想定どおり
接続
SSH
ホストフィンガープリントを確認し、鍵をテスト
確認：非対話コマンドが正しいホスト情報を返す
検証
移行
リポジトリと依存関係ロックファイルを同期
確認：クリーン環境でビルドを再現できる
再現
CI
実行ノードを登録してプローブタスクを実行
確認：ログ、成果物、終了コードを追跡できる
提供
接続情報は注文確認結果に準拠します
PLAN → CONNECT → VERIFY
アクセス経路を選択
タスクを確認してから接続方法を決める
3つの方法は併用できますが、初回開通時にすべての入口を一度に設定することはおすすめしません。まず最小限の接続検証を完了し、その後に自動化やチーム連携の権限を追加します。
コマンドライン
SSH
リポジトリ同期、依存関係のインストール、ログ収集、スクリプト実行、低帯域環境に適しています。長期的に共有するパスワードではなく、原則として鍵を使用します。
- 入力
- ホストアドレス、ユーザー名、公開鍵
- 確認
- フィンガープリントを確認済みで、非対話コマンドが安定して返る
継続実行
自動化タスク
CI/CD、セルフホスト型タスク実行、定期ビルド、テストの一括実行に適しています。専用の実行アカウント、作業ディレクトリ、取り消し可能な認証情報を使用します。
- 入力
- ランナー設定、最小権限、作業ディレクトリ
- 確認
- タスクの終了コード、ログ、成果物の場所を追跡できる
初回グラフィカル接続
まずセッションを作業可能な状態に整える
初回接続の目的は、すぐにプロジェクトをすべて移すことではありません。ホスト、表示、入力、データ交換の境界を確認し、項目ごとに結果を記録します。
セッション確認リスト
GRAPHICAL SESSION
STEP 01–04
-
01
ホスト一致
ホスト情報を確認
注文に記載されたノード、モデル、ホストアドレス、アカウント名を1つずつ確認します。過去の記録だけで接続したり、旧プロジェクトのアドレスを新しい注文にそのまま使ったりしないでください。
-
02
セッション安定
初回セッションを確立
信頼できるネットワークから接続します。初回ログイン後は、システム情報、タイムゾーン、ディスク容量、ネットワーク状態を確認し、機密情報のインポートを急がないでください。
-
03
表示鮮明
表示設定を調整
ローカル画面と回線状況に合わせて解像度を選びます。文字がぼやける場合はまず拡大率を確認し、操作に遅延がある場合は先に画質を下げます。すぐにホスト性能の異常と判断しないでください。
-
04
入力制御
入力範囲を検証
日本語・英語入力、よく使うショートカット、キーボードレイアウトをテストします。クリップボードの双方向同期が許可されているか確認し、機密情報を共有クリップボードに長時間残さないでください。
接続前
接続トラブルシューティングを見る
ローカル確認記録を用意
接続元ネットワーク、クライアントバージョン、対象ノード、開始時刻を記録します。後で遅延や切断が発生した場合、ローカル回線の問題かリモートセッションの問題かを切り分けやすくなります。
接続後
モデル構成を確認
先に検証し、コピーは後に行う
小規模なテストプロジェクトを実行し、コンパイル、ログ、出力ディレクトリが正常であることを確認します。検証後に、大規模リポジトリ、メディア素材、署名関連ファイルを移行します。
SSH初期設定
検証可能で取り消し可能なコマンドライン経路を構築
鍵、ホストフィンガープリント、アカウント権限は分けて管理します。手間を省くために、長期利用の秘密鍵、プロジェクト鍵、チーム共有認証情報を同じディレクトリに置かないでください。
ローカル実行
専用鍵を生成して用途を登録
現在のデバイスと共同作業者ごとに専用鍵を生成します。ファイル名からデバイスと用途が分かるようにし、鍵のコメントには必要な識別情報だけを記載します。プロジェクト機密は書きません。
ssh-keygen -t ed25519 -a 64 -f ~/.ssh/pingmini_dev
chmod 600 ~/.ssh/pingmini_dev
ssh-add ~/.ssh/pingmini_dev秘密鍵は管理下のローカルデバイスに保管し、提出するのは公開鍵だけにします。チームメンバーがプロジェクトを離れたら、該当する公開鍵を削除します。共有認証情報全体を置き換える必要はありません。
リモート検証
フィンガープリントを確認してから非対話コマンドをテスト
初回接続時に表示されるホストフィンガープリントを、信頼できる情報源の情報と照合します。確認後、読み取り専用コマンドでホストの身元とコマンド実行経路を検証します。
ssh -i ~/.ssh/pingmini_dev user@host
ssh -i ~/.ssh/pingmini_dev user@host \
'sw_vers && uname -m && whoami'想定結果にはmacOSのバージョン、arm64 アーキテクチャ、正しいアカウント名が含まれます。結果が一致しない場合は移行を停止し、注文情報と接続情報を確認してください。
アカウント権限を制限
自動化アカウントにはタスクに必要な権限だけを付与します。対話用アカウントとCIアカウントを分け、スクリプトが不要な個人ディレクトリへアクセスできないようにします。
ホスト設定を固定
ローカルのSSH設定で専用エイリアスと指定鍵ファイルを使用し、無関係な認証情報の試行を無効にします。別の秘密鍵を誤って使う可能性を減らせます。
終了コードをテスト
コマンド出力だけでなく、スクリプトの終了コードも確認します。自動化システムは終了コードで成功と失敗を判定するため、ログの最終行だけで判断してはいけません。
移行ロードマップ
移行を個別に確認できる3つの経路に分ける
ローカルMacからクラウドMacへの移行は、ディスク全体のコピーではありません。まずデータを移し、次にツールチェーンを再現し、最後にCIへ接続します。各経路で入力リストと確認証跡を残します。
01
データ移行
プロジェクトに必要なデータだけを移す
- 入力
- コードリポジトリ、必要な素材、設定テンプレート、データベースのエクスポート、依存関係ロックファイル。
- 操作
- まずリポジトリを再クローンします。大容量ファイルは分割して検証し、機密設定は管理された経路で個別に配置します。
- 確認
- リポジトリの状態がクリーンで、重要ファイルのチェックサムが一致し、プロジェクトディレクトリにローカルの一時キャッシュがない。
02
ツールチェーンの再現
バージョンリストに沿って環境を再構築
- 入力
- Xcodeのバージョン、コマンドラインツール、パッケージマネージャーの一覧、SDK要件、依存関係ロックファイル。
- 操作
- まず基本ツールをインストールし、その後に依存関係を復元します。旧マシンのグローバルキャッシュや派生データディレクトリをそのままコピーしないでください。
- 確認
- 同じコミットをクリーンなディレクトリでビルドでき、テストバージョン、コンパイラバージョン、成果物情報を記録できる。
03
CI接続
ノードをタスクオーケストレーションに組み込む
- 入力
- ランナー登録情報、作業ディレクトリ、並列実行ポリシー、キャッシュルール、成果物の提供先。
- 操作
- 専用の実行アカウントでノードを登録し、まず短時間のプローブタスクを実行します。その後、テスト、アーカイブ、リリース準備のフローを段階的に接続します。
- 確認
- タスクを開始、キャンセル、回収でき、ログを検索できる。失敗したタスクがリソースを占有するバックグラウンドプロセスを残さない。
開発環境の移行
リストで環境を再現し、旧マシンの不要物はコピーしない
移行完了の基準は、ファイル数がローカルデバイスと完全に同じになることではなく、同じコミットを新しい環境で安定してビルドできることです。
依存関係に沿って段階的に復元
コードリポジトリ
信頼できるリモートから再クローンし、ブランチ、サブモジュール、大容量ファイル参照、未コミット変更を確認します。
依存関係ロックファイル
プロジェクトで使用するロックファイルとバージョン宣言を同期し、新しいマシンで依存関係が意図せず更新されるのを防ぎます。
Xcodeとコマンドラインツール
実際のバージョン、選択した開発者ディレクトリ、SDK要件を記録し、完全なビルドをもう一度実行します。
証明書とプロビジョニングプロファイル
プロジェクトに必要な資材だけをインポートし、管理者、用途、取り消し手順を明確にします。自動化アカウントのアクセス範囲も制限します。
ビルドとテスト結果
コミット番号、ツールバージョン、タスク所要時間、終了コード、成果物の場所を移行確認記録として保存します。
同期すべきもの
目標：説明可能、再現可能、取り消し可能
ビルド結果を決める入力
リポジトリ、ロックファイル、設定テンプレート、スクリプト、必要な素材、署名資材、明確なバージョン要件。各項目の入手元と用途を把握しておきます。
コピーを避けるもの
原則：まず再構築し、不足時だけ補う
再生成できるキャッシュ
派生ビルドディレクトリ、パッケージマネージャーのキャッシュ、シミュレーターの一時データ、過去のログ、無関係なダウンロードファイル。これらをコピーすると互換性問題が拡大します。
セッションの安全性
アクセス権を開始と終了のあるタスクとして扱う
リモートセッション、SSH鍵、CI認証情報には、明確な担当者、用途、取り消し時期を設定します。作業の終了はウィンドウを閉じるだけではありません。アクセスを回収し、残ったデータも削除します。
専用の強力な認証情報を使用
共同作業者ごとに専用の入口を用意します。同じアカウントや同じ鍵を複数人で共有せず、メンバー変更時にアクセスを正確に取り消せるようにします。
イベント発生時に鍵をローテーション
デバイス交換、メンバー離脱、プロジェクト引き継ぎ、認証情報の漏えいが疑われる場合は、一定期間の終了を待たずに直ちにローテーションします。
共有アカウントを制限
対話操作、自動化実行、管理タスクには別々のアカウント境界を使用し、CIタスクが不要な個人ディレクトリ権限を得ないようにします。
引き継ぎとクリーンアップを完了
利用期間の終了前に必要な成果物をエクスポートし、プロジェクト認証情報を取り消し、機密ファイルを削除します。共同作業者の入口が回収されたことも確認します。
共同作業の開始
担当者、用途、権限を登録
タスクに必要な入口だけを開放し、対応する公開鍵または実行アカウントを記録します。
共同作業中
異常なログインと残存タスクを確認
送信元、時刻、タスク動作に異常がある場合は、まずアクセスを一時停止し、必要なログを保存します。
共同作業の終了
入口を取り消し、機密データを削除
古い鍵で接続を継続できないことを確認し、プロジェクト資料が引き継ぎ要件に沿って処理されたことを確認します。
接続トラブルシューティング
注文からクライアントログまで、層ごとに問題を切り分ける
アドレス、ネットワーク、認証情報、クライアント設定を同時に変更しないでください。一度に1つの層だけを検証し、エラー原文と発生時刻を残すことで、原因特定を早められます。
-
01
注文レイヤー
注文ステータスを確認
サービスの提供が完了し、現在の利用期間が有効で、モデル、ノード、注文内容が一致していることを確認します。実際の利用可能状態は、コンソールのリアルタイム応答を基準にします。
-
02
アドレス指定レイヤー
ホストアドレスを確認
アドレス、ポート、アカウント名を1文字ずつ確認し、過去の接続履歴を使わないようにします。アドレスが変わった場合は、ローカルエイリアスと自動化設定も更新します。
-
03
ネットワークレイヤー
ローカルネットワークポリシーを確認
信頼できる代替ネットワークに切り替えて比較し、ローカルファイアウォール、企業出口ポリシー、プロキシ設定、DNS解決が接続に影響していないか確認します。
-
04
認証レイヤー
認証情報とホストフィンガープリントを検証
正しい鍵とアカウントを使用していることを確認します。フィンガープリントに異常がある場合は検証を回避せず、接続を停止して信頼できる情報源のホスト情報を確認します。
-
05
サービスレイヤー
システムサービスを確認
SSHは利用できるのにグラフィカルセッションが利用できない場合は、それぞれのサービス状態を確認します。グラフィカルセッションは利用できるのにスクリプトが失敗する場合は、Shell、パス、権限を確認します。
-
06
証跡レイヤー
クライアントログを収集
発生時刻、クライアントバージョン、エラー原文、再現手順、完了した確認項目を保存します。サポート依頼には「接続できない」だけを書かないでください。
開始前の準備
構成を選び、このチェックリストで接続を完了
3つの固定構成で、軽量ビルド、日常開発、大規模モデル推論に対応します。注文後は注文確認情報に従って物理ノードへ接続し、開発環境を段階的に移行します。