CHAPTER 03

全体再構築と公開フロー

共通パーツやテンプレート変更時に必要な全体再構築の仕組み、実行手順、公開確認の流れを解説します。

全体再構築と公開フロー

記事保存と再構築の違い

記事の保存・公開停止・削除では、その記事の詳細HTMLだけを更新します。

記事保存
├── DBを保存
├── その記事の詳細HTMLを更新
└── 関連ページを未反映として記録

トップページ、通常一覧、アーカイブ、sitemap.xmlへ反映するには再構築が必要です。

関連ページを再構築する

未反映のコンテンツタイプがあると、左メニューへ通知が出ます。「関連ページ再構築へ」からサイト管理を開き、対象タイプの「関連ページを再構築」を実行します。

対象タイプがnewsの場合、次を更新します。

  • src/news/配下の公開対象HTMLとアーカイブ
  • どのコンテンツタイプにも属さない共通・固定HTML
  • sitemap.xml

ほかのコンテンツタイプ配下と記事詳細は更新しません。すべて成功すると、そのタイプの未反映通知だけが消えます。

全体を再構築する

テンプレート、共通部品、複数タイプに関係するHTMLを変更した場合は、「全体を再構築」を実行します。

記事詳細
  ↓ 全件成功
固定HTML・通常一覧
  ↓ 全件成功
全件・カテゴリ・年・月アーカイブ
  ↓ 全件成功
古いアーカイブ生成物の整理
  ↓ 成功
sitemap.xml
  ↓
完了

1件でも失敗すると、その場所で後続処理を停止します。

再構築に失敗した場合

画面に次が表示されます。

  • 失敗した工程
  • URL、src相対パス、または記事ID
  • テンプレート不存在、パス不正、書込み失敗などの原因

復旧手順は次です。

  1. 最初に失敗した対象と原因を確認します。
  2. DB記事、schema、src HTML、共通部品、パス、権限の該当箇所を直します。
  3. ユーザーがもう一度再構築します。
  4. 最後まで成功したことを確認します。

CMSはエラーを飛ばして公開せず、失敗項目だけを自動再実行しません。途中まで更新されたファイルも自動で元へ戻しません。

古いアーカイブHTML

最初のアーカイブ再構築成功時にruntime/archive_manifest.jsonを作成します。初回は既存ファイルを自動削除しません。

2回目以降は、前回CMSが生成した記録と今回の生成結果を比較し、不要になったアーカイブHTMLだけを削除します。

例: 1ページ10件で、記事が21件から15件へ減った場合

前回: index.html、index_2.html、index_3.html
今回: index.html、index_2.html
削除: index_3.html

manifestに記録されていないファイル、現在srcにある固定HTML、記事詳細、アップロードファイルは削除しません。

manifestが壊れている、不正パスを含む、削除対象がシンボリックリンクの場合は、安全のため再構築を停止します。

自動削除されないもの

  • slug変更前の記事HTML
  • カテゴリ変更前の記事HTML
  • type path変更前の記事HTML
  • srcから削除した通常固定HTML
  • 投稿で差し替えた古いアップロードファイル

これらはサーバー担当者が対象を確認して整理します。