openpress-deploy

open-press のデプロイ

open-press deploy は、公開リリースの承認ゲートを担います。ユーザーが open-press ドキュメントの設定、確認、ドライラン、または公開を依頼した場合にのみ使用してください。

担当範囲

• openpress/settings.json の "deploy" フィールドにあるデプロイ設定を確認します。
• ターゲットアダプター、ステージングソース、プロジェクト名、確認設定をチェックします。
• デプロイの事前チェックとドライランを実行します。
• シークレットをソースファイルに含めないようにします。
• 公開前に明示的な確認を求めます。
• デプロイ成功後、公開 URL と、含まれている場合は PDF の URL を報告します。

境界

• 汎用 CLI の使用、デプロイ以外の検証、ローカルレビュー、ソースと生成物の境界は openpress が担当します。
• ページアーティファクトの内容と視覚的な完成度は openpress-create-pages が担当します。
• スライドデッキの内容と視覚的な完成度は openpress-create-slide が担当します。
• このスキルは、公開先の確認とデプロイの実行を担当します。

公開デプロイのルール

対象プロジェクトを明示した明確な確認がない限り、絶対に公開しないでください。

確認の適切な形式：

This will publish the current open-press build to Cloudflare Pages project `<projectName>` from `<deploy.source>`.
Do you want me to deploy now?

事前チェック

実際にデプロイする前に、出力の準備ができていることを確認するコマンドを実行します。

npm run build              # validates + renders dist-react/

また、公開対象のソースに未完了を示すマーカーがないか確認します。

rg "\\[TODO:|\\[FIX:|\\[DRAFT:" "press/*/chapters" press/design.md

PDF のサイズ制限

Cloudflare Pages は、25 MB を超えるファイルを受け付けません。複数のプレスリリースを含む PDF や画像の多い PDF は、この制限を超えることがよくあります。

ユーザーが PDF の公開を明示的に依頼しない限り、PDF を含めずにデプロイします。

npm run openpress:deploy -- --confirm --no-pdf

--no-pdf は PDF の生成をスキップし、デプロイ元から PDF を完全に除外します。

PDF のサイズを先に確認する場合：

npm run openpress:pdf
du -sh .deploy/**/*.pdf 2>/dev/null

PDF が 25 MB を超えており、ユーザーがそれでも一般公開を希望する場合は、別のホスト（Cloudflare R2、S3 など）を推奨してください。OpenPress では現在、作成した外部 PDF URL を指定するフィールドを提供していないため、openpress/settings.json に URL を作り出して記載しないでください。納品時の引き継ぎで別途 URL を報告してください。

デプロイコマンド

ドライラン：

npm run openpress:deploy:dry-run -- --no-pdf

明示的な確認後に公開します：

npm run openpress:deploy -- --confirm --no-pdf

--no-pdf を削除できるのは、確認済みの公開対象に PDF を含めることをユーザーが明示的に指定した場合のみです。

リファレンスを読むタイミング

• Cloudflare Pages の設定作成や修復、プロジェクトのセットアップ、Wrangler の認証要件、または UI のデプロイボタンの動作を確認する場合は、references/cloudflare-pages.md を読んでください。