ビルドを止めないために

現在のDeveloperディレクトリとバージョンを確認し、使用するXcodeがインストールされていることを確認します。以下の例では、システムのデフォルトディレクトリを /Applications/Xcode.appに切り替えます。別のバージョンを使う場合は、実際のアプリケーションパスに置き換えてください。

xcode-select -p
xcodebuild -version
sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
xcodebuild -version
xcrun --find swift

システム全体の切り替えは、その後に起動するほかのタスクにも影響します。パイプラインごとに異なるバージョンを使う場合は、タスク環境で DEVELOPER_DIRを設定し、複数のジョブからグローバルなディレクトリを何度も変更しないようにしてください。

DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer \
xcodebuild -list -workspace MyApp.xcworkspace

切り替え後、Schemeを一覧表示してからArchiveを実行します。プラットフォームコンポーネントが不足している場合や初回設定が必要な場合は、macOSのGUIで該当するツールチェーンを初期化してから、自動化タスクを再開してください。

秘密鍵を含む証明書の書き出しファイル、そのパスワード、アプリの識別子と配布方法に合ったプロビジョニングプロファイルを用意します。証明書だけで対応する秘密鍵がない場合、通常はコード署名できません。

1. ビルドタスクを実行するmacOSユーザーで「キーチェーンアクセス」を開き、そのユーザーのキーチェーンに証明書を読み込みます。
2. 証明書を展開し、対応する秘密鍵が表示されることを確認します。以下のコマンドで、有効なコード署名IDを確認できます。
3. 使用するXcodeのバージョンに応じた方法でプロビジョニングプロファイルをインストールし、プロジェクトの署名設定でTeam、Bundle Identifier、配布方法を確認します。
4. App、Widget、Extensionそれぞれの署名設定を確認してから、Archiveと書き出しを検証します。

security find-identity -v -p codesigning

CIの実行ユーザーとリモートデスクトップのユーザーでは、キーチェーン環境が異なる場合があります。無人ビルドでは、ジョブ内でキーチェーンのロックを解除し、必要なアクセス権を設定してください。パスワードはCIの保護された変数から読み込み、リポジトリやコマンド出力、チケットに記載しないでください。

手動ビルドは成功するのにCIで失敗する場合は、まず実行ユーザーとキーチェーンの状態を比較してください。署名エラーについて問い合わせる際は、証明書の種類、有効期限、個人情報を伏せたエラー行だけをお送りください。秘密鍵や証明書のパスワードはアップロードしないでください。

再インストールしてもファイルが残るとは限りません。システムや作業ディレクトリが消去される場合があります。依頼する前にコンソールのチケットで作業範囲を確認し、ノード外にバックアップしてください。利用期間終了後はノードのディスクが消去されるため、期限後のノードを復元元にすることはできません。

バックアップには、未プッシュのソースコード、ビルド設定、必要な成果物、プロビジョニングプロファイル、保護された秘密鍵を含めてください。DerivedDataや依存関係のダウンロード先などのキャッシュは再生成できますが、復元後の初回ビルドに時間がかかる場合があります。

バックアップを取っただけでは、復元できるとは限りません。別のディレクトリにバックアップを展開し、ファイル数と重要な設定を確認して、最新の成果物を取り出せることを確かめてから、元のノードのタスクを停止してください。再インストール後はツールチェーンを入れ直し、署名環境を復元してrunnerを登録します。

注文に紐づくアカウントにログインし、コンソールでインスタンス、期限、選択できる更新期間を確認してから、画面に表示された請求に従ってお支払いください。更新の完了と新しい利用期間は、コンソールに表示される最新の結果で確認してください。支払い画面のスクリーンショットや、ブラウザーを閉じる前の表示だけで判断しないでください。

お支払いはUSDT-TRC20、Visa、Mastercard、Amex（Stripe）に対応しており、すべて米ドルで決済されます。実際に利用できる決済手段は、バックエンドから返される情報をご確認ください。暗号資産で支払う場合は、送金前にネットワーク、金額、送金先を確認してください。カード決済後はコンソールに戻り、請求状況をご確認ください。

請求情報とインスタンスの状態が一致しない場合は、注文番号、請求番号、取引参照情報を添えてお問い合わせください。状態を直そうとして支払いを繰り返したり、チケットにカード番号全桁を記載したりしないでください。期限前に成果物や必要なファイルをバックアップし、更新をデータのバックアップ手段として扱わないようにしてください。

まずコンソールでノードのアドレス、ポート、ユーザー名、インスタンスの状態を確認します。接続タイムアウトと認証失敗を区別してください。タイムアウトの場合はネットワーク到達性を、認証失敗の場合はユーザー名、パスワード、鍵を確認します。SSHとVNCでは接続情報が異なるため、ポートを混同しないでください。

ssh -v -p PORT USER@HOST

を実際の情報に置き換えてください。 PORT、USER、HOST ログにホストフィンガープリントの変更が表示された場合は、信頼できるコンソール情報またはチケットで理由を確認してください。ホスト認証をすぐに無効にしないでください。

リモートデスクトップはmacOSのGUI、キーチェーン、Xcodeの設定確認に適しています。SSHはコマンドライン操作やCIに適しています。ログを送る前に、ユーザー名、アドレス、ローカルパスに含まれる機密情報を削除し、エラーの種類と発生順だけを残してください。

次の4点を確認します。runnerがオンラインか、ジョブのラベルが一致しているか、プロジェクトでそのrunnerの使用が許可されているか、プロセスが正しいユーザーで実行されているか。登録が完了しても、すべてのジョブが自動的にそのノードへ割り当てられるわけではありません。

まずツールチェーン情報だけを出力するテストジョブを実行し、実行ユーザー、ディレクトリ、Xcodeのバージョンを確認します。その後、依存関係のインストールと署名の手順を追加してください。

whoami
pwd
xcode-select -p
xcodebuild -version
security find-identity -v -p codesigning

ラベルにはmacOS、チップのアーキテクチャ、用途を記載し、プロジェクト設定で明示的に選択してください。初回は同時実行を1つに制限し、キャッシュ、キーチェーン、成果物のディレクトリが互いに上書きされないことを確認してから、同時実行数を増やします。登録トークンは認証情報です。チケットやビルドログに記載しないでください。

正しいworkspace、共有Scheme、Release設定を使っていることを確認します。Archiveとシミュレーター向けビルドでは手順が異なります。実機向けの署名、アーキテクチャ、書き出し設定は個別に確認してください。

xcodebuild -list -workspace MyApp.xcworkspace
xcodebuild archive \
  -workspace MyApp.xcworkspace \
  -scheme MyApp \
  -configuration Release \
  -destination 'generic/platform=iOS' \
  -archivePath build/MyApp.xcarchive

最後の「失敗」という結論だけでなく、最初に発生した具体的なエラーと前後のログを残してください。依存関係のインストール、スクリプトの実行、署名、ディスクへの書き込みを個別に確認します。Archiveが成功しても、書き出した成果物を検証してください。アーカイブの完了は、配布可能なパッケージの作成完了を意味しません。

まずディスク使用量とタスクの状態を確認し、再生成できるキャッシュと保持が必要な成果物を区別してください。実行中のジョブが使用しているディレクトリは削除しないでください。ソースコード、署名関連データ、未アップロードのArchiveもキャッシュとして扱わないでください。

df -h
du -sh ~/Library/Developer/Xcode/DerivedData
du -sh ~/Library/Developer/Xcode/Archives

キャッシュと成果物には、それぞれ別の保持ルールを設定してください。削除後は初回のコンパイルや依存関係の解決に時間がかかる場合があるため、次のビルドはコールドスタートの検証として扱いましょう。長期的に容量が不足する場合は、プロジェクトと成果物の増加量を確認し、適切なマシンやSSDオプションを選択してください。