Status

【運営報告】ブログ自動化システムの安定化に向けた取り組み はじめに：その自動化、本当に「自動」ですか？ 「ブログの自動投稿システムを組んだけど、なぜか時々ビルドに失敗する…」 「CI/CDパイプラインがエラーで止まるたびに、原因究明に数十分も費やしている…」 「最初はシンプルだったのに、機能を追加していくうちにリポジトリがカオスになってきた…」 もしあなたが個人ブログや技術ドキュメントサイトをGitHub Actionsなどで自動化していて、このような悩みを抱えているなら、この記事はあなたのためのものです。 こんにちは。当ブログを運営している筆者です。私もかつて、まさにこの問題の渦中にいました。Markdownで記事を書いてGitHubにプッシュすれば、あとは魔法のようにサイトが更新される──そんな夢のような自動化システムを構築したはずが、いつしかそれは「時々機嫌を損ねる気難しい同居人」のような存在になっていました。依存関係のエラー、ローカルとCI環境での挙動の違い、肥大化したワークフローファイル…。これらは、自動化による恩恵を帳消しにするほどのストレスと時間的損失をもたらしていました。 この記事では、私が直面したブログ自動化システムの不安定化問題と、その根本原因を深く掘り下げ、リポジトリの再構築とビルド環境のコンテナ化というアプローチでいかにして安定稼働を実現したか、その全貌を余すところなくお伝えします。 この記事を読み終える頃には、あなたは以下の知識とテクニックを手にしているはずです。 不安定なCI/CDパイプラインの根本原因を診断するための着眼点 モノレポとマルチレポの考え方を適用した、メンテナンス性の高いリポジトリ設計 Dockerを活用して「どこでも同じように動く」ビルド環境を構築する方法 堅牢で再利用性の高いGitHub Actionsワークフローを設計するための具体的なベストプラクティス 技術的負債と向き合い、システムを長期的に健全な状態に保つためのマインドセット 単なる対症療法ではない、根本からのシステム改善に興味のある方は、ぜひ最後までお付き合いください。 なぜブログ自動化システムは不安定になったのか？ - 課題の深掘り 解決策を語る前に、まずは私のブログシステムがどのような問題を抱えていたのか、その背景と原因を詳しく見ていきましょう。問題を正しく理解することが、正しい解決策への第一歩です。 当初のシステム構成 私のブログは、多くの技術ブログで採用されているであろう、ごく一般的な構成でした。 コンテンツ管理: Markdownファイル 静的サイトジェネレーター(SSG): Hugo ソースコード管理: GitHub CI/CD: GitHub Actions ホスティング: GitHub Pages この構成における自動投稿の基本的な流れは、以下の図のようになります。 graph TD A[記事(Markdown)をpush] --> B{GitHub Actions}; B --> C[Hugoでビルド]; C --> D[GitHub Pagesへデプロイ]; 非常にシンプルで、最初はこれで何の問題もありませんでした。しかし、ブログ運営を続けるうちに、様々な機能を追加したくなり、システムは徐々に複雑化していきました。そして、以下の3つの大きな問題が顕在化したのです。 問題1：依存関係地獄 (Dependency Hell) 「私のローカル環境ではちゃんとビルドできるのに、なぜかGitHub Actions上では失敗する」。この現象に、あなたも見覚えがないでしょうか。これは、開発環境と実行環境の間に存在する「差異」が原因で発生します。 私の場合、具体的には以下のような問題に悩まされていました。 Hugoのバージョン不整合: ローカルで使っているHugoのバージョンと、GitHub ActionsのワークフローでセットアップされるHugoのバージョンが微妙に異なり、テンプレートの仕様変更などでビルドエラーが発生する。 Node.js依存ツールのバージョン問題: 私が使っていたHugoテーマは、CSSのトランスパイルにSass（Dart Sass）を利用しており、これはNode.jsに依存していました。ローカルのNode.js/npmバージョンとCI環境のバージョンが異なると、npm installが失敗したり、Sassのコンパイル結果が変わってしまったりしました。 Go Modulesの混乱: HugoはGoで書かれているため、テーマによってはGo Modules (go.mod, go.sum) を利用します。CI環境のGoのバージョンが古いと、これもまたエラーの原因となりました。 これらのバージョンをpackage.jsonやワークフローファイルで固定しようと試みましたが、複数の依存関係が絡み合うと管理が非常に煩雑になり、根本的な解決には至りませんでした。 ...