クラウド Mac の問題は、推測せず層ごとに切り分ける

1. 01

   インスタンスとローカル環境を確認する

   まずインスタンスが正常に稼働していることを確認し、コンソールに表示されたホストアドレスとユーザー名をローカル環境変数に設定します。パスワード、秘密鍵、完全な認証情報をリポジトリ、チャット、CIログに保存しないでください。

   export MAC_HOST="コンソールに表示されたホストアドレス"
   export MAC_USER="コンソールに表示されたユーザー名"
   test -n "$MAC_HOST" && test -n "$MAC_USER" && echo "connection variables ready"

2. 02

   初回接続してホストフィンガープリントを確認する

   接続後、ターミナルに表示されたフィンガープリントをコンソールの情報と照合します。ホストアドレスの変更、再インストール後のフィンガープリント変更、またはローカルに古い記録がある場合は、警告を無視せず、同じインスタンスか確認してください。

   ssh -v "$MAC_USER@$MAC_HOST"
   ssh-keygen -F "$MAC_HOST"

3. 03

   専用鍵を生成して登録する

   クラウド Mac 専用に Ed25519 鍵を生成すると、ローテーションや失効が容易になります。公開鍵を登録したら現在のセッションを残し、別のターミナルで鍵認証を検証してから元のセッションを終了してください。

   ssh-keygen -t ed25519 -a 64 -f "$HOME/.ssh/macrents_build"
   cat "$HOME/.ssh/macrents_build.pub" | ssh "$MAC_USER@$MAC_HOST" 'umask 077; mkdir -p ~/.ssh; cat >> ~/.ssh/authorized_keys'
   ssh -i "$HOME/.ssh/macrents_build" "$MAC_USER@$MAC_HOST"

4. 04

   クライアント設定を固定してベースラインを確認する

   対象インスタンス専用のエイリアス、鍵のパス、キープアライブ設定を用意します。ログイン後に macOS のバージョン、ディスク空き容量、現在のユーザー、システム時刻を記録すると、後のビルド失敗時に環境変化を素早く判断できます。

   sw_vers
   whoami
   date
   df -h /
   uptime

xcode-select -p
xcodebuild -version
xcodebuild -showsdks
xcrun simctl list devices available
xcrun --find swift
swift --version
security list-keychains -d user
security find-identity -v -p codesigning

set -o pipefail
xcodebuild -workspace Project.xcworkspace -scheme Project -configuration Release -destination 'generic/platform=macOS' clean build | tee "$HOME/logs/xcode-build.log"
printf 'exit_code=%s\n' "$?"