タスク別サポートガイド

初回接続からビルドの問題解決まで、次の手順をタスク別に確認

DebugMacでは、仮想マシンではなく専用のApple Silicon物理ノードを提供します。認証情報、リージョン、ツールチェーンを確認し、コマンド出力から接続、ビルド、ストレージ、回線の問題を切り分けます。

クラウドMacを借りる 初回セットアップを見る
提供対象
Debug M4 専用物理ノード
接続方法
SSHとmacOS GUI
サポート窓口
コンソールのチケットとサポートメール
BREAKPOINT REVIEW DESK 診断チケット
項目別確認
CASE / BUILD-042 再現待ち

入力を固定してから実行環境を確認

ノード
JP · Debug M4
タスク
Xcode Archive
入口
SSH公開鍵
証拠
コマンド、時刻、マスキング済みログ
トラブルシューティング手順
  1. 01ホストフィンガープリントを確認接続先に変更がないことを確認
  2. 02ツールチェーンのバージョンを記録Xcodeと依存関係の入力を固定
  3. 03問題範囲を絞り込むローカル、経路、ノードセッションを切り分け
入力注文とリージョン 実行再現とサンプリング 成果物確認可能なチケット
サポート索引

6種類のタスクを同時に表示し、重要な手順をフィルターに隠さない

分類を選ぶと該当セクションへ移動して強調表示します。他のガイドも表示したままなので、タスク間の前提条件を確認できます。

初回接続

認証情報とホストフィンガープリントを確認

アドレス、ユーザー名、SSH公開鍵を準備し、フィンガープリントを確認してからCLIとGUIセッションを開始します。

日常のビルド

Xcodeとアーカイブの入力を固定

リポジトリの状態、ツールチェーン、署名を確認し、再現可能な結果に必要なバージョン情報を保持します。

CI自動化

runnerを追跡可能かつクリーンに保つ

同時実行数を制限し、キャッシュと一時ディレクトリを明示的に管理して、重要なビルド出力をパイプラインへ戻します。

ストレージ拡張

容量、マウント、並列ユニットを確認

有効化前に追加項目を確認し、提供後にディスク容量、マウントポイント、ファイルシステム、読み書き先を確認します。

ネットワーク診断

ローカル、経路、セッションを分けて確認

遅延、経路、ポート、転送テストで範囲を段階的に絞り、一度のpingだけで判断しません。

アカウント管理

実行可能なチケットに整理

注文ID、リージョン、発生時刻、再現手順、マスキング済みログを添付し、確認の重複を減らします。

SSHとGUIセッション

初回接続で接続先を確認し、信頼できる基準を保存

提供通知のアドレス、ユーザー名、ホストフィンガープリント、アクセス発行状態は同一注文に対応している必要があります。不一致がある場合は接続を停止し、コンソールのチケットで確認してください。

接続前の準備

ローカルのSSH秘密鍵、公開鍵との対応、提供通知、安定したネットワークを準備します。秘密鍵、完全な認証情報、マスキング前の設定をチケットに貼り付けないでください。

  • ローカル秘密鍵の権限が現在のユーザーだけの読み取りに制限されているか確認する。
  • 注文リージョンがシンガポール、日本（東京）、韓国（ソウル）、香港、米国西部のいずれかであることを確認する。
  • 初回接続前に、提供通知のホストフィンガープリントを個別に確認する。
  • 初回の接続成功時刻、システムバージョン、標準ディスク容量を記録する。
セットアップ手順を見る
  1. 01 認証情報を準備

    提供通知からホストアドレス、ユーザー名、フィンガープリントを確認します。秘密鍵はローカルの管理対象パスに保管し、チャットやチケットで送信しません。

  2. 02 フィンガープリントを検証

    初回SSH接続で表示されるフィンガープリントは、提供通知と一致している必要があります。接続済みのホストで突然変化した場合、ローカル記録を削除して再試行しないでください。

  3. 03 鍵ログインをテスト

    まず読み取り専用コマンドで本人確認、Apple Siliconアーキテクチャ、システム時刻、空きディスクを確認してから、リポジトリやビルドディレクトリに進みます。

  4. 04 GUIセッションを開始

    GUIセッションの認証情報、表示解像度、キーボードレイアウトを確認します。初回ログイン後、安全な切断と再接続を一度テストしてください。

  5. 05 切断に対処

    ローカルネットワークの切断、SSHポートへの到達不能、GUIセッションの切断をまず切り分けます。CLIが使える場合は、ログとタスク状態を優先して保存します。

接続失敗時にまず残す3つの証拠

ローカル時刻、完全なエラーテキスト、同じネットワークから実行したポート確認結果を記録します。認証情報を連続してリセットしないでください。問題発生時の状態が上書きされます。

Xcodeワークフロー

リポジトリ、ツールチェーン、アーカイブ設定をまとめて固定

同じコミットでも、Xcode、依存関係ロックファイル、署名入力が異なると結果が変わる場合があります。トラブルシューティングでは入力を固定し、複数の依存関係を同時に更新しないでください。

01

リポジトリを取得

コミットハッシュ、ブランチ、サブモジュールの状態、依存関係ロックファイルを記録します。ワークツリーに未コミットの変更がないことを確認してから、基準ビルドを開始します。

02

ツールチェーンを選択

次のコマンドで xcode-select -p と xcodebuild -version 現在の開発者ディレクトリとXcodeバージョンを記録します。

03

署名入力を確認

プロジェクトのチーム、Bundle ID、構成名、署名方式を確認します。ログに証明書の詳細が含まれる場合は、先にマスキングしてください。

04

アーカイブを実行

workspaceまたはproject、scheme、configuration、archivePathを明示し、完全な終了コードとログを保存します。

05

成果物をダウンロード

アーカイブ完了後、ファイルサイズ、チェックサム、出力ディレクトリを確認し、チームで定めた安全な場所へコピーします。

ビルド基準コマンド 機密値にはサンプルの代称を使用 
git rev-parse HEAD
xcode-select -p
xcodebuild -version
xcodebuild -workspace "<WORKSPACE>" \
  -scheme "<SCHEME>" \
  -configuration Release \
  -archivePath "<OUTPUT>/App.xcarchive" \
  archive | tee "<LOG_DIR>/archive.log"

成功条件

終了コードが0で、アーカイブディレクトリが存在し、成果物のサイズが想定どおりで、ログに見落とされた署名またはスクリプトエラーがないこと。

失敗の切り分け

依存関係の解決、コンパイル、リンク、署名、スクリプト、エクスポートの各段階を順に判断し、すべてを「Xcodeビルド失敗」とまとめないでください。

証拠を提出

コミットハッシュ、Xcodeバージョン、実行コマンド、終了コード、失敗段階、マスキング済みログの抜粋を提供します。秘密鍵や完全な認証情報はアップロードしないでください。

CI/CD自動化

self-hosted runnerの各実行に明確な境界を設ける

GitHubやGitLabなどのパイプラインからmacOSタスクを専用ノードへルーティングできます。ノードの実行環境は他テナントと共有しませんが、同一チームのタスクでは同時実行、キャッシュ、クリーンアップの管理が必要です。

同時実行

単一タスクの基準から開始

まず1本のパイプラインが完全に成功することを確認し、その後段階的に同時実行数を増やします。複数のビルドが同じDerivedData、キーチェーン、出力ディレクトリへ同時に書き込むと、相互汚染が起こりやすくなります。

  • 各タスクで独立した作業ディレクトリを使用する。
  • シミュレーターとアーカイブのパスにタスクIDを含める。
  • CPU、メモリ、ディスクのピーク値、待ち時間を記録する。
キャッシュ

キャッシュには検証可能なキーを付ける

依存関係のキャッシュキーには少なくともロックファイルの要約、ツールチェーンのバージョン、アーキテクチャを含めます。キャッシュヒット後も依存関係の完全性を確認し、古いキャッシュを正しい結果とみなさないでください。

  • 依存関係キャッシュとビルド中間成果物を分けて管理する。
  • ツールチェーン切り替え後は新しいキャッシュキーを生成する。
  • ヒット、フォールバック、再構築にかかった時間を記録する。
クリーンアップ

タスク終了時に一時状態を回収

成功・失敗にかかわらずクリーンアップ段階を実行します。返送が必要なログと成果物を保持し、一時鍵、作業ディレクトリ、不要になったシミュレーター状態を削除します。

  • クリーンアップにはfinallyまたは同等の仕組みを使用する。
  • 失敗ログを先にアーカイブしてから作業ディレクトリを削除する。
  • ディスク使用量と古いキャッシュを定期的に確認する。
  1. 01 runnerを登録

    チームが管理する短期登録情報でrunnerを接続します。タグにはApple Silicon、リージョン、想定ワークフローを明確に示します。

  2. 02 基準タスクを作成

    環境確認と最小ビルドだけを実行し、リポジトリ権限、Xcodeパス、依存関係のダウンロード、成果物の返送がすべて正常であることを確認します。

  3. 03 キャッシュを追加

    まずキャッシュなしの時間を測定し、ロックファイルとツールチェーンに基づいてキャッシュキーを作成します。キャッシュが本当に有効か判断できなくなる状態を避けてください。

  4. 04 クリーンアップを検証

    意図的に1回失敗させ、ログが返送され、一時情報が取り消され、後続タスクが前回の状態を引き継がないことを確認します。

ストレージとThunderbolt 5

追加項目は注文時に確認し、提供後に容量と接続を検証

基本構成はDebug M4：M4、16GB RAM、256GB SSDです。+1TB SSD、+2TB SSD、Thunderbolt 5並列接続はそれぞれ独立した追加項目です。システム表示から注文内容を推測しないでください。

追加ストレージ

+1TB SSD

注文単位で課金
日額$2.3
週額$6.1
月額$11.3
四半期$30.7

有効化前に対象ワークフロー、想定ピーク、データ移行方法を確認し、提供後に総容量、ボリューム名、ファイルシステム、マウントパスを確認します。

追加ストレージ

+2TB SSD

注文単位で課金
日額$4.6
週額$12.2
月額$22.6
四半期$61.4

多数のアーカイブ、メディア素材、モデルファイルを保持するタスクに適しています。容量の確認はシステムのディスク情報と実際のマウント結果で行ってください。

1台単位で課金

Thunderbolt 5並列接続

1台ごとに個別計算
日額$1.7
週額$4.6
月額$8.5
四半期$23.1

送信前に並列接続台数、タスクの割り当て方法、成果物の集約先を明確にします。このオプションは1台単位で課金され、1台の価格からグループ全体の注文金額を推算できません。

  1. 01 注文を確認

    追加項目の名称、数量、契約期間、USD金額を確認します。実際の利用可能状態と決済ゲートウェイはコンソールのリアルタイム表示を基準にしてください。

  2. 02 システムを確認

    次のコマンドで diskutil list と df -h ディスク、ボリューム、空き容量を記録します。デスクトップのアイコンだけで判断しないでください。

  3. 03 読み書きを検証

    対象の作業ディレクトリで小規模な読み書きテストを行い、権限、パス、実際の成果物の場所を確認します。一度の極端なテストで長期的な性能を判断しないでください。

  4. 04 対応関係を記録

    複数ディスクまたは複数マシンで作業する場合は、「タスク—ボリューム—成果物ディレクトリ」の対応関係を記録し、クリーンアップで保持すべきデータを削除しないようにします。

ネットワーク診断ガイド

4種類のテストでローカルネットワーク、リージョン間経路、ノードセッションを切り分ける

1回の遅延測定や切断だけで原因を判断できません。同じネットワーク、近い時間帯でサンプリングを繰り返し、コマンド、対象、時刻、元の出力を保存してください。

ネットワーク診断コマンド、観察項目、判断範囲
テスト コマンド例 主な観察項目 切り分けに役立つ問題
基本遅延 ping -c 20 <HOST> パケットロス、変動、連続タイムアウトの位置 ローカル接続異常と継続的な経路異常
経路追跡 traceroute <HOST> 経路の変化、異常なホップ、タイムアウトの継続有無 ローカル出口、リージョン間経路、宛先付近の経路
ポート確認 nc -vz <HOST> 22 接続成功、拒否、タイムアウト ホストには到達できるがSSHポートに到達できない状態
転送テスト scp <FILE> <USER>@<HOST>:<PATH> 継続速度、再試行、ファイルチェックサム 対話遅延と大容量ファイル転送の問題
セッション確認 ssh -vv <USER>@<HOST> 名前解決、ハンドシェイク、鍵の選択、認証段階 ネットワーク、フィンガープリント、鍵、ユーザー設定の問題

ローカルネットワークの問題

同じデバイスから複数の宛先へのアクセスが異常で、管理されたネットワークへの切り替えで回復する、またはローカル出口の最初の数ホップで継続的なパケットロスが発生している場合です。提出時にはネットワーク種別と再測定結果を記載してください。

リージョン間経路の問題

ローカル接続は正常でも、特定の経路で継続的な変動が発生する場合です。複数回の経路追跡を提示し、中間ホップが応答しないことを実際のパケットロスと直ちに同一視しないでください。

ノードセッションの問題

ホストとポートには到達できるものの、認証、Shell、GUIセッションに失敗する場合です。SSH詳細出力、セッションエラー、直近の操作を重点的に保存してください。

測定時の注意

ネットワーク結果は、利用中の通信事業者、接続方式、リージョン間経路、測定時間帯の影響を受けます。問題範囲の特定にのみ使用し、性能保証を意味しません。すべてのノードは365日稼働しており、可用性は実際のサービス記録で確認できます。

チケット準備リスト

サポート依頼を再現可能な引き継ぎ情報に整理

稼働中のノードの問題は、優先的にコンソールからチケットを送信してください。購入前またはログインできない場合はsupport@debugmac.comへメールを送信できます。どちらの窓口でも同じ情報リストを使用します。

  1. 01 注文ID

    コンソールに表示される注文IDと機種Debug M4を提供します。支払い情報、秘密鍵、完全なアクセスパスワードは送信しないでください。

  2. 02 ノードのリージョン

    シンガポール、日本（東京）、韓国（ソウル）、香港、米国西部のいずれかを記載し、問題がそのリージョンだけで発生するか説明します。

  3. 03 発生時刻

    タイムゾーン付きの初回発生時刻、直近の再現時刻、継続時間を提供します。「さっき」「たまに」だけの記載は避けてください。

  4. 04 再現手順

    入力、実行コマンド、期待結果、実際の結果の順に整理します。安定して再現できない場合は、発生頻度と確認済みの共通条件を説明してください。

  5. 05 マスキング済みログ

    タイムスタンプ、終了コード、エラーの前後関係を保持し、鍵、トークン、パスワード、内部リポジトリアドレス、その他の機密値を削除します。

  6. 06 実施済みの確認

    実行済みのコマンド、再試行回数、ネットワーク切り替え、結果を列挙し、サポート担当者が同じ基本確認を繰り返し求める状況を避けます。

稼働中のノードとアカウント

コンソールにログインしてチケットを送信

チケットは注文、ノード、過去の対応履歴と関連付けられます。接続、ビルド、ストレージ、請求、アカウントアクセスの問題に適しています。

コンソールへ
購入前またはログインできない場合

構造化されたサポートメールを送信

件名にタスク種別とノードのリージョンを記載し、本文はこのページのリストに沿って整理します。外部向けサポートメールはsupport@debugmac.comのみです。

サポートメールを送信
準備を始める

構成を確認できるクラウドMacが必要ですか？

Debug M4、契約期間、5つのリージョンからノードを選び、送信前に基本構成、追加項目、リージョン、USDの支払額を再確認してください。実際の利用可能状態はコンソールのリアルタイム表示を基準にします。

クラウドMacを借りる 構成と料金を見る