自動更新¶
ソースリポジトリで docs/** を main に push すると、ハブが集約して公開する。
ソースリポジトリで docs/** を main に push
→ trigger-docs-hub workflow
→ docs-hub へ repository_dispatch (docs-updated)
→ 集約 + zensical build
→ Cloudflare Pages (docs-hub) へデプロイ
このハブ自身の docs/hub/ などを直したときは、docs-hub の main push がそのまま build を起動する。
トリガー一覧¶
| きっかけ | どこで | 結果 |
|---|---|---|
docs/** を main に push |
finance-manager / pve-infra / home-kitchen | ハブへ通知 → build + deploy |
| hub の設定、運用 docs を push | docs-hub | build + deploy |
| Actions の手動実行 | どこからでも | 同上 |
Secrets¶
docs-hub¶
| Secret | 用途 |
|---|---|
DOCS_READ_TOKEN |
ソースリポジトリの Contents: Read |
CLOUDFLARE_API_TOKEN |
Pages へのデプロイ |
CLOUDFLARE_ACCOUNT_ID |
Cloudflare Account ID |
ソースリポジトリ（finance-manager / pve-infra / home-kitchen）¶
| Secret | 用途 |
|---|---|
DOCS_HUB_DISPATCH_TOKEN |
docs-hub へ repository_dispatch する |
PAT はリポジトリごとに新規発行しなくてよい
DOCS_HUB_DISPATCH_TOKEN は 1 本の Fine-grained PAT を作って、
各ソースリポジトリの Secrets に同じ値を登録すれば足りる。
対象リポジトリは docs-hub のみ、権限は Contents: Read and Write である。
DOCS_READ_TOKEN も 1 本で足りる。
新しいソースを足すときは docs-hub の Secrets を触らず、
その PAT の Repository access にリポジトリを追加する。
手順の詳細は ソースリポジトリの追加 にある。