エンジニア向けサポートガイド

まず問題を切り分け、クラウドMacを順番に復旧

RunAMac M4に接続・設定・運用する開発チーム向けに、実行可能な確認手順、完了の目安、問い合わせテンプレートをまとめています。情報を探して複数の回答を行き来する必要はありません。

コンソールを開く サポートチームに連絡
対象範囲
よくある6カテゴリ
導入の目安
約4分
対象ユーザー
専有物理マシン
RUNAMAC SUPPORT RUN SHEET 問題切り分けシート
先に収集、後から変更
INPUT
元のエラー出力を保存

発生時刻、ノード、コマンド、完全なエラー内容を記録し、最後の1行だけを残さないでください。

CHECK
ローカル回線からホストまで段階的に確認

ネットワーク、ポート、セッション、環境依存を個別に検証し、毎回1つの条件だけを変更します。

PROOF
再現可能な手順で結果を確認

成功の目印または失敗ログを記録し、次の担当者が同じ結果を再現できるようにします。

担当者による対応が必要な場合 注文番号 + ノード + タイムスタンプ + エラー出力 + 再現手順
すばやく検索

問題のレイヤーから確認項目を探す

現象、コマンド、管理操作を入力するか、カテゴリを選択してください。検索では最も関連性の高い内容を強調表示しますが、他の手順は非表示にしません。

接続

接続情報が見つからない、ホストIDの表示が変わった、セッションを確立できない、初期認証情報を更新したい場合。

接続手順を確認

アカウント

注文、納品記録、利用期間、チケットの状態を確認したり、アカウント内のインスタンスの所有関係を確認したりできます。

管理画面を確認

ビルド環境

Xcode、コマンドラインツール、証明書、依存関係キャッシュ、CIランナーの状態を確認します。

環境チェックリストを使用

請求

期間、追加オプション、USDでの支払額、支払い履歴、請求書のダウンロード場所を確認します。

請求の詳細を確認
初回接続

4つの確認を終えてから開発セッションを開始

接続情報はコンソールの納品記録を基準にしてください。チャット履歴や古い文書からアドレスをコピーせず、ホストIDの確認も省略しないでください。

01

今回の注文の接続情報を確認

コンソールにログインし、該当する注文とインスタンス詳細を開いて、ノード、ホストアドレス、ポート、ユーザー名、接続方法を確認します。複数の注文がある場合は、まず注文番号とノードが一致していることを確認してください。

完了の目安：アドレス、ポート、ユーザー名がすべて同じ納品記録に記載されている。
02

ホストIDを確認

初めて暗号化接続を確立すると、クライアントにホストフィンガープリントが表示されます。コンソールの記録と照合してください。接続済みなのに突然ID変更の警告が表示された場合は、接続を停止してチケットで確認します。

完了の目安：ホストフィンガープリントが現在のインスタンス記録と一致している。
03

コマンドラインまたはGUIセッションを確立

まず納品情報でセッションを確立し、キーボード入力、クリップボードのポリシー、基本的なネットワークアクセスが要件を満たすことを確認します。遅延が大きい場合は、ホスト障害と判断する前に画質を下げてください。

完了の目安：macOSのGUIまたはコマンドラインに安定して入れる。
04

初期認証情報を変更し、復旧情報を保存

接続に成功したらすぐに初期認証情報を変更し、チームで承認された認証情報管理方法で保存します。パスワード、秘密鍵、証明書の内容をビルドログ、チケット本文、コードリポジトリに記載しないでください。

完了の目安：新しい認証情報の検証に成功し、以後のセッションで古い認証情報を使用していない。
ホストIDの表示が変わってもローカル記録を上書きしない

警告画面のスクリーンショット、発生時刻、注文番号を先に保存し、コンソールのチケットで確認してください。新しいホストIDを不用意に受け入れると、重要なセキュリティ確認の機会を失います。

導入タイムライン

注文確認から接続情報の受け取りまで約4分

各ステップには確認可能な完了の目安があります。実際の進捗はコンソールの表示を基準とし、ページを更新しても送信済みの注文は変わりません。

  1. 01 約1分

    注文確認

    システムがRunAMac M4、利用期間、ノード、追加オプションを確認し、今回の注文記録を作成します。

    完了の目安：コンソールに注文番号と確定済みの構成が表示される。
  2. 02 約1分

    物理ノードを割り当て

    注文が選択したエリアの専有物理マシンに割り当てられ、機器リソースは他の利用者と共有されません。

    完了の目安：インスタンス詳細にノードと機器IDが表示される。
  3. 03 約1分

    システム初期化

    システムが基本的なアクセス環境を準備し、必要なインスタンス検査を実行します。この時点で同じ注文を再作成しないでください。

    完了の目安：インスタンスの状態が納品可能な段階になる。
  4. 04 約1分

    接続情報を納品

    コンソールにホストアドレス、ポート、ユーザー名、ホストID情報、接続手順が書き込まれます。

    完了の目安：インスタンス詳細ですべての接続項目を確認できる。
開発環境チェックリスト

再現可能な環境のベースラインを作り、ビルドタスクを接続

RunAMacは専有Mac miniと完全なmacOS環境を提供します。具体的なソフトウェア、バージョン、プロジェクト依存関係はチームでビルド基準を確認してください。注文に記載されていないソフトウェアはインストール済みとはみなされません。

A

Xcodeとアクティブな開発ディレクトリ

プロジェクトで必要なXcodeのバージョンを記録し、アクティブな開発ディレクトリがビルドスクリプトと一致することを確認します。バージョンを切り替えた後は、SDK、シミュレーターランタイム、アーカイブコマンドを再検証してください。

B

コマンドラインツール

コンパイラ、Git、Shell、パッケージ管理コマンドが利用できるか確認します。GUIでXcodeを起動できることだけを根拠に、自動ビルドの準備が完了したと判断しないでください。

C

証明書と署名素材

署名証明書、プロビジョニングプロファイル、キーチェーンアクセスのポリシーがプロジェクト要件を満たすことを確認します。機密素材は管理された手順で導入し、リポジトリ、通常のログ、チケット添付ファイルには保存しないでください。

D

依存関係とキャッシュ

依存関係ロックファイル、キャッシュディレクトリ、無効化ポリシーを個別に記録します。初回ビルドではキャッシュなしのベースラインを実行し、その後キャッシュを有効にして所要時間とヒット状況を比較します。

E

継続的インテグレーションランナー

ランナーのラベル、作業ディレクトリ、同時実行数、起動方法、ログ回収先を確認します。1台のランナーが失敗した場合は、タスクが別の環境に誤って割り当てられていないか確認してください。

ネットワークトラブルシューティングガイド

接続経路に沿って障害範囲を段階的に絞り込む

ネットワーク、クライアント、接続パラメーターを同時に変更しないでください。一度に1つだけ条件を変えることで、どの手順で復旧したか判断できます。

L1

ローカル回線を確認

ローカルネットワークから他のサービスへ安定してアクセスできることを確認し、有線、無線、予備回線を個別にテストします。継続的なパケットロス、プロキシの介入、企業ネットワークの制限がないか記録してください。

証拠：ローカル出口、テスト時刻、連続失敗回数。
L2

対象ノードを確認

コンソールから現在のインスタンスアドレスを再取得し、古い注文やノード情報を使い続けないでください。RunAMac M4ではシンガポール、日本（東京）、韓国（ソウル）、香港、米国西部を選択できます。

証拠：注文番号、ノード名、対象アドレス。
L3

ポートポリシーを検証

接続ポートが納品記録と一致することを確認し、ローカルファイアウォール、会社の出口ポリシー、セキュリティソフトによる遮断がないか確認します。テストのために保護機能を恒久的に無効化しないでください。

証拠：ポート、クライアントのエラーコード、ポリシー変更の結果。
L4

セッション状態を確認

問題が接続確立前、認証中、デスクトップ表示後のどこで発生しているか判断します。画面の遅延だけがある場合は、入力遅延と接続切断の状況を分けて記録してください。

証拠：失敗段階、継続時間、再現性。
L5

診断ログを収集

クライアントログと完全なエラー出力を保存し、タイムゾーンが明確なタイムスタンプを記録します。ログにホストアドレス、ユーザー名、パスが含まれる場合は、送信前に必要なマスキングを行ってください。

証拠：ログ抜粋、タイムスタンプ、再現手順。
チケット情報テンプレート

サポートチームがすぐに調査を開始できる情報をまとめる

項目ごとに状況を提供すると、「接続できない」だけの場合より再現しやすくなります。パスワード、秘密鍵、証明書本文、支払い認証情報はチケットに記載しないでください。

注文番号：
ノード：
問題発生時刻とタイムゾーン：
接続方法とクライアントバージョン：
完全なエラー出力：
実行済みの確認：
最短の再現手順：
期待結果と実際の結果：
ストレージとデイジーチェーン

データ量と機器の連携方法に応じて追加オプションを選ぶ

容量不足、読み書き経路の問題、複数機器の連携ニーズを切り分けます。追加オプションは選択した利用期間に応じて課金されるため、変更前にデータ移行とタスク中断のリスクを確認してください。

容量拡張

+1TB SSD

依存関係キャッシュ、複数の中規模コードリポジトリ、ビルドアーカイブ、テスト成果物を長期保存するワークフローに適しています。利用前にピーク使用量と整理方針を確認してください。

日次
$2.3
週次
$6.2
月次
$11.4
四半期
$31
大容量拡張

+2TB SSD

大量のビルド成果物、複数プロジェクトのキャッシュ、小規模AI実験データ、長期保存に適しています。容量の追加はバックアップの代わりにならないため、重要な成果物は独立したコピーも保存してください。

日次
$4.6
週次
$12.4
月次
$22.8
四半期
$62
機器のデイジーチェーン

Thunderbolt 5デイジーチェーン

1台ごとに課金され、機器間の高速接続が明確に必要な共同作業に適しています。変更を申請する前に、機器数、接続関係、データ方向、検証コマンドを明記してください。

日次
$1.9
週次
$5
月次
$9.3
四半期
$25.3

変更前に3項目を確認

01 現在の状態を記録

使用容量、実行中のタスク、保持が必要なデータパスを確認します。

02 適用期間を選択

追加オプション、現在の利用期間、コンソールに表示されるUSDの支払額を確認します。

03 変更結果を検証

完了後、マウント、空き容量、読み書き権限、タスクのパスを再確認します。

アカウントと利用期間

注文記録で利用期間、構成、請求を管理

コンソールは納品、利用期間、支払額を確認する統合画面です。複数のインスタンスを扱う場合は、変更前に必ず注文番号とノードを確認してください。

有人サポートにエスカレーション

そのまま再現できる状況を送る

技術的な問題は、まずコンソールのチケットで注文に関連付けてください。購入前の相談、提携、ログインできない場合は、問い合わせページでメール内容を作成できます。

01

注文とノード

注文番号、RunAMac M4の構成、ノードを提供します。複数のインスタンスが関係する場合は、各機器を分けて記載してください。

02

タイムスタンプ

問題の発生時刻とタイムゾーンを明記し、継続的、断続的、または一度だけ発生したのかを示します。

03

エラー出力

完全なエラーテキストを貼り付けるか、機密情報を隠したスクリーンショットを提供してください。パスワード、秘密鍵、証明書本文、その他の秘密の認証情報は送信しないでください。

04

再現手順

既知の初期状態から開始し、コマンド、入力、期待結果、実際の結果を順番に記載してください。

チケット送信後に情報を追加するには？

同じコンソールチケットに新しいタイムスタンプ、ログ、検証結果を追加し、同じ問題で複数のチケットを作成しないでください。これにより、完全な調査経路を維持できます。

チケットやメールに記載してはいけない情報は？

パスワード、秘密鍵、証明書本文、支払い認証情報、マスキングしていないプロジェクト機密情報を送信しないでください。パスやユーザー名を説明する場合も、問題の特定に必要な最小限の情報だけを残します。

コンソールにログインできない場合、チームに連絡するには？

問い合わせページで構造化されたメールを作成するか、次のメールアドレスに直接送信してください： support@runamac.com。アカウントのメールアドレス、関連する注文番号、ログインできないときに表示されたエラー情報を記載してください。

状況を整理できたら

調査記録をサポートチームに渡して対応を続ける

既存の注文はコンソールのチケットでインスタンスに関連付けてください。購入前の相談、提携、アカウントアクセスの問題は問い合わせページから同じサポートチームへ送信します。

コンソールチケットを送信 問い合わせページへ