Dokümantasyon production dağıtımı

Production dokümantasyonu https://docs.munderecat.com/ adresinde Cloudflare Pages tarafından public olarak sunulur. Web reader’ın Access sınırı bu docs deploymentından bağımsızdır.

Dağıtım sözleşmesi

Deploy docs production workflow’u yalnız main dalında ve manuel olarak çalışır. Workflow:

1. dokümantasyon içerik ve deployment contract testlerini çalıştırır;
2. artifact’ı tam github.sha ve production URL’siyle üretir;
3. statik artifact sınırlarını, linkleri, navigasyonu, aramayı ve release kimliğini yüklemeden önce doğrular;
4. çıktıyı munderecat-docs Pages projesinin main production branch’ine yükler;
5. Pages API’deki production deployment commit’ini, canonical root redirectini, navigation linkini ve Pagefind aramasını public smoke ile doğrular.

Workflow her push’ta çalışmaz. Aynı anda yalnız bir docs production deploy’una izin verir ve devam eden deploy’u yeni bir tetikleme yüzünden iptal etmez.

GitHub environment

GitHub docs-production environment’ı şu değerleri taşır:

Tür	Ad	Amaç
Secret	CLOUDFLARE_API_TOKEN	Yalnız Cloudflare Pages Edit
Variable	CLOUDFLARE_ACCOUNT_ID	Hedef Cloudflare hesabı
Variable	MUNDERECAT_CLOUDFLARE_PAGES_PROJECT	munderecat-docs
Variable	MUNDERECAT_DOCS_PRODUCTION_URL	https://docs.munderecat.com/

Deploy tokenı DNS, Access, Workers, R2 veya Supabase üzerinde yetki taşımaz. Workflow Access uygulamasını veya web exposure’ını değiştirmez.

Artifact kimliği

Production build’i deployment.json içine exact Git nesnesini ve public URL’yi yazar. release.json, sitemap ve canonical bağlantılar da aynı custom domaini kullanır. Böylece Pages’e yüklenen statik dosyalar başka bir commit veya origin adına yeniden etiketlenemez.

Yerel build eşdeğeri temiz bir Git ağacında şöyledir:

corepack pnpm --filter @munderecat/docs build:production -- \
  "$(git rev-parse HEAD)" \
  "https://docs.munderecat.com/"

Normal geliştirme için production deploy veya canlı smoke gerekmez; make docs-check yeterlidir.

Canlı smoke

Deploy sonrası workflow smoke:production ile https://docs.munderecat.com/ üzerinden user/ landing sayfasını, aynı-origin rehber bağlantısını, Pagefind sonucunu, release.json ve deployment.json kimliklerini doğrular. Bu kontrol public production exposure ile uyumludur; web Worker üzerindeki Access ayarına dokunmaz.