エンジニアリングサポートマニュアル

クラウドMacを接続から安定稼働まで導く

認証情報の確認、VNCリモートデスクトップ接続、環境移行、ビルド診断を実際の作業順に進められます。各手順で確認結果と次の対応を示し、問題を曖昧なままにしません。

対象ユーザー
専用物理Mac mini
通常の納品
約4分
サポート方法
コンソールチケットまたはメール
RUN / CONNECT-01

初回接続チェックリスト

実行可能
認証情報を取得済み コンソールのインスタンス詳細
01
ネットワーク到達確認済み 宛先アドレスとポートに接続可能
02
デスクトップに接続済み VNCセッションにmacOSのグラフィカルインターフェースが表示される
03
受け入れ確認結果

モデル、メモリ、ストレージが選択したノードと一致してから、プロジェクトとビルドキャッシュを同期します。

問題から選択

6つのヘルプテーマから操作手順を直接確認

現在の状況に最も近いテーマを選択してください。接続できない場合は認証情報とネットワークから、ビルドに失敗した場合は環境とログから確認します。注文とノードの状態はコンソールで最新結果を確認できます。

初回接続ガイド

接続を確認してからプロジェクトを移行

リポジトリ、モデル、メディア素材を同期する前に、4つの確認を完了することをおすすめします。納品、ネットワーク、プロジェクト環境の問題を切り分けて対応できます。

  1. 01

    コンソールから現在の認証情報を取得

    インスタンス詳細を開き、ノード番号、モデル、VNCアドレス、ポート、ユーザー名、仮パスワードを確認します。古いチケットや過去のスクリーンショットにある接続情報は使用せず、完全な認証情報を他人に転送しないでください。

    ノード番号が注文内容と一致している アドレスとポートが現在のインスタンスのもの 認証情報に余分なスペースがない
  2. 02

    VNCリモートデスクトップに接続

    信頼できるネットワークで対応するVNCクライアントを開き、コンソールに表示されたアドレスとポートで接続します。ハンドシェイクに失敗した場合は、まずローカルネットワーク、プロキシ、ファイアウォール、宛先ポートを確認し、誤ったパスワードを連続して試さないでください。

    ローカルネットワークから外部サービスに正常アクセスできる プロキシが宛先ポートを書き換えていない クライアントに現在のアドレスが保存されている
  3. 03

    アカウントのセキュリティ設定を変更

    グラフィカルインターフェースに初めて入ったら、すぐに仮ログインパスワードを変更し、画面ロック、自動ログイン、リモートアクセスの設定がチームのルールに沿っていることを確認します。チームで利用する場合は、承認済みメンバーごとに追跡可能なローカルアカウントを作成してください。

    仮パスワードを変更済み 画面ロックポリシーを確認済み 承認済みメンバーの範囲を記録済み
  4. 04

    システムと注文構成を確認

    macOSのバージョン、M4チップ、メモリ、ストレージ容量、空きディスク容量、システム時刻、ネットワーク出口を確認します。SureVM M4 CoreはM4、16GB、256GB、SureVM M4 PlusはM4、24GB、512GBと表示されます。

    チップとメモリが選択プランと一致している ディスク容量が追加オプションと一致している 時刻とネットワーク状態が正常
移行パス

ローカルMacからクラウドMacへの3段階移行

移行の目的は古いマシン全体をコピーすることではなく、検証可能で再利用できる作業環境を再構築することです。必要なデータを同期し、ツールチェーンを再現してから自動化タスクに接続します。

01 データ同期

プロジェクトに必要なデータだけを移行

コードリポジトリ、設定テンプレート、必要な素材、再利用できることを確認したキャッシュを優先して同期します。大容量ファイルは先に圧縮するか分割して転送し、一度に同期してディスクを使い切らないようにします。

  • バージョン管理でコードとサブモジュールを取得
  • 機密変数は個別に注入し、リポジトリにはコミットしない
  • 素材、モデル、ビルド成果物の保存パスを記録
  • 同期後に重要ファイルの数とハッシュ値を検証
納品結果 プロジェクトデータを読み取れ、ディレクトリの境界が明確
02 ツールチェーンの再現

バージョン一覧に沿って開発環境を再構築

まずXcode、コマンドラインツール、言語ランタイム、パッケージマネージャーのバージョンを確認してから、プロジェクトの依存関係をインストールします。出所を追跡できない旧マシンのグローバルディレクトリをそのままコピーしないでください。

  • XcodeとCommand Line Toolsのバージョンを固定
  • Ruby、Node.js、Python、Javaのバージョンを記録
  • ロックファイルからCocoaPods、SwiftPM、npmの依存関係を復元
  • クリーンビルドを1回実行し、完全なログを保存
納品結果 同じコミットを新しいノードで安定してビルドできる
03 CIへの接続と検証

ノードを追跡可能なキューに追加

Runnerに専用の作業ディレクトリと必要最小限の権限を設定し、キャッシュのクリーンアップ方針を定めます。テストブランチで取得、ビルド、アーカイブ、ログ返送を検証します。

  • Runnerがアクセスできるリポジトリと実行アカウントを制限
  • キャッシュディレクトリとビルド成果物ディレクトリを分離
  • 失敗したタスクが終了コードとログを返せることを確認
  • ノード番号、タスク番号、コミットハッシュを記録
納品結果 自動化タスクを再現、特定、引き継ぎできる
XcodeとCI

ビルドに失敗したら証拠に沿って調査

すべてのキャッシュを消去したり、ツールを再インストールしたりする前に、失敗ログを保存します。証明書、署名、Keychain、Runner権限、キャッシュ、具体的なエラーを順に確認して範囲を絞ります。

署名チェーン

証明書、プロビジョニングプロファイル、Keychain

  1. 証明書の用途と有効状態を確認

    ビルド対象で使用する証明書の種類、チーム設定、有効期限を確認し、開発環境とリリース環境を混在させないようにします。

  2. 署名設定の参照元を確認

    プロジェクト設定、ビルドパラメータ、CI環境変数が同じ署名方針を指しているか確認します。

  3. Keychainにタスクからアクセスできることを確認

    対話型ログインで使えても、バックグラウンドのRunnerで使えるとは限りません。Runnerの実行アカウントでロック解除と読み取り権限を検証します。

実行環境

Runnerの権限、キャッシュ、ログ

  1. Runnerの実際の実行アカウントを確認

    作業ディレクトリ、Shell、PATH、読み書き権限を確認します。リモートデスクトップの対話型ターミナルだけで検証しないでください。

  2. 依存関係のキャッシュと派生データを分離

    CocoaPods、SwiftPM、npm、DerivedDataの保存先を明確にし、問題のあるキャッシュだけを対象に削除します。

  3. 最初の完全な失敗ログを保存

    タスク番号、コミットハッシュ、Xcodeバージョン、終了コード、最初のエラーを記録し、最後の数行だけを提出しないでください。

ログを確認する順序

最初の失敗を探し、連鎖したエラーを確認

ビルドログの末尾には、その後に発生した失敗が大量に含まれることがあります。最初のゼロ以外の終了コード、最初の署名エラー、最初の依存関係解決エラーから確認し、タスク開始時刻と照合して本当の原因を判断します。

01 タスクのコンテキスト

ノード番号、タスク番号、コミットハッシュ、ブランチ。

02 環境のコンテキスト

macOS、Xcode、ランタイム、依存関係のバージョン。

03 失敗のコンテキスト

最初のエラー、終了コード、関連コマンド、時刻。

MLXと開発環境

実験環境を現在のセッションだけでなく再構築可能にする

Python環境、モデルファイル、パラメータ、出力記録を分けて管理します。ディスク使用量を管理しながら、依存関係を更新した後も実験の差分をすばやく比較できます。

環境実行ランブック

推奨ディレクトリと記録の境界

ENV
Python環境を分離

プロジェクトごとに独立した仮想環境を使用し、Pythonのバージョンを固定して、依存関係一覧をプロジェクトのバージョン管理に含めます。

DEP
依存関係のインストール

ロックファイルから依存関係をインストールし、MLXと主要ライブラリのバージョンを記録します。更新前に環境一覧とベースライン結果をコピーしてください。

MODEL
モデルファイルを管理

モデル、量子化バージョン、一時ダウンロードディレクトリを分けて保存します。出所、ハッシュ値、ディスク使用量を記録し、重複コピーを避けます。

RUN
実行記録を保存

各実験でコミットハッシュ、パラメータ、依存関係のバージョン、入力概要、所要時間、出力パスを保存します。機密性のある生データは記録しません。

開始前

ディスク容量を確認

モデルファイル、仮想環境、キャッシュ、出力が同時に容量を使用します。ダウンロード前に空き容量を確認し、中間ファイル用の余裕を確保してください。

  • モデルディレクトリには必要なバージョンだけを残す
  • キャッシュの削除周期を明確に設定
  • 結果をアーカイブしてから中間ファイルを削除
変更後

最小サンプルで検証

依存関係やモデルを変更した後は、固定入力の小さなサンプルを実行します。終了コード、出力構造、リソース使用量を比較してから、完全なタスクに戻します。

  • 変更前後の環境一覧を保存
  • 失敗したコマンドと最初のエラーを記録
  • 出力パスに書き込み可能で、容量が十分あることを確認
接続診断ツリー

認証情報からノード状態まで段階的に切り分け

各段階では1つの質問だけに答えます。前の段階を通過するまで次の段階に進んでソフトウェアを再インストールしないでください。不要な変更を減らし、チケット用の明確な証拠を残せます。

01
認証情報

アドレス、ポート、ユーザー名、パスワードは現在のインスタンスのものですか?

未通過の場合

コンソールのインスタンス詳細を再度開き、現在の接続情報を手動でコピーします。先頭と末尾のスペース、古いクライアントの記録を確認してください。

02
ネットワーク

ローカルネットワークから宛先アドレスとポートに到達できますか?

未通過の場合

トラフィックを書き換えるプロキシを一時的に無効にし、社内の外部接続ポリシーを確認して、別の信頼できるネットワークでも検証します。

03
リモートデスクトップサービス

ネットワークには到達できるが、VNCセッションがハンドシェイク段階で失敗していませんか?

未通過の場合

クライアント名、バージョン、エラー原文、発生時刻を記録し、誤った認証情報を繰り返し送信しないでください。

04
システム負荷

接続済みなのに画面が遅い場合、高負荷タスクがリソースを占有していませんか?

確認が必要

CPU、メモリ、空きディスク容量、実行中のビルドまたは推論タスクを確認し、不要なキューを一時停止してから再テストします。

05
ノード状態

コンソールは現在のインスタンスが正常稼働中であることを返していますか?

状態に異常がある場合

タスクを自分で何度も再起動しないでください。ノード番号、コンソールの状態、発生時刻、前述の確認結果を記録してチケットを送信します。

サービス状態の確認基準

リアルタイムの結果はコンソールの表示を基準にする

すべてのノードは年間365日の正常稼働を前提に設計されています。インスタンスの状態、接続結果、ローカルでの確認内容が一致しない場合は、具体的なノードと時間帯をサポートチームに送って確認を依頼してください。

まず記録
ノード番号と発生時刻
次に照合
コンソールの状態とローカルでの現象
最後に送信
機密情報を除いたログと再現手順
サポート依頼を送信

サポートチームが問題を直接再現できるようにする

完全なチケットには対象、時刻、操作、結果を記載します。まずログ内のリポジトリアドレス、トークン、秘密鍵、個人データ、業務内容をマスキングしてください。

TICKET / REQUIRED

チケットに必要な5項目

マスキングして送信
NODE
ノード番号と地域

コンソールに表示されたノード番号を記入し、シンガポール、日本(東京)、韓国(ソウル)、香港、米国西部のいずれかを明記します。

MODEL
モデルと構成

SureVM M4 CoreまたはSureVM M4 Plus、および追加ストレージやThunderbolt 5の並列接続を使用しているかを記載します。

TIME
発生時刻とタイムゾーン

最初に発生した時刻、最後に再現した時刻、所在地のタイムゾーンを記載します。「たった今」や「昨日くらい」だけでは不十分です。

STEPS
最短の再現手順

正常な状態から開始し、実行した操作、入力条件、期待される結果、実際の結果を順番に記載します。

LOG
マスキング済みログとエラー原文

時刻、終了コード、エラーの前後関係を残し、パスワード、アクセストークン、秘密鍵、完全な決済情報、業務上の機密データを削除します。

注文済みのユーザー

コンソールからノードチケットを送信

コンソールチケットではインスタンス、注文、ノード状態を関連付けられます。接続、システム、請求、継続的な技術問題に適しています。

ログインしてチケットを送信
ログインできない場合または購入前の相談

サポートチームにメールを送信

返信を受け取れるメールアドレスから問題の概要を送信してください。外部向けサポートメールは support@surevm.com のみです。アカウントパスワードや秘密鍵をメールで送信しないでください。

support@surevm.com
次のステップ

問題がある場合は証拠を送信し、ノードが必要ならすぐに構成

コンソールはインスタンス管理とサポートチケットに使用します。注文ページでは、2種類のM4構成、利用期間、5つの利用可能なノードを選択できます。