事実の確認から切り分ける

納品・接続・ビルドの問題を実行可能な手順に分解

まず物理ノード、構成、利用期間、認証情報を確認し、ネットワーク、開発環境、ジョブログを調べます。各手順に入力、確認ポイント、完了基準があり、初回利用、日常のビルド、障害切り分けに対応します。

クラウドMacを今すぐレンタル コンソールでチケットを送信

接続方法を確認する場合は、まずリモートアクセス手順をお読みください。既存の注文については、チケットに注文番号とノードコードを添付してください。

タスク搭乗前チェックボード BUILD SUPPORT / 04
切り分け手順を準備済み
入力 確認 復旧
マシンとノード 構成、リージョン、利用期間を注文と照合
まず確認
アカウントとセッション アドレス、システムアカウント、ワンタイム認証情報を分けて保存
次に接続
ツールチェーンとrunner バージョン、ラベル、並列数、キャッシュ、終了後のクリーンアップ
その後実行
タイムラインとログ タイムゾーンを統一し、障害前後の重要な記録を抜粋
切り分けに活用
完了基準 再現可能で、境界が説明でき、ログの機密情報がマスキング済み
6つの入口

問題が発生した段階から確認ルートを選ぶ

いきなり環境を再インストールしないでください。問題が納品、接続、ツールチェーン、タスク実行、データ入出力、請求のどこで起きているかを先に判断すると、不要な変更を大幅に減らせます。

01

初回納品

ノード、マシン構成、システムアカウント、アクセス認証情報、利用期間、セキュリティ設定を確認します。

完了基準：注文内容とマシンの事実が一致 02

リモート接続

アドレスへの到達性、ポートポリシー、アカウント状態、ネットワークの揺らぎ、キーボード配列、セッション復元を順に確認します。

完了基準：安定して再接続・入力できる 03

開発環境

Xcode、コマンドラインツール、証明書、プロビジョニングプロファイル、依存関係キャッシュ、プロジェクトディレクトリの権限を記録します。

完了基準：ローカルとリモートのベースラインを比較できる 04

CI/CD

runnerの登録、ラベルルーティング、並列数の上限、キャッシュディレクトリ、シークレット注入、タスク後のクリーンアップを確認します。

完了基準：タスクを再現でき、環境が混在しない 05

ストレージ

システムディスク、プロジェクトディレクトリ、ビルドキャッシュ、チームストレージを分け、容量、権限、同期状態を先に確認します。

完了基準：データパスと移行責任が明確 06

請求

モデル、利用期間、ノード、SSD追加、Thunderbolt 5の並列接続台数を確認し、対応する請求項目と照合します。

完了基準：各料金を構成まで追跡できる
納品前の6項目

初回ログイン前に納品ベースラインを保存

ベースラインは、その後の変化が注文、システム設定、プロジェクトのツールチェーンのどこに由来するかを判断するために使います。確認時は必要な情報だけを記録し、パスワード、秘密鍵、完全なトークンをチーム文書に書き込まないでください。

ノード

リージョンと接続先を確認

注文のSG、JP、KR、HKノードコードを確認し、納品アドレスを記録します。ノードはアクセス経路に影響しますが、ネットワーク問題を隠すためにプロジェクトの依存関係を変更しないでください。

確認ポイント
注文ノードと納品ノードが一致
記録項目
ノードコード、テスト元ネットワーク
構成

チップ、メモリ、ディスクを確認

システム情報で、注文に対応するM4またはM4 Pro、メモリ容量、システムディスク容量を確認します。外付けまたは追加ストレージはマウント先を別途記録します。

確認ポイント
構成が注文と項目ごとに一致
記録項目
チップ、RAM、SSD
システムアカウント

管理者アカウントとタスク用アカウントを分ける

初期システムアカウントでログインできることを確認し、自動化タスクには最小権限のアカウントを設定します。日常のrunnerに不要な高権限を長期間与えないでください。

確認ポイント
ログインでき、用途に合った権限がある
記録項目
アカウントの役割。パスワードは記録しない
アクセス認証情報

初回利用後にワンタイム認証情報を更新

リモートアドレス、システムユーザー名、セッション認証情報を別々に保存します。更新後に一度ログアウトして再接続し、新しい認証情報が想定どおり有効になることを確認します。

確認ポイント
古い認証情報が無効で、新しい認証情報で再接続できる
記録項目
変更日時と実施者
利用期間

開始・終了時刻とチームのタイムゾーンを統一

利用期間の開始・終了時刻をプロジェクトカレンダーに登録し、使用するタイムゾーンを明記します。長時間タスクでは、期限前に保存、成果物の同期、環境のクリーンアップを行う時間を確保します。

確認ポイント
チームメンバー全員が同じ時刻を確認できる
記録項目
開始・終了時刻、タイムゾーン、担当者
セキュリティ設定

入口を先に絞り、ツールをインストール

共有アカウント、リモートアクセス範囲、ディレクトリ権限、鍵の保存場所を確認します。インストールスクリプトはレビュー可能にし、機密変数はタスク実行時だけ注入します。

確認ポイント
最小権限とアクセス境界が明確
記録項目
許可する送信元、ディレクトリ、ローテーション責任
重要用語

8つの用語を先に統一し、コミュニケーションの行き違いを減らす

これらの用語は、リソースの帰属、接続方法、ビルド環境を表します。問題を送信する際は対応する名称をそのまま使うと、サポート担当者が問題の層を判断しやすくなります。

物理ノード
クラウドMacを搭載する実際のデバイスとそのリージョン。SoarMacが提供するのは指定ノード内のApple Silicon物理マシンであり、抽象化された共有コンピュートインスタンスではありません。
専有
利用期間中、マシンリソースは1つの注文で使用し、他の注文とシステム環境を共有しません。チーム内ではアカウント、ディレクトリ、タスク権限を別途設計してください。
非仮想マシン
システムは対応する物理マシン上で直接動作します。性能やデバイス能力を切り分ける際は、仮想マシンのスペック概念ではなく、実際の構成、実行中のタスク、ストレージ状態を先に確認します。
VNC
macOSのグラフィカルインターフェースにアクセスするリモートセッション方式。画面操作や目視確認に適していますが、ファイル同期と同じものではなく、自動化タスクのログの代わりにもなりません。
self-hosted runner
チームのCI/CDプラットフォームに登録し、クラウドMac上で実際にタスクを実行する実行環境。明確なラベル、並列数制限、作業ディレクトリ、終了後のクリーンアップ規則が必要です。
ビルドキャッシュ
再ダウンロードや再コンパイルを減らすために保持する依存関係や中間成果物。キャッシュには識別可能なキー、容量上限、無効化条件を設定し、プロジェクトのソースファイルと混在させないでください。
署名環境
署名検証に必要なツールバージョン、証明書、プロビジョニングプロファイル、権限、タスク変数の集合。取得元とローテーション責任を記録し、通常のログに機密情報を出力しないでください。
セッション認証情報
リモートセッションを確立するためのアドレス、ユーザー名、一時認証情報。プロジェクトキーやコードリポジトリトークンとは別の情報であり、分けて保存・ローテーションします。
CI/CD接続

runnerを一度だけでなく、繰り返し実行できる状態にする

接続順序は登録、ルーティング、レート制限、キャッシュ、シークレット、クリーンアップで固定します。Xcode、依存関係、署名素材を変更するたびに、同じ最小パイプラインで再検証します。

01

runnerを登録

プロジェクトまたは組織で指定された登録方法で実行環境を作成し、runner名、所属範囲、サービスの起動方法を記録します。完了後、機密変数を使わない診断タスクを先に実行します。

02

ラベルを設計

ラベルには少なくともシステム、チップ系列、Xcodeベースライン、用途（ビルド、テスト、メディア処理など）を示します。汎用ラベルで高負荷タスクが軽量キューに誤ルーティングされないようにしてください。

03

並列数を制限

まず単一タスクでCPU、メモリ、ディスク書き込み、DerivedDataディレクトリを確認し、段階的に並列数を増やします。揺らぎが発生したら、最終的な失敗コードだけでなくキュー長とタスクのタイムラインを保存します。

04

キャッシュディレクトリを分割

依存関係キャッシュ、ビルド中間成果物、エクスポートファイルを別々に保存します。キャッシュに容量上限、キー規則、クリーンアップ条件を設定し、古いアーキテクチャやツールチェーンの成果物が誤って再利用されないようにします。

05

シークレットを注入

機密変数はタスク実行中だけ環境に追加し、ログではコマンドエコーを無効化して読み取り可能なタスクを制限します。検証に失敗したら変数の存在を確認し、変数の内容そのものは出力しません。

06

タスク後にクリーンアップ

終了時に一時ファイルを削除し、一時マウントを解除し、残存プロセスを終了して短期認証情報を消去します。前段が失敗してもクリーンアップは実行し、レビュー可能な結果コードを残します。

最小検証タスク ツールバージョン → 依存関係の取得 → コンパイル → テスト → 概要のエクスポート
保存するもの runnerラベル、コミット識別子、タスク時刻、終了コード、機密情報を除いたログ
ログに入れてはいけないもの パスワード、秘密鍵、完全なトークン、署名素材の原文
開発環境のベースライン

まずバージョンを記録し、環境差異かプロジェクトの問題かを判断

リモートでのビルド失敗が、必ずしもマシンの異常を意味するわけではありません。ツールバージョン、依存関係の解決、ディレクトリ権限、署名素材を分けて検証し、実際に変化した層を特定します。

Xcodeバージョンの確認

完全なバージョン、ビルド番号、現在の選択パスを記録します。パイプラインではバージョンを明示的に選択し、GUIとコマンドラインで異なるツールチェーンが呼び出されないようにします。

コマンドラインツール

コンパイラ、パッケージマネージャー、スクリプトインタープリターの実際のパスを確認します。インストール画面だけでバージョンを判断せず、タスクログには機密情報を含まないバージョン概要を出力します。

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

有効範囲、用途、読み取り権限を確認します。ログには識別子と確認結果だけを記録し、証明書の秘密情報は出力しません。ローテーション後に最小限の署名検証を1回実行します。

依存関係キャッシュ

キャッシュキーには依存関係ロックファイル、ツールバージョン、アーキテクチャ情報を含めます。説明できないコンパイル差異がある場合は、プロジェクトデータをすべて削除せず空のキャッシュで検証します。

プロジェクトディレクトリの権限

runnerがソース、キャッシュ、エクスポートディレクトリにそれぞれ必要な権限を持つことを確認します。1つのディレクトリの問題を全体の権限緩和で解決せず、所有者の変更を記録します。

ストレージパス

システム、プロジェクト、キャッシュ、納品ファイルを分けて管理

ディスクの問題は、パスの混在、キャッシュ容量の無制限、権限のずれ、同期未完了が原因になりがちです。まずデータがどの層に属するかを確認し、削除、拡張、移行を判断します。

システムディスク

稼働用の余裕を確保

空き容量を継続的に確認し、ビルド中間成果物がシステムの稼働容量を圧迫しないようにします。システムディレクトリをチーム共有の成果物リポジトリにしないでください。

プロジェクトディレクトリ

所有者を明確にする

ソースと設定は固定のタスクアカウントで管理します。ディレクトリ移行後は、権限、シンボリックリンク、スクリプト内の絶対パスを再確認します。

ビルドキャッシュ

無効化条件を設定

プロジェクト、アーキテクチャ、ツールバージョンごとにキャッシュを分け、容量と保持期間のクリーンアップルールを設定します。古い成果物が新しいタスクに影響しないようにします。

納品ファイル

同期後にクリーンアップ

エクスポート成果物の完全性を確認してからチームストレージに同期します。利用期間の終了前に移行を完了し、引き継ぎ記録を残します。

接続の切り分け手順

一度に1つだけ条件を変え、結果を記録

まずローカルネットワークと宛先アドレスを確認し、その後認証とセッションの層に進みます。画面、キーボード、クリップボードはセッション体験の問題であり、アドレスに到達できない問題と同じ手順で扱わないでください。

リモート接続のよくある問題：確認手順とチケット用証拠
現象 最初の手順 次の手順 復旧しない場合に保存する情報
セッションを確立できない ノード、アドレス、ローカルネットワークが利用可能か確認し、社内ネットワークポリシーによる遮断を除外します。 既知の正常なネットワークに切り替えて再テストし、アカウントと接続パラメーターを同時に変更しないでください。 ノード、発生時刻、送信元ネットワーク、エラー原文、連続テスト結果。
画面が遅延する 解像度と色品質を下げ、ローカルからの大容量アップロードを一時停止します。 異なるネットワークで往復遅延と揺らぎを比較し、問題が継続するか確認します。 ノード、解像度、ネットワーク種別、遅延サンプル、問題発生時間帯。
キーボード配列が異常 ローカル入力メソッド、セッションのキーボード配列、システムの地域設定を確認します。 プレーンテキストエディタで修飾キー、記号キー、ショートカットをテストします。 ローカルシステム、キーボード配列、異常なキー、再現手順。
クリップボードが同期しない セッションツールでクリップボード転送が許可されていることを確認し、短いプレーンテキストでテストします。 セッションを再確立してから再テストし、大容量ファイルやリッチテキストのコピーから始めないでください。 セッションツール、内容の種類、方向、再現可能な最小テキスト。
再接続に失敗する 古いセッションを完全に終了し、接続が解放されるまで待ってから、同じアドレスで再試行します。 システムアカウントが有効か確認し、短時間に連続して接続を開始しないでください。 切断理由、再試行間隔、エラー原文、最後に成功した時刻。
認証情報が無効 最新のシステムユーザー名とセッション認証情報を使用していること、古い記録と混在していないことを確認します。 権限のある担当者が、直近の変更とローテーション時刻を確認します。 注文番号、ノード、ユーザー名、無効になった時刻。パスワードは添付しないでください。
大容量ファイルの転送が中断 検証と再開に対応したファイル同期手順を使い、クリップボードに依存しないでください。 送信元と送信先のファイルサイズおよび検証結果を比較します。 ファイルサイズ、転送方向、開始時刻、失敗段階、検証概要。
リモートアクセス手順を詳しく見る サポートチームに連絡
サービス目標

99.9% 稼働率目標をイベント記録で確認

すべてのノードを年間365日稼働させ、定期的な停止時間は設けません。異常が発生した場合、コンソールのタイムラインに開始時刻、影響範囲、復旧過程、終了時刻を記録します。補償の適用条件と算定方法はサービス規約に準拠します。

コンソールでイベントのタイムラインを確認 サービス規約を見る
直近90日間 30日間の確認ウィンドウ×3
実際の記録はタイムラインに基づく
D−90 — D−61

日ごとのステータス、異常開始時刻、影響範囲

D−60 — D−31

復旧対応、段階的な更新、ノード範囲

D−30 — D−1

終了時刻、継続時間、追加説明

算定根拠
影響を受けたサービスの記録と注文タイムライン
申請窓口
コンソールチケット
提出資料
注文番号、ノード、時刻、影響の説明
請求の確認

合計金額から逆算せず、構成項目ごとに1行ずつ照合

注文料金は、マシンクラス、利用期間、ノード、SSD追加、Thunderbolt 5の並列接続台数で構成されます。期間や追加項目を変更するたびに、注文概要を再確認してください。

A

マシンと利用期間

まずSoarMac M4 Air、SoarMac M4 Plus、SoarMac M4 Proのいずれかを確認し、日額、週額、月額、四半期の期間を確認します。

B

ノードと追加項目

SG、JP、KR、HKノード、および+1TB SSD、+2TB SSD、Thunderbolt 5の並列接続台数を確認します。

C

決済記録

すべての料金はUSDで決済され、USDT-TRC20とVisa / Mastercard / Amex（Stripe経由）のみ利用できます。実際に利用可能な決済ゲートウェイはシステムの表示に従います。

3つのプランと料金を見る
送信前の準備

最初のチケットから切り分けに必要な情報をそろえる

「使えない」とだけ書くと、切り分けが情報の追加依頼で止まります。以下の順序で事実を伝え、ログからパスワード、秘密鍵、完全なトークン、署名素材を削除してください。

01
注文番号

モデル、利用期間、納品記録の関連付けに使用します。決済情報は添付しないでください。

02
ノード

SG、JP、KR、HKのいずれかと、接続時のおおよそのネットワーク地域を明記します。

03
発生時刻

タイムゾーン付きの時刻を使い、初回発生、直近の再現、最後に正常稼働した時刻を記載します。

04
再現手順

初期状態から、入力、操作、期待結果、実際の結果を順に説明します。

05
機密情報を除いたログ

エラー原文、終了コード、前後のコンテキストを残し、パスワード、秘密鍵、完全なトークン、個人データを削除します。

技術的な問題

まずコンソールチケットを利用

既存の注文、接続障害、構成確認、サービスイベントは注文記録に関連付けられるため、コンソールでタイムラインを継続的に補足するのに適しています。

コンソールへ移動
購入前の相談と個別判断

お問い合わせページで背景情報を整理

プラン選定、大量導入、ワークフロー評価、注文に関連付けられない問題については、support@soarmac.comを利用するか、お問い合わせページの案内に従って情報を準備してください。

お問い合わせページを開く

タスクを準備し、適切な物理ノードを選択

3つのApple Silicon専有物理マシンプランはすべて非仮想マシンで、シンガポール、東京、ソウル、香港のノードで利用できます。注文前にワークロード、メモリ、ストレージ、利用期間、接続経路を確認してください。

プランを選んで注文 チームに相談