まず問題の層を切り分け、再現可能な情報を送信

登録とオンライン状態

Runnerが正しいプロジェクトまたは組織に登録され、ラベルが一致し、実行環境がオンラインであることを確認します。タスクがキューに留まり続ける場合は、完全なパイプラインを再実行する前に、まずラベルと同時実行数の制限を確認し、次にRunnerプロセスを確認します。

ps aux | grep -i runner
launchctl list | grep -i runner

署名環境

ビルドプロセスで使用するアカウント、キーチェーン検索パス、証明書の可視性、プロビジョニングプロファイルの範囲が一致していることを確認します。ログには証明書名、失敗した段階、エラーテキストだけを残し、送信前にパスワード、秘密鍵の内容、完全な署名素材を削除してください。

security list-keychains
security find-identity -v -p codesigning

キャッシュディレクトリ

依存関係キャッシュ、派生データ、最終成果物を別々のディレクトリに置きます。キャッシュヒットに異常がある場合は、まずキャッシュキーとディレクトリ使用量を記録し、プロジェクト単位で削除します。すべての作業ディレクトリを一度に削除して比較用のサンプルを失わないようにしてください。

du -sh "$CACHE_PATH"
df -h
find "$CACHE_PATH" -maxdepth 1 -type d

ビルドキュー

キュー待ち開始、実行開始、終了の時刻を記録し、「タスクが取得されていない」状態と「タスクは開始したが長時間出力がない」状態を区別します。前者はラベル、同時実行数、Runner状態を、後者はスクリプトの待機、ネットワーク依存、子プロセスを重点的に確認します。

ログ収集

失敗した手順の前後それぞれ少なくとも50行のログを残し、コマンドの終了コード、ツールバージョン、プロジェクトで公開可能な最小再現パラメータを添付します。エラーポップアップのスクリーンショット1枚だけを送ったり、トークン、リポジトリ認証情報、業務データを含む完全なログ一式をアップロードしたりしないでください。

xcodebuild -version
sw_vers
uname -m

失敗時の再試行

初回の失敗後、まず元のログを保存し、同じコミットと同じパラメータで1回だけ再試行します。再試行が成功した場合は、ネットワーク要求、キャッシュヒット、実行時間を比較します。安定して失敗する場合は単一のコマンドまで絞り込み、入力、終了コード、実行時間を記録します。