タスク別トラブルシューティングガイド

エラーを実行可能なチェックポイントへ

開通、接続、開発ツールチェーン、ストレージ、請求のタスク別に問題を特定できます。各手順で確認順序、検証コマンド、保存すべき診断情報を案内します。HireAMacの専用Apple Silicon物理ノードに対応しています。

コンソールからチケットを送信 リモートアクセスガイドを見る
5台のクラウドMacノードで構成された接続ネットワークの図
DIAGNOSTIC FLOW READY
01 問題の範囲を確認 接続 / ビルド / ストレージ / 請求
02 検証結果を記録 ノード、時刻、コマンド、マスキング済みログ
03 単一変数で再テスト 一度に変更する条件は1つだけ
クイック検索

エラーメッセージ、コマンド、請求項目を入力

接続タイムアウト、認証情報、Xcode、Swift、CI Runner、SSD、注文期間などのキーワードを検索できます。検索対象はこのページのガイドのみで、入力内容はアップロードされません。

現在6件のヘルプトピックを表示しています。

人気のタスク 初回開通 接続タイムアウト Xcodeを検証 データをエクスポート 請求を確認 チケットを準備
初めての利用

4つのチェックポイントで初回ビルドを完了

まずノードとアクセス条件を確認し、次にシステムとビルドツールを検証します。接続が安定する前に、認証情報、クライアント、ツールチェーンを同時に変更しないでください。

  1. 01

    コンソールでノード情報を確認

    注文に対応するインスタンス詳細を開き、モデル、リージョン、接続先、現在のセッション状態を記録します。販売中の3構成は HireAMac M4 S（M4、16GB、256GB）、HireAMac M4 M（M4、24GB、512GB）、HireAMac M4 Pro L（M4 Pro、64GB、2TB）です。リージョンはシンガポール、日本（東京）、韓国（ソウル）、香港、米国東部のいずれかです。

    • 注文IDとインスタンス詳細が一致している。
    • 接続先は現在のインスタンスから取得し、旧注文の記録を使わない。
    • サポートリクエストには必要な項目だけを記録し、アクセスキーをコピーしない。
  2. 02

    アクセス認証情報を設定して個別に検証

    コンソールで提供される方法を使って強固な認証情報を設定し、管理されたパスワードマネージャーまたはシークレットストレージに保存します。初回接続ではログインだけを確認し、プロジェクトのアップロード、依存関係のインストール、長時間タスクの開始は後にします。チームでは必要最小限の権限を付与し、メンバーがプロジェクトを離れたら速やかにアクセスを取り消します。

  3. 03

    macOSとコマンドライン環境を検証

    グラフィカルデスクトップに正常に入れることを確認したら、ターミナルで次の読み取り専用コマンドを実行します。テキスト出力だけを保存し、機密性のあるディレクトリや認証情報を含むデスクトップ全体のスクリーンショットは不要です。

    sw_vers
uname -m
xcode-select -p
xcrun swift --version
xcodebuild -version

    想定アーキテクチャはApple Siliconに対応する arm64です。 xcode-select -p 有効なDeveloper Directoryを返さない場合は、先にコマンドラインツールのパスを設定してからビルド検証を続けます。

  4. 04

    破棄可能な最小ビルドタスクを実行

    本番認証情報を含まない小規模なプロジェクトを選び、まず依存関係を解決してからクリーンビルドを1回実行します。終了コード、成果物ディレクトリ、空きディスク容量、ビルドログを確認します。最小タスクが成功してから大規模リポジトリ、キャッシュ、自動化フローを移行すると、環境の問題とプロジェクトの問題を切り分けやすくなります。

    df -h /
xcodebuild -project Sample.xcodeproj -scheme Sample -showBuildSettings
xcodebuild -project Sample.xcodeproj -scheme Sample clean build
完了条件：ノード情報、認証情報、システムとツールのバージョン、最小ビルドの明確な結果を確認できている。どこかで失敗したらその層で調査を止め、後続の設定を同時に変更しない。
接続診断

ネットワーク、ノード、認証情報、セッション、クライアントの順に確認します。

順序が重要です。まず通信経路に到達できることを確認してから認証とクライアント表示の問題に進むことで、ネットワーク障害を認証情報のエラーと誤判定せずに済みます。

01

ローカルネットワーク

現在のネットワークにプロキシルール、企業ファイアウォール、一時的なテザリング制限がないか確認します。現在のネットワークと別の信頼できるネットワークで個別に再テストし、どちらか一方の経路だけが失敗するか記録します。

確認ポイント DNS解決、ルート到達性、ポートポリシー、パケットロスの状況
02

対象ノード

コンソールに戻り、インスタンスのアドレス、リージョン、状態を確認します。以前のセッションに保存されたアドレスは使わないでください。リージョンをまたぐチームでは、同じ注文に対応する物理ノードへ接続していることを確認します。

確認ポイント 注文ID、ノードリージョン、接続先、ステータス更新時刻
03

アクセス認証情報

ユーザー名、キーファイルの権限、直近の認証情報ローテーションを確認します。認証に失敗したときは、未知の認証情報を連続して試さず、まず信頼できる唯一の入手元を確認します。

確認ポイント ユーザー名、キーの権限、認証情報のバージョン、認証エラーの原文
04

セッション状態

残ったフルスクリーンセッション、終了していないリモートデスクトップ、実行中の自動化タスクがないか確認します。セッションを再確立する前に古い接続を安全に終了し、データを書き込み中のプロセスを直接強制終了しないでください。

確認ポイント 既存セッション、アクティブなプロセス、デスクトップのロック、直近の切断時刻
05

クライアント設定

クライアントのバージョン、解像度、色設定、クリップボードポリシーを確認します。ターミナルには到達できるのにグラフィカルデスクトップに問題がある場合、問題は通常セッションまたはクライアント層に絞られます。

確認ポイント クライアントバージョン、表示設定、入力方式、ファイル転送ポリシー
コピー可能な診断チェックリスト

サポートリクエストの送信前に、次の項目をすべて記入してください。

時刻にはタイムゾーンを含めます。ログはエラー前後の必要な行だけを残し、ユーザー名、プライベートパス、トークン、キー、プロジェクト機密情報を置き換えます。

問題の種類：
注文ID：
モデル：
ノードリージョン：
発生日時とタイムゾーン：
ローカルネットワークの種類：
接続方式とクライアントバージョン：
エラーメッセージ原文：
初回発生または再現可能：
完了した確認：
マスキング済みログの抜粋：
開発ツールチェーン

インストール、パス、バージョン、タスク実行を個別に検証します。

ツールが存在することと、タスクに利用できることは同じではありません。検証時には、実行ファイルのパス、実際のバージョン、選択中のDeveloper Directory、最小タスクの終了コードを同時に記録します。

XcodeとDeveloper Directory

まずXcodeのバージョンと現在のDeveloper Directoryを読み取り、次に xcrun でツールの解決を検証します。複数バージョン環境を切り替えた後はターミナルを再起動し、対話セッションと自動化タスクが異なるパスを参照しないよう、同じユーザーでビルドタスクを実行します。

xcodebuild -version
xcode-select -p
xcrun --find xcodebuild
xcrun simctl list runtimes

Swiftとコマンドラインツール

Swiftコンパイラ、システムアーキテクチャ、基本ビルドツールを個別に確認します。対話ターミナルでは成功するのに自動化タスクが失敗する場合は、両者の PATH、作業ディレクトリ、ユーザーID、環境変数を比較し、すぐにツールを再インストールしないでください。

xcrun swift --version
clang --version
uname -m
pwd
printf '%s\n' "$PATH"

証明書ファイルと機密情報

証明書ファイルは管理されたパスから渡し、ファイル権限を制限します。インポート前に用途と有効状態を確認してください。診断時はファイル名、用途、権限、検証結果だけを記録し、スクリーンショット、ビルドログ、チケット添付ファイルにパスワード、秘密鍵、有効なアクセストークンを送らないでください。

ls -l /path/to/certificate
file /path/to/certificate
security find-identity -v -p codesigning

CI Runnerの状態確認

使用するリポジトリプラットフォームにかかわらず、Runnerプロセスのユーザー、作業ディレクトリ、空きディスク容量、ツールチェーンのパス、タスクの終了コードを検証します。まず本番リソースにアクセスしないプローブタスクを実行し、その後に完全なパイプラインへ接続します。失敗ログにはステージ名とコマンド結果を含めます。

whoami
pwd
df -h /
xcode-select -p
xcodebuild -version
xcrun swift --version

ツールチェーンの状態で答えるべき5つの質問

  • どこにインストールされているか：実行ファイルとDeveloper Directoryのパスが明確である。
  • どのバージョンを実行するか：Xcode、Swift、コマンドラインツールのバージョンを記録している。
  • 誰が実行するか：対話ユーザーと自動化プロセスのユーザーを区別している。
  • どこから実行するか：作業ディレクトリ、プロジェクトファイル、出力ディレクトリを確認できる。
  • 結果をどう判定するか：終了コード、成果物の場所、エラーログを照合できる。
ストレージとデータ

容量はリポジトリのサイズだけでなく、ピーク時のワーキングセットで選びます。

ソースコード、依存関係キャッシュ、ビルド中間ファイル、アーカイブ成果物、実験データ、エクスポート用コピーの同時使用量を見積もり、クリーンアップ用の空き容量も確保します。

ベースSSD

ランダム型で提供される基本容量

HireAMac M4 S
256GB
HireAMac M4 M
512GB
HireAMac M4 Pro L
2TB

容量を予測でき、依存関係を再ダウンロードでき、成果物を適時エクスポートできるワークフローに適しています。大型シミュレーターのランタイム、アーカイブ、キャッシュはソースコード自体を大きく上回る場合があるため、初期使用量ではなくピーク時で判断してください。

+1TB SSD

継続的なビルドと複数ブランチのキャッシュに余裕を確保

日額
$2.9
週額
$7.7
月額
$14.3
四半期額
$38.9

複数ブランチの並行運用、依存関係キャッシュの保持、増え続けるビルド成果物の処理に適しています。注文前に、ワーキングセットとエクスポート用コピーが同時に存在する期間を追加容量でカバーできるか確認してください。

+2TB SSD

大規模データセットと複数タスクの並列処理向け

日額
$5.8
週額
$15.4
月額
$28.6
四半期額
$77.8

大容量の実験データ、複数の大規模プロジェクト、多数の中間成果物を保持するタスクに適しています。容量拡張はバックアップの代替ではありません。重要なデータはレンタル期間終了前に独立した場所へエクスポートし、検証してください。

INPUT

アップロード

まず最小限の実行可能なセットを転送し、権限、ファイルの完全性、ディレクトリ構造を検証してから、大容量リソースを分割してアップロードします。キーをリポジトリの圧縮ファイルや共通データパッケージに混入させないでください。

MOVE

移行

ソースパス、移行先パス、ファイル数、検証結果を記録します。移行中は同じディレクトリを継続的に書き換えるタスクを一時停止し、ソースと移行先の状態が一致しなくなるのを防ぎます。

CLEAN

クリーンアップ

再生成できるキャッシュと一時成果物から優先して削除します。削除前にアクティブなタスクが対象ディレクトリを使用していないことを確認し、削除範囲と解放容量を記録します。

EXPORT

エクスポート

レンタル期間終了前にソースコード、設定、成果物、必要なログをエクスポートし、ファイル数またはチェックサムを確認します。外部コピーを開けることを確認してから、ノード上の作業データを処理してください。

df -h /
du -sh ~/Projects
du -sh ~/Library/Developer/Xcode/DerivedData
find ~/Projects -type f | wc -l
請求に関する問題の索引

まず期間を確認し、次にモデル、ノード、追加項目を照合します。

すべての注文は米ドル（USD）で決済されます。実際に利用できる決済ゲートウェイはコンソールのリアルタイム表示に従います。対応決済は USDT-TRC20 と Visa / Mastercard / Amex（Stripe経由）です。

3モデルの日額・週額・月額・四半期額
モデル 構成 日額 週額 月額 四半期額
HireAMac M4 S M4 / 16GB / 256GB $20.9 $56.4 $104.4 $284
HireAMac M4 M M4 / 24GB / 512GB $41.2 $111.2 $205.9 $560
HireAMac M4 Pro L M4 Pro / 64GB / 2TB $59.9 $161.8 $299.6 $814.9
ストレージ拡張とThunderbolt 5並列接続の料金
追加項目 日額 週額 月額 四半期額
+1TB SSD $2.9 $7.7 $14.3 $38.9
+2TB SSD $5.8 $15.4 $28.6 $77.8
Thunderbolt 5並列接続（1台あたり） $1.3 $3.6 $6.7 $18.2
DAY

日額注文

一時的なビルド、障害の再現、短時間タスクの検証に適しています。注文の日数、モデルの日額、追加項目の日額、ノード項目を確認してください。

WEEK

週額注文

バージョンの集中開発や継続テストに適しています。請求には選択したモデルの週額と、週単位で課金されるストレージまたは並列接続の追加項目が表示されます。

MONTH

月額注文

日常的な開発と安定したCIワークフローに適しています。月次期間の境界、モデルの月額、ノード、各月額追加料金を確認してください。

QUARTER

四半期注文

要件が安定した継続タスクに適しています。モデル料金、追加項目料金、注文期間がすべて同じ期間単位で記録されていることを確認してください。

請求金額はどの順番で確認しますか？
まずモデルと請求期間を確認し、次にノード、ストレージ拡張、Thunderbolt 5並列接続数を確認します。最後に米ドル（USD）の決済項目と決済処理結果を照合してください。異なる期間の単価を混ぜて計算しないでください。
利用できる決済方法は？
USDT-TRC20 と Visa / Mastercard / Amex（Stripe経由）のみ対応しています。すべての注文は米ドル（USD）で決済されます。実際に利用できるゲートウェイはコンソールのリアルタイム表示に従います。
ノードとモデルの組み合わせはどう確認しますか？
3モデルすべてで、シンガポール、日本（東京）、韓国（ソウル）、香港、米国東部を選択できます。注文時の実際の提供状況はコンソールのリアルタイム表示に従います。
サポート依頼の準備シート

サポート担当者がそのまま再現できる依頼にする

コンソールからチケットを送信するか、support@hireamac.com へメールを送信できます。アクセスキー、パスワード、有効なトークン、マスキングしていないプロジェクトデータは送らないでください。

ノードとモデル

シンガポール、日本（東京）、韓国（ソウル）、香港、米国東部のいずれかと、対応するHireAMacの販売中モデル名を明記してください。

注文IDと発生時刻

コンソールの注文IDを記載してください。問題の発生時刻には日付、時刻、タイムゾーンを含め、継続している場合は開始時刻と終了時刻の範囲を示します。

最短の再現手順

既知の正常な状態から開始し、操作、入力、期待結果、実際の結果を順番に記載します。毎回発生するかどうかも明記してください。

マスキング済みログと実施済みの操作

エラー原文、コマンドの終了コード、必要なコンテキストを残します。ユーザー名、プライベートパス、キー、トークン、証明書内容、業務データを置き換えてください。

次のステップ

問題を特定したら、ワークフローに戻ります。

新しいノードが必要な場合は3つの構成と4つのレンタル期間を比較してください。既存インスタンスの問題は、診断結果を含むチケットをコンソールから送信してください。

3つのレンタルプランを見る クラウドMacを今すぐレンタル