監視は監視対象の外に置く — セルフホストCIの死活監視をGitHub Actionsで担保する
ローカル1台のセルフホストCIはホストごと落ちると自己検知できない。常時稼働のGitHub Actionsから死活監視・SLO計測・config drift検出を外付けする設計を解説します。
CIが動かない時の診断順序——まずGitHub Statusを見れば誤判断で時間を溶かさない
actions/checkoutが「Your account is suspended」を返した障害で、上流確認を飛ばし誤った仮説に時間を溶かした失敗談。Step1=上流障害確認から始めるCI切り分けフローを診断コマンド付きで解説します。
Self-hosted runner は単一障害点：Mac障害時にGitHub Actionsへ数分で切り替えるBCP/SOP設計
自宅Mac1台のself-hosted runnerは電源断・Tunnel停止でCIが全停止するSPOF。重いworkflowをworkflow_dispatchで残し、branch protectionを一時解除して数分でGitHub Actionsへフェイルオーバーする運用SOPを公開します。
macOS Self-hosted Runner から GHCR に push できない——osxkeychain 問題の回避策
macOS の Self-hosted Runner で ghcr.io への docker push が osxkeychain エラーで失敗する問題を、docker login を使わず config.json に直接認証を書き込む方法で解決した記録。step の実行順序の罠も含めて解説します。
Self-hosted Runner のスケール起動で registration が競合する——file lock と retry で解決した話
Docker Compose で Self-hosted Runner をスケールアウトすると、GitHub API の registration token が競合して一部のコンテナが再起動ループに陥る問題を、flock による直列化と3段階の retry ロジックで解決した記録。
Self-hosted Runner を1台の Mac で何並列まで動かせるか——VirtioFS 実測とスケール数チューニング
Docker Compose で動かす GitHub Actions Self-hosted Runner のスケール数を、VirtioFS ベンチマーク・アイドルメモリ実測・Docker Desktop 設定の最適化で決定するまでの記録。sweet spot 表と診断スクリプト付き。
GitHub Actions Self-hosted Runner の CI ビルドを 8分→3分に短縮した4段階の改善記録
Self-hosted Runner の Docker イメージビルド CI を4段階で高速化した記録。warm cache・registry cache・Dockerfile レイヤー分割・schedule skip まで、各フェーズの判断根拠と実測値を公開します。
GitHub Actions Self-hosted Runner を Docker Compose で複数 Organization に展開する——ラベル設計・セキュリティ分離・スケール運用の全設計
1台の Mac で Docker Compose を使い、複数 GitHub Organization 向けの self-hosted runner を運用する設計を解説。Container × Native の二刀流、ラベルによるワークフロールーティング、AI 生成コードの実行分離、ARC への移行パスまで。
ADRをコードで守る：pre-commitとCIで「決めた設計判断」の侵食を防ぐ実装パターン
ADR（Architecture Decision Record）の禁止事項をpre-commitとCIで機械的に守るための実装パターン。git merge-baseベースの差分スキャン、許可リスト、PRテンプレートの3層構造で、決めた設計判断の侵食を防ぎます。