ローカルネットワークは安定しているか
ローカル経路を変更する一時的なプロキシを停止して再試行し、信頼できる予備ネットワークでも比較テストを行います。オフィスネットワークで失敗し予備ネットワークで成功する場合は、出口ポリシーと影響を受けたポートを記録し、まずローカルネットワーク管理者に確認してください。
継続条件:同じ接続先への接続を、少なくとも1つの信頼できるネットワークで試行済みであること。
サポート手順
初回接続からビルド・性能診断まで、決められた順序で確認できます。まずローカルネットワーク、接続先、認証情報、ノード状態を確認し、その後ツールチェーンやリソース指標を調べることで、試行錯誤を減らし、サポート側でも問題を再現しやすくなります。
経路を検索
エラー内容、接続方法、システムタスク、ノード状態を入力してください。検索対象はこのページの表示文書のみで、入力内容はアップロードされません。
7件の対応手順を表示
ノードが準備完了か、認証情報の入手元が正しいか、ローカルネットワークから到達できるかを確認し、キーボード配列とタイムゾーンを合わせます。
確認の目安:3~5分 接続トラブルローカルネットワーク、接続先、認証情報、ノード状態、クライアント設定を順番に切り分けます。
5層のチェックを順番に実行 ビルドタスクまずツールのバージョンを固定し、署名素材、依存関係キャッシュ、ディスク容量、タスクログを確認します。
コマンド全文とタイムスタンプを保存 性能診断異常発生時にCPU、メモリ、ディスク、ネットワークを同時に記録し、一瞬のスクリーンショットだけを提出しないでください。
5~10分間の連続サンプリングを推奨 問い合わせアカウント、ノード到達不能、ハードウェア異常、データ関連の依頼に分類し、それぞれに必要な最小限の証拠を添付します。
既存の注文にはコンソール問い合わせが適しています 状態の判定同一リージョンとの比較、異なるネットワークでのテスト、コンソールの状態を使い、影響範囲を明確にします。
影響範囲を確認してから問い合わせる 証拠の準備ノード識別子、時間範囲、エラー原文、再現手順、マスキング済みログを整理し、追加確認の往復を減らします。
パスワード、秘密鍵、プロジェクトソースの提出は禁止エラーに含まれる重要な語句だけを残して検索するか、「すべて」を選択してください。既存の注文に関する問題は、エラー原文を添えてコンソールから問い合わせてください。
コンソールから問い合わせる初回セッション
複数の接続パラメータを同時に変更しないでください。各手順の結果を記録しておけば、失敗時に原因がローカル、ネットワーク、認証、ノードのどこにあるか判断できます。
コンソールで対象ノードが準備完了と表示されているか確認し、ノード識別子、リージョン、選択したモデルを照合します。ノードが準備中の場合、クライアントのエラーだけで接続障害と判断しないでください。
完了基準:ノード識別子が注文と一致し、接続可能な状態であること。コンソールの現在のノード詳細からアドレス、ポート、ユーザー名をコピーし、古い問い合わせ、スクリーンショット、別ノードの記録は使わないでください。パスワードを貼り付ける際は前後の空白と全角文字に注意します。
完了基準:アドレス、ポート、ユーザー名が同じノード詳細に由来すること。まず通常のHTTPSアクセスが正常か確認し、オフィスネットワークと信頼できる予備ネットワークをそれぞれテストします。企業の出口、ファイアウォール、プロキシが特定ポートだけを遮断する場合があるため、ウェブページが開けてもリモート接続できるとは限りません。
完了基準:使用ネットワーク、出口の種類、失敗時刻を記録すること。macOSのグラフィカルインターフェースに入ったら、文字、数字、記号、Command、Optionのマッピングを確認します。記号の位置が合わない場合は、ローカルとリモートで選択したキーボード配列も記録します。
完了基準:ターミナルでコマンド中の引用符、スラッシュ、ハイフンを正確に入力できること。タスクログ、CI記録、問い合わせの時刻には同じタイムゾーンを明記します。断続的なエラーを調べる際、「14:20」だけではノードのイベントと照合できません。タイムゾーン付きの完全な日時を使用してください。
完了基準:ローカル、ノード、自動化ログの時刻を相互に換算できること。判断フロー
接続タイムアウトは通常ネットワークまたはアドレス、認証失敗は通常ユーザー名、パスワード、鍵、クライアント設定を示します。まずエラーの種類で分岐し、その後5層のチェックを実行してください。
経路を変更する一時的なプロキシを停止して再試行し、信頼できる予備ネットワークでも比較テストを行います。オフィスネットワークで失敗し予備ネットワークで成功する場合は、出口ポリシーと影響を受けたポートを記録し、まずローカルネットワーク管理者に確認してください。
継続条件:同じ接続先への接続を、少なくとも1つの信頼できるネットワークで試行済みであること。
コンソールに戻り、対象情報を再度コピーしてください。コマンド履歴のアドレスを再利用しないでください。ブラウザのリモートデスクトップはコンソールの入口を使用し、SSHはホスト、ポート、ユーザー名が同じ接続記録にあるか確認します。
停止条件:アドレスが変わった、または別ノードの記録である場合は、更新して再テストすること。
ユーザー名の大文字・小文字、パスワード前後の空白、鍵ファイルの権限、選択したIDファイルを確認します。SSHホストフィンガープリントが初めて表示された場合はコンソール情報と照合してください。予期せず変わった場合は接続を停止し、問い合わせで理由を確認します。
証拠の要件:エラー原文を残しつつ、パスワード、鍵の内容、完全な接続先アドレスを隠すこと。
ノード詳細を更新し、状態、ノード識別子、最終変更時刻を確認します。状態に異常がある場合、再起動などの操作を繰り返さないでください。操作前の状態、実行済みの操作、各操作の時刻を記録し、障害発生時の情報を上書きしないようにします。
問い合わせ条件:ノード状態に異常がある、または正常でも2つの信頼できるネットワークから到達できないこと。
ブラウザ画面が空白の場合は、現行の安定版ブラウザを使い、そのサイトのセッションデータを消去して再試行します。キーボードがずれる場合は配列を1つに絞り、SSHセッションが頻繁に切断される場合はターミナルプラグインを停止して基本コマンドで比較用セッションを確立します。
完了条件:クライアント名、バージョン、接続方法、再現手順を記録すること。
ネットワークの種類、失敗時刻、対象リージョン、2つのネットワークの比較結果、コンソール上のノード状態を優先して提出します。時刻とノード識別子のないスクリーンショット1枚だけを送らないでください。
現在のノードのユーザー名、認証方式、クライアントのIDファイルを優先して確認します。問い合わせには認証方式とエラー原文だけを記載し、パスワード、秘密鍵、直接使用できる認証情報は送らないでください。
ビルドパイプライン
ビルドエラーは最後の要約行ではなく、最初に発生した明確なエラーから調べます。まずツールチェーンを固定し、次に署名、依存関係、ディスク、自動化プロセスを確認してください。
macOSバージョン、Xcodeバージョン、コマンドラインツールのパス、ビルドコマンドを記録します。グラフィカルインターフェースと自動化タスクが異なるツールパスを呼び出すと、同じノードでも結果が異なる場合があります。
証明書の不足、プロビジョニングプロファイルの不一致、権限範囲の不整合、キーチェーンアクセスの失敗を区別します。診断時は証明書名、有効期限、エラー内容を残し、証明書ファイル、パスワード、プロジェクトの機密識別子を隠してください。
まずロックファイルによって失敗を安定して再現できるか判断し、キャッシュは最小限の範囲だけを削除します。すべての依存関係とビルドキャッシュを一度に削除すると変数が増え、元の問題が一時的に消えて特定できなくなる場合があります。
アーカイブ、依存関係の展開、一時生成物には追加容量が必要です。プロジェクトディレクトリのサイズを見るだけでは不十分で、空き容量、一時ディレクトリ、ビルドキャッシュ、自動化プロセスがリソース不足で終了していないかも確認します。
パフォーマンスサンプル
CPUのスクリーンショット1枚だけでは、ディスク待ち、メモリ圧迫、ネットワークの揺らぎは説明できません。問題の前後5~10分間、連続してサンプリングし、タスクの開始時刻と失敗時刻を記録してください。
| 指標 | 最低限の記録 | 注目すべき現象 | タスクとの比較 |
|---|---|---|---|
| CPU | 全体使用率、主要プロセス、サンプリング時刻 | 単一プロセスの継続的な高負荷、負荷の急増、タスク終了後も使用率が戻らない | コンパイル、リンク、テスト、推論の開始時刻を記録 |
| メモリ | 使用量、メモリプレッシャー、スワップ領域 | プレッシャーの継続的な上昇、頻繁なスワップ、システムによるプロセス終了 | 並列タスク数と入力規模を記録 |
| ディスク | 空き容量、読み書きスループット、I/O待ち時間 | 容量が枯渇に近い、展開やアーカイブで待ち時間が目立つ | 依存関係のダウンロード、ビルドキャッシュ、生成物の書き込みを区別 |
| ネットワーク | ローカルネットワークの種類、往復遅延、パケットロス | 特定の出口だけ異常、操作は重いがノード内のタスクは正常 | リモート画面、依存関係のダウンロード、コード取得を区別 |
タスク開始前から基準値を記録し、異常後少なくとも1分間続けます。異常の瞬間だけのデータでは、リソースが原因か結果か判断できません。
同じプロジェクト、依存関係、並列度で正常なタスクを1回記録し、総時間だけでなく各段階の所要時間とリソース曲線を比較します。
リモート画面は途切れるがノード内タスクの所要時間が安定している場合、まずネットワークを確認します。タスク自体の時間が増えている場合はCPU、メモリ、ディスクを確認します。
最小限の証拠
サポート依頼でプロジェクト全体をアップロードする必要はありません。以下の項目で通常は初回判断が可能です。不足がある場合は追加情報をお願いします。
ノード識別子、ノードリージョン、macOSバージョン、Xcodeまたはクライアントのバージョン。パスワード、秘密鍵、完全な認証情報は入力しないでください。
「日付+時分秒+タイムゾーン」を使い、初回発生、最終発生、直近の再現時刻を明記します。
検索可能なテキストをコピーし、スクリーンショットだけにしないでください。エラーコード、失敗段階、最初のエラー前後のログコンテキストを残します。
既知の正常な状態から開始し、操作、コマンド、期待結果、実際の結果を順番に記載し、再現頻度も説明します。
ネットワークの切り替え、アドレスの更新、キャッシュの削除、タスクの再起動を行った時刻と結果を記載し、同じ操作の繰り返しで現場情報を上書きしないようにします。
問い合わせルール
1件の問い合わせには1つの主な問題だけを記載します。アカウントアクセスとノード障害が同時に発生した場合は、処理状況が互いに上書きされないよう別々に記録してください。
| 分類 | 対象となる状況 | 推奨する証拠 | 優先チャネル |
|---|---|---|---|
| アカウントの問題 | コンソールに入れない、アカウント情報またはアクセス認証に異常がある | 登録メールアドレス、発生時刻、画面のエラー原文、ブラウザバージョン | サポートメール |
| ノードに到達できない | ノードは接続可能と表示されるが、ブラウザのリモートデスクトップとSSHのどちらもセッションを確立できない | ノード識別子、リージョン、2つのネットワークのテスト結果、エラー時刻と原文 | コンソール問い合わせ |
| ハードウェア異常 | 異常な再起動、ストレージエラー、単一タスクでは説明できないリソース異常が継続して発生する | ノード識別子、システムログの時間範囲、異常前のタスク、再現頻度 | コンソール問い合わせ |
| データ関連の依頼 | ノードの解放、データエクスポート手順、プライバシー権利に関する依頼 | 注文識別子、依頼範囲、希望する対応、必要な本人確認情報 | コンソール問い合わせ |
ノードは接続可能な状態ですが、2つの信頼できるネットワークでテストしてもブラウザのリモートデスクトップとSSHの両方に到達できません。ノード識別子、リージョン、最後に成功した接続時刻を提出してください。
ノードには接続できますが、固定したツールチェーンでビルドまたは自動化タスクが安定して失敗します。最初のエラー、コマンド全文、終了コード、最短の再現手順を提出してください。
ノードは利用可能で、キーボード、解像度、依存関係キャッシュ、ワークフロー最適化に関する問題です。現在の設定、目標、検証済みの方法を説明してください。
サービス継続性
すべてのノードは年間365日の通常稼働を前提に設計されています。異常が発生した場合は、影響範囲からリージョンネットワークの揺らぎ、単一ノード障害、ローカル接続の問題を区別してください。
同一地域の複数の接続元で、近い時間帯に遅延増加、パケットロス、セッション切断が発生している一方、ノード内のタスクは継続している可能性があります。
ローカルネットワークと同一リージョンの他サービスは正常なのに、対象ノードの状態に異常、繰り返す切断、ユーザータスクでは説明できないシステムエラーがある
対象ノードは予備ネットワークや別クライアントから正常にアクセスできるが、特定のオフィス出口、ブラウザ設定、SSHクライアントだけが失敗する
「ノード SG-例に2026年8月8日14:20 +0800からSSH接続できません。自宅ネットワークとオフィスネットワークの両方でタイムアウトし、コンソールの状態は接続可能のままです。」
「サーバーが壊れた」「ネットワークが遅い」「たまに切れる」だけでは不十分です。ノード、時刻、ネットワークの接続元、エラー原文がなければ影響範囲を特定できません。
よくある質問
まずコンソールでノード識別子と状態を確認し、現在のノード詳細からアドレス、ポート、ユーザー名を再コピーします。その後、信頼できる予備ネットワークで比較します。状態を記録する前に、ノード状態を変える操作を複数回続けて実行しないでください。
最初のエラー前後少なくとも50行、ビルドコマンド全文、終了コード、Xcodeバージョン、発生時刻を優先して提出してください。完全なログにプロジェクトパス、リポジトリURL、署名情報が含まれる場合は先にマスキングします。エラーコードとタイムスタンプは削除しないでください。
スクリーンショットは1瞬間しか示さず、リソース変化がタスクの前後どちらで起きたか判断できません。CPU、メモリ、ディスク、ネットワークを5~10分間連続記録し、タスクの開始、異常、終了時刻を示してください。
既存の注文、ノード、ハードウェア、データ関連の依頼は、注文とノード記録を関連付けやすいコンソール問い合わせを優先してください。コンソールに入れないアカウントの問題は support@macworker.com にメールできます。当サイトの連絡窓口はこの2種類のみです。
パスワード、秘密鍵、決済情報、完全な接続先アドレス、プロジェクトソースを提出しないでください。ログの機密値は隠して構いませんが、項目名、バージョン、エラーコード、タイムスタンプ、呼び出し順序は残してください。
問い合わせの準備はできましたか?
コンソール問い合わせで既存の注文と関連付け、最短の再現手順とマスキング済みログを提出してください。まだノードを借りていない場合は、ポータルから専用物理マシンの構成、リージョン、期間を選択できます。