[Review 2026-08-15][Pages] legacy managed runtimeとcustom deployment移行判断を全公開書籍で再評価する

[ootakazuhiko]

位置付け

親ロードマップ: #265
基準日: 2026-08-15（Asia/Tokyo）

背景

#258では、repository側で制御可能なNode.js 20対象ActionをNode.js 24対応へ移行した。一方、GitHub管理のlegacy pages-build-deploymentが生成するactions/checkout@v4 / actions/upload-artifact@v4等のwarningはrepository sourceから直接修正できない。

#258の最終バッチでは変更対象27冊を母数としてlegacy 22 / workflow 5が報告された。別の全カタログ監査では公開書籍全体を母数として異なる件数が観測されているため、本Issueでは実行時点のdocs/_data/catalog.jsonを唯一の母数として再集計する。

warning解消だけを目的に全legacy Pagesをcustom deploymentへ一括移行しない。GitHub側runtime更新、実障害、運用コスト、rollback能力を比較して判断する。

通常実行日

2026-08-15より前は実装・設定変更を行わず、次の前倒し条件が発生した場合のみ即時調査する。

前倒し条件

• GitHub managed Pages runtimeの更新
• runtime理由によるmanaged run失敗
• Pages APIのstatusがbuilt以外
• 公開URLがHTTP 200以外
• managed workflow warningがfailureへ昇格
• GitHubから明示的な移行期限が発表された

評価項目

• Pages API build_type, source, status
• latest successful deployment
• warning / annotation
• public HTTP
• deployment duration / failure rate
• repository管理workflowの有無
• build command / output directory / base path
• custom deploymentへの移行工数
• build identity / production smoke / drift detection
• rollback
• maintenance ownership
• private / preview / paid-free境界

---

Codex CLI Runbook

0. 起動

2026-08-15以降、または前倒し条件発生時に実行する。

RUNROOT="$HOME/work/iteka-pages-review-20260815-$(date +%Y%m%d-%H%M%S)"
mkdir -p "$RUNROOT"
cd "$RUNROOT"
git init

codex exec \
  -C "$RUNROOT" \
  --sandbox workspace-write \
  -a on-request \
  "GitHub Issue itdojp/it-engineer-knowledge-architecture#271 と親Issue #265、完了Issue #258をgh CLIで全文取得してください。現在日が2026-08-15より前で前倒し条件もない場合は、実装・設定変更・cloneを行わず状況だけ報告してください。実行可能な場合は、ポータルcatalogの全published書籍を母数としてPages API、managed warning、deployment、公開HTTP、移行コストを再監査し、代表pilotが必要な場合だけ小規模に実施してください。全冊一括移行は禁止です。証跡と移行判断を記録し、完了条件を満たした場合だけ#271をcloseしてください。"

1. 実行可否

date -Iseconds
gh issue view 271 --repo itdojp/it-engineer-knowledge-architecture --comments
gh issue view 258 --repo itdojp/it-engineer-knowledge-architecture --comments

• Asia/Tokyoの現在日を確認
• 前倒し条件の有無を確認
• 実行根拠を#271へコメント

2. catalog母数

gh repo clone itdojp/it-engineer-knowledge-architecture it-engineer-knowledge-architecture

docs/_data/catalog.jsonから次を抽出する。

• status=published
• repository
• pagesUrl
• repoVisibility
• publicationScope
• countingGroup

catalog件数、重複、missing URLを検証する。過去の27冊、42冊等の固定数を母数にしない。

3. GitHub API監査

各公開書籍についてAPIを集約し、rate limitを考慮する。

取得:

• repository default branch SHA
• Pages API
• latest workflow runs
• latest pages-build-deploymentまたはcustom deploy
• annotations取得可能範囲
• environment deployment

分類:

• legacy managed
• workflow custom
• private management + public Pages
• unavailable / misconfigured

出力:

• 決定的JSON / TSV
• #271のMarkdown summary

4. 公開監査

各pagesUrlで:

• HTTP status
• expected title / marker
• base path
• 404 behavior
• key route
• cache-busting / no-cache
• TLS / redirect

custom deployment書籍では可能ならbuild identity、expected SHA、production smoke、drift detectionを確認する。

5. warning評価

legacy managed warningについて:

• GitHub側runtime / action version
• warningかfailureか
• repository sourceから変更可能か
• GitHub official announcement / release / deprecation
• current impact

warningのみでrun成功・Pages正常の場合は、それだけでcustom移行を決定しない。

6. custom deployment費用対効果

代表書籍を構成別に分類する。

• standard Jekyll
• custom Jekyll
• mdBook
• private management / free preview
• previewを必要とする書籍

評価:

• workflow template再利用性
• permissions
• artifact
• environment
• baseurl
• build identity
• post-deploy smoke
• drift detection
• rollback
• required secrets
• maintenance cost

移行pilotが必要なら1〜2冊だけsource Issue / PRを作成する。全冊一括移行はしない。

7. 判断カテゴリ

各repoを次へ分類する。

1. managed継続
2. GitHub側更新待ち
3. custom deployment pilot候補
4. 即時移行必要
5. Pages設定修復必要
6. archive / catalog整理必要

各判断に根拠、owner、期限、前倒し条件を記載する。

8. 最終確認

• 全catalog published repoを同じ母数で監査
• Pages build type集計
• HTTP非200 0、またはsource Issue作成済み
• managed warningとrepository管理warningを分離
• custom移行判断とrollbackを記録
• pilotを行った場合review / CI / main / Pages証跡
• Open pilot PR 0
• workspace cleanup

完了条件

• 2026-08-15時点または前倒し時点の全公開書籍Pages inventoryがある
• legacy / workflow件数がcatalog母数と一致
• GitHub managed runtimeの最新状態を一次情報で確認
• 書籍ごとの継続／移行／待機判断がある
• 移行pilotは最大2冊で検証済み、または不要理由を記録
• 全冊一括移行を行っていない
• #265へ結果を反映

対象外

• warningだけを理由とする全冊custom移行
• 書籍本文変更
• formatter pin
• build hygiene warning
• PR preview専用問題（[P0][Automation] canonical build・scheduled maintenance・PR previewの正しさを2冊で確立する #267）

[ootakazuhiko]

2026-07-16 JST時点では基準日2026-08-15より前です。Runbookの実行可否条件に従い、実装・設定変更・全catalog clone・一括監査は開始しません。前倒し条件（managed Pages runtime変更、runtime起因failure、Pages status非built、公開HTTP非200、warningのfailure昇格、GitHub明示期限）は今回の入口確認では観測していません。2026-08-15または前倒し条件発生時に、Runbookどおりcatalogを唯一の母数として再監査します。

[ootakazuhiko]

実行可否の再確認（2026-07-17 JST）

• 現在時刻: 2026-07-17T18:56:13+09:00
• 通常実行日: 2026-08-15
• 判定: 通常実行日前で、前倒し条件も確認できないためRunbook本体は開始しない

入口確認の証跡

• ポータルPages API: status=built / build_type=workflow
• ポータル公開URL: HTTP 200
• ポータル最新Pages drift run 29546445979: success。default branch SHA、latest deployment SHA、public build-info SHAがd6bf69cda7c478b770a84b7264754a71e9279cf4で一致し、production smokeもPASS
• 既知legacy代表3冊（github-guide-for-beginners-book、github-workflow-book、GitHub-AgentOps-book）:
  • Pages APIはいずれもstatus=built / build_type=legacy
  • latest managed pages-build-deploymentはいずれもsuccess
  • 公開URLはいずれもHTTP 200
  • annotationは既知のcheckout@v4 / upload-artifact@v4 Node.js 20 warningのみで、failure昇格なし
• GitHub公式Changelogの現行記載は、2026-06-16からJavaScript ActionをNode.js 24で既定実行し、Node.js 20削除は2026年秋予定という#258監査時点と同じ移行契約。managed Pages固有の新たな移行期限は確認できない:
  • https://github.blog/changelog/2025-09-19-deprecation-of-node-20-on-github-actions-runners/

Runbook制約の適用

2026-08-15より前は実装・設定変更を行わないという正本指示に従い、全catalog clone、一括Pages監査、設定変更、移行pilotは実施していません。#271はOpenのまま保持し、2026-08-15または前倒し条件発生時に全published catalogを唯一の母数として実行します。

[ootakazuhiko]

Phase 9前倒し条件の検出（2026-07-23 JST）

Phase 8のlive Portfolio Health収集で、#271本文の前倒し条件「Pages APIのstatusがbuilt以外」に該当するpublic repositoryを1件確認しました。

• repository: itdojp/ai-agent-engineering-book
• default branch / current SHA: main / e89ad5a36eea2e8afa037515d3dd19c1424f7eb7
• Pages API: build_type=workflow / status=errored
• exact-main custom Pages run 29698075699: success
• latest github-pages deployment 5513092136: success
• public root: HTTP 200

したがって「公開停止」ではなく、Pages API statusと成功済みworkflow/deployment/runtimeの不整合です。ただしstatus非built自体が正本Runbookの前倒し条件なので、2026-08-15を待たずPhase 9を実行する根拠が成立しました。

#276は依存順を要求しているため、現在openのPhase 8 PR #279をread-only GitHub App設定後にnormal mergeし、main / Pages / productionを完了してから#271の全catalog監査へ進みます。この入口確認では#271対象の設定変更、clone、pilot、全冊移行は行っていません。