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層構造で、決めた設計判断の侵食を防ぎます。
ESLint 9.x Flat ConfigとStylelintをVitePressに導入する完全ガイド
VitePressサイトにESLint 9.x Flat ConfigとStylelintを導入した実践ガイドです。TypeScript/JavaScript混在環境での設定方法、GitHub Actions CI/CD自動化、つまづきポイントと解決策を具体的なコード付きで解説します。
Next.js本番ビルドで認証モックが動作しない問題の解決方法｜E2Eテスト自動化
Next.jsの本番ビルドでE2Eテスト実行時に認証モックが動作しない問題を解決。外部認証パッケージのセキュリティ設計を尊重しながら、NEXT_PUBLIC環境変数でモック認証を実装する完全ガイド。