全体再構築と公開フロー
共通パーツやテンプレート変更時に必要な全体再構築の仕組み、実行手順、公開確認の流れを解説します。
全体再構築と公開フロー
記事保存と再構築の違い
記事の保存・公開停止・削除では、その記事の詳細HTMLだけを更新します。
記事保存
├── DBを保存
├── その記事の詳細HTMLを更新
└── 関連ページを未反映として記録
トップページ、通常一覧、アーカイブ、sitemap.xmlへ反映するには再構築が必要です。
関連ページを再構築する
未反映のコンテンツタイプがあると、左メニューへ通知が出ます。「関連ページ再構築へ」からサイト管理を開き、対象タイプの「関連ページを再構築」を実行します。
対象タイプがnewsの場合、次を更新します。
src/news/配下の公開対象HTMLとアーカイブ- どのコンテンツタイプにも属さない共通・固定HTML
sitemap.xml
ほかのコンテンツタイプ配下と記事詳細は更新しません。すべて成功すると、そのタイプの未反映通知だけが消えます。
全体を再構築する
テンプレート、共通部品、複数タイプに関係するHTMLを変更した場合は、「全体を再構築」を実行します。
記事詳細
↓ 全件成功
固定HTML・通常一覧
↓ 全件成功
全件・カテゴリ・年・月アーカイブ
↓ 全件成功
古いアーカイブ生成物の整理
↓ 成功
sitemap.xml
↓
完了
1件でも失敗すると、その場所で後続処理を停止します。
再構築に失敗した場合
画面に次が表示されます。
- 失敗した工程
- URL、
src相対パス、または記事ID - テンプレート不存在、パス不正、書込み失敗などの原因
復旧手順は次です。
- 最初に失敗した対象と原因を確認します。
- DB記事、schema、
srcHTML、共通部品、パス、権限の該当箇所を直します。 - ユーザーがもう一度再構築します。
- 最後まで成功したことを確認します。
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- 投稿で差し替えた古いアップロードファイル
これらはサーバー担当者が対象を確認して整理します。