初回接続
ノード、接続元アドレス、アクセス方法を確認し、まず自分のセッションを確立してからチームメンバーに引き継ぎます。
接続・ビルド・診断
クラウドMacを初回接続から安定運用まで、次の一手を明確に
まずアクセス経路とセキュリティ境界を確認し、Xcode、Runner、MLX、メディアワークフローを設定します。問題が起きたら、ネットワーク、認証、ディスク、ツールチェーン、プロセス資源、リージョン経路の順に切り分け、複数の変数を同時に変更しないでください。
標準の引き渡しは約4分です。ノードと注文の実際の利用可能状態は、コンソールのリアルタイム表示に従います。
SUPPORT / RUNBOOK
タスク引き渡し・診断ボード
実行手順
ビルド実行
ツールのバージョン、キャッシュディレクトリ、同時実行数の上限を固定し、XcodeやRunnerのジョブを再現可能にします。
問題の切り分け
時間範囲、エラー原文、リソース指標、再現手順を残してから、コンソールで問い合わせます。
専用Apple Silicon物理ノード
仮想マシンではありません
365日稼働
おすすめの読む順番
クイックスタート索引
5つの手順を依存関係に沿って並べています。前の手順の記録が次の手順の入力になります。チームで使う場合は、鍵のローテーションとアクセス無効化を飛ばさないでください。
-
01
注文を完了
モデル、利用期間、ノード、ストレージ追加オプションを選び、支払い後にコンソールから注文状態が返るのを待ちます。古いスクリーンショットで現在の利用可能状況を判断しないでください。
-
02
アクセス認証情報を受け取る
コンソールでインスタンス、ノード、アクセス手順を確認します。認証情報は管理対象のパスワードマネージャーだけに保存し、チャットやコードリポジトリに転送しないでください。
-
03
初回ログインを完了
信頼できるネットワークからリモートデスクトップまたはSSHセッションを確立し、初回接続時刻、クライアントバージョン、接続元のグローバルIPアドレスを記録して比較用のベースラインを作ります。
-
04
鍵をローテーション
チーム専用のSSH鍵と最小権限アカウントを作成し、新しい経路が使えることを確認してから一時アクセス情報を無効化します。先に削除して確認できなくなる事態を避けてください。
-
05
チームへの引き継ぎを完了
タスク、ブランチ、キャッシュ状態、実行中プロセス、出力先を引き継ぎます。個人の認証情報は引き継ぎません。次の担当者と、利用期間終了前のデータ搬出責任を明確にします。
接続前の準備
4つの接続経路ごとに最小限のチェック項目を用意
接続に問題があるときは、まずどの経路を使っているか確認します。リモートデスクトップ、SSH、ファイル転送、ファイアウォールの許可リストでは確認項目が異なるため、1回の調査に混在させないでください。
グラフィカルセッション
安全なリモートデスクトップ
暗号化接続に対応したクライアントを用意し、まず1つの信頼できるネットワークでテストします。クライアントバージョン、表示解像度、キーボード配列、プロキシ経由の有無を記録してください。
- 初回接続は単一ディスプレイと標準解像度で行う
- クリップボードとファイルマッピングがチームの方針に合っているか確認する
- 入力遅延が異常なときは、連続したテスト時間帯を記録する
Xcode、Final Cut Pro、GUI管理に適しています
コマンドライン
SSH
担当者ごとに専用鍵を割り当て、初回接続前にインスタンス情報を確認します。自動化ジョブには専用アカウントを使い、個人の対話セッションを再利用しません。
- 秘密鍵は管理対象デバイスに保存し、ファイル権限を制限する
- チームメンバーごとに認証済み公開鍵を管理する
- 接続に失敗したら詳細モードの出力を残すが、機密情報は削除する
自動化、ログ確認、リモートコマンドに適しています
データ転送経路
ファイル転送
大容量ファイルには再開可能なツールを優先し、入力、中間ファイル、出力を別のディレクトリに分けます。小さなサンプルで権限とディスク容量を確認してから、完全同期を開始してください。
- 転送前後にファイル数とチェックサムを確認する
- モデル、素材、ビルドキャッシュを別ディレクトリに保存する
- 実行中のキャッシュディレクトリでファイルを直接上書きしない
モデル、素材、ビルド成果物、ログの転送に適しています
アクセス境界
ファイアウォール許可リスト
確認済みの接続元グローバルIPアドレスと必要なポートだけを許可します。家庭やモバイルネットワークのアドレスが変わったら、管理されていないネットワーク範囲へ広げるのではなく、ルールを更新してください。
- オフィスネットワーク、Runner、運用出口をそれぞれ記録する
- 一時的な接続元には明確な無効化時刻を設定する
- 変更後、許可済みと未許可の接続元からそれぞれ1回テストする
固定オフィス出口と管理された自動化ネットワークに適しています
継続的インテグレーション
GitHub ActionsのセルフホストMac Runnerを回収可能なジョブにする
Runnerの安定性は、バージョン固定、同時実行の境界、キャッシュの所有範囲、ジョブ後のクリーンアップで決まります。前のタスクの状態を次のタスクの隠れた依存関係にしないでください。
ラベルには検証可能な能力だけを記載する
ラベルにはチップアーキテクチャ、Xcodeメジャーバージョン、用途、キューの境界を含めるとよいでしょう。一時的なプロジェクト名を長期的な能力ラベルにすると、プロジェクトの変化でスケジューリング規則が不正確になります。
- 登録方法
- 組織またはリポジトリ専用
- 実行アカウント
- 独立した最小権限アカウント
- 検証操作
- 機密情報を含まないテストジョブを1回実行
まず同時実行数を制限し、リソースのピークを観察する
単一ジョブのベースラインから始め、CPU、ユニファイドメモリ、ディスク書き込み、ビルド時間を個別に記録します。タスクが互いに独立し、ピーク時にも余裕がある場合だけ同時実行数を増やしてください。
- 依存キャッシュ
- ロックファイルとツールバージョンごとにキーを分ける
- 派生データ
- プロジェクトごとに分離し、クリーンアップ上限を設定する
- 同時実行の判断
- ピークリソースとキュー待ち時間を合わせて判断する
署名素材を共通キャッシュに入れない
機密素材は必要なジョブ段階でのみ注入し、完了後に一時ファイル、環境変数、バックグラウンドプロセスを削除します。失敗時も成功時も同じクリーンアップを実行してください。
- 機密素材
- 独立した権限とライフサイクル
- 失敗時の再試行
- 残留物を削除してから再キューする
- 利用期間終了
- Runner、鍵、アクセスルールを無効化する
開発環境
ツールのバージョン、インストール元、キャッシュディレクトリを追跡可能にする
まず現状を記録してからアップグレードします。継続的ビルド用ホストでは、最新への追随よりバージョンの安定性と再現性が重要です。
| ツール | 初回設定 | 日常のメンテナンス | 異常時にまず確認 |
|---|---|---|---|
| Xcode | メジャーバージョンを固定し、コマンドラインツールの選択と初回起動状態を記録する。 | アップグレード前にプロジェクト互換性の結果を保存し、DerivedDataをプロジェクトごとに分離する。 | 現在の選択パス、SDK、シミュレータ状態、ディスク空き容量、完全なビルドログ。 |
| Homebrew | 管理対象の単一アカウントでインストールし、依存関係一覧と必要なバージョン制約を保存する。 | 更新前に変更内容を確認し、ビルドジョブの実行中に依存関係を更新しない。 | パスの優先順位、ディレクトリ所有権、アーキテクチャの一致、Formulaのバージョン。 |
| Ruby | プロジェクトで宣言されたバージョンを使い、Bundlerと依存ファイルを固定する。 | 再利用可能な依存関係はキャッシュするが、互換性のないRubyバージョン間で混用しない。 | インタプリタのパス、Gemのインストール先、ロックファイル、ネイティブ拡張のビルド出力。 |
| Node.js | プロジェクトごとにランタイムとパッケージマネージャーのバージョンを固定し、ロックファイル検証を有効にする。 | 不透明な作業ディレクトリではなくダウンロード内容をキャッシュし、無効なキャッシュを定期的に削除する。 | Nodeのパス、パッケージマネージャーのバージョン、ロックファイルの差分、ネイティブモジュールのアーキテクチャ。 |
| コンテナ代替フロー | Linuxコンテナの手順は外部のLinux実行環境に移し、MacノードはmacOS専用のビルドとテストを担当する。 | スクリプトで入力と成果物の形式を統一し、プラットフォーム間の手作業による移動を減らす。 | プラットフォーム前提、ファイル権限、改行形式、アーキテクチャ、成果物の受け渡し経路。 |
| ビルドキャッシュ | プロジェクト、ブランチ方針、ツールバージョン、ロックファイルごとにキャッシュキーを作る。 | 容量しきい値と削除順序を設定し、まず再生成可能なキャッシュを削除してから作業ファイルを処理する。 | ヒット率、ディレクトリ権限、空き容量、ファイル数、同時書き込み。 |
大容量メモリ・大容量ファイルのタスク
MLX推論とメディア制作ではメモリ、ディスク、転送経路を同時に管理する
どちらのタスクもユニファイドメモリを長時間使い、大容量の出力を生成する可能性があります。開始前に入力ファイル、作業ディレクトリ、完了条件、転送方法を明確にしてください。
MLX推論
モデル保存後は小さなバッチでベースラインを取る
モデルファイル、量子化バージョン、入力サンプル、結果を識別しやすいディレクトリに分けます。まず小さなバッチを実行し、読み込み時間、ユニファイドメモリのピーク、1回の推論時間、出力サイズを記録してから、バッチサイズと同時実行数を決めてください。
- ファイル準備：モデルファイルの完全性を確認し、モデル、キャッシュ、出力に必要な容量を確保する。
- リソース観察：メモリプレッシャー、スワップ動作、ディスクの読み書き、プロセスの継続時間を同時に確認する。
- 長時間タスクの維持：再開可能なタスク管理方式を使い、段階的な進捗と中間結果を出力する。
- 結果の転送：まず一覧とチェックサムを生成してから結果を転送し、ファイル名だけで完了と判断しない。
64GBの大容量メモリタスクにはVPSGit M4 Pro：M4 Pro、64GB、2TBを検討できます。
メディア制作
プロキシ素材、プロジェクトファイル、完成品を分けて同期する
Final Cut Proをリモートで使う場合は、まず短いプロキシ素材で入力遅延、プレビューの滑らかさ、音声と映像の同期を確認します。完全な素材をアップロードする前に、ディスク空き容量と転送時間の見積もりを確認してください。
- 素材の同期：オリジナル素材、プロキシファイル、プロジェクトファイルを別ディレクトリに分け、使用中のメディアを上書きしない。
- 編集ベースライン：リモートデスクトップの解像度、ネットワーク経路、再生品質を記録し、変化を比較できるようにする。
- 書き出し管理：書き出し前に目標形式、作業用容量、命名規則を確認し、長時間の書き出しでは段階ログを残す。
- 完成品の転送：まずサンプルを転送して確認し、その後に最終ファイルと検証情報を転送し、完了後に再生成可能なファイルを削除する。
大容量素材には+1TB SSDまたは+2TB SSDを選択でき、タスク前に搬出時間を確認してください。
段階的な切り分け
一度に1つの層だけを検証し、各ステップの結果を残す
まず問題がローカル、接続経路、ノード内部のどこで起きているかを判断します。各ステップの完了時に現象が変化したか記録し、同じ調査でツールの更新、ネットワーク変更、キャッシュ削除を同時に行わないでください。
-
01
ネットワーク
同じ接続元から基本的な疎通、パケットロス、ジッターをテストし、既知の安定したネットワークでもう一度確認します。クライアントのネットワーク種別、プロキシ経由の有無、問題が発生した時間範囲を記録してください。
-
02
認証
現在承認されているアカウントと鍵を使っていることを確認し、ローカルファイル権限、権限範囲、直近のローテーション記録を確認します。認証情報の内容を問い合わせに書かないでください。
-
03
ディスク
空き容量、ディレクトリ所有権、ファイル数、大きなディレクトリが増えた原因を確認します。ビルドに失敗したら、作業用、キャッシュ、出力の各ディレクトリも同時に確認してください。
-
04
ビルドツールチェーン
Xcode、SDK、Ruby、Node.js、パッケージマネージャー、依存関係ロックファイルのバージョンを記録し、最後に成功したジョブと比較します。最初から全体更新を実行しないでください。
-
05
プロセスとリソース
CPU、ユニファイドメモリ、スワップ動作、ディスク書き込み、残った子プロセスを確認します。一時的なピーク、継続的な使用、タスク終了後に解放されない状態を区別してください。
-
06
リージョン経路
同じクライアント、同じ操作、近い時間帯で経路を比較し、異なるタスク負荷をリージョン差と誤認しないようにします。リージョン間の移行ではディレクトリを再確認し、データ転送を計画してください。
問い合わせ前の準備
再現可能な情報を1枚の診断シートにまとめる
問い合わせは影響範囲と注文状態に基づいて処理されます。情報を完全にすると確認の往復を減らせますが、鍵、アクセスパスワード、署名素材、業務データは削除してください。
- 注文番号、選択したノードとモデル
- 問題の開始時刻と継続時間
- 影響を受けた接続方法またはジョブ段階
- 再現可能な最短操作手順
- 完全なエラー原文と必要なログ部分
- 完了した確認項目と各ステップの結果
サービス稼働率の基準
99.9%サービス稼働率目標
すべてのノードは365日正常に稼働します。サービス条項で定義された集計範囲に基づいて稼働率を計算し、ユーザー自身の操作、第三者依存、制御不能な事象は条項に従って扱います。
過去90日間のステータス記録
連続する3つの30日区間で表示します。個別の事象記録と最新状態はコンソールの表示に従います。
直近30日間現在の区間
事象の確認後に記録を更新
31～60日目過去の区間
サービス事象の基準に従って保存
61～90日目過去の区間
事象の影響範囲を記録
サービスクレジット
サービス条項で定める条件を満たした場合、影響を受けた期間に応じてサービスクレジットを申請できます。申請には注文情報、影響時間帯、検証可能な現象が必要です。認定内容とクレジットはサービス条項に従います。
安全な運用
ノードへの接続から利用期間終了まで、責任者を明確にする
安全性は一度設定して終わりではありません。アカウント、権限、鍵、機密素材、バックアップ、無効化にそれぞれ確認ポイントを設け、チームへの引き継ぎ時に項目ごとに確認します。
個別アカウント
担当者ごとに識別可能なアカウントを使い、個人セッションを共有しません。自動化Runnerには手動操作とは別のサービスアカウントを使います。
確認：担当者とアカウントが1対1で対応
最小権限
現在のタスクに必要なディレクトリ、コマンド、ネットワークアクセスだけを付与します。一時権限には用途と無効化時刻を明記してください。
確認：用途のない長期的な高権限がない
鍵のローテーション
メンバー変更、デバイス紛失、権限範囲の変更後は直ちにローテーションします。新しい鍵を確認してから古い鍵を無効化し、結果を記録してください。
確認：承認済み一覧と実際の設定が一致
機密素材の削除
署名ファイル、一時トークン、環境変数、ログ内の機密部分をタスクのライフサイクルに従って削除し、共通キャッシュに入れないでください。
確認：成功時も失敗時も削除を実行
終了前のバックアップ
利用期間終了前にソースコードの変更、ビルド成果物、モデル結果、メディアプロジェクト、必要なログを搬出し、バックアップを読み取れることを確認します。
確認：バックアップ先と検証結果を記録
アクセスの無効化
タスク完了後にアカウント、公開鍵、Runner登録、許可リスト、一時共有パスを無効化し、バックグラウンドプロセスが停止したことを確認します。
確認：ノード外部の入口をすべて回収
開始準備
まずモデルとノードを選び、この運用ガイドに沿って引き渡しを完了する
3種類の専用Apple Silicon物理ノードを日単位、週単位、月単位、四半期単位で利用できます。USDT-TRC20とVisa / Mastercard / Amex（Stripe経由）に対応し、料金はすべてUSDで決済します。