सीधे सामग्री पर जाएँ
Quireदस्तावेज़
हिन्दी

Cloudflare Workers पर वेब टियर

Cloudflare Workers पर Quire का सीमित वेब टियर चलाएँ।

Markdown के रूप में देखें

डिज़ाइन docs/architecture/23-ops.md के अनुभाग 6 में है। Workers सीमित वेब टियर चलाते हैं। Workers पर feature parity दायरे से बाहर है (PRD का अनुभाग 12): यह लक्ष्य जो नहीं कर सकता, उसे शुरू होते समय नाम से अस्वीकार किया जाता है।

इस रिलीज़ में स्थिति

कॉन्फ़िगरेशन तैयार है (apps/web/wrangler.jsonc, cloudflare-module Nitro preset, Hyperdrive bridge और startup जाँच)। Worker को R2 के लिए S3-संगत storage (QUIRE_STORAGE_DRIVER=s3), requests के बीच realtime driver (QUIRE_REALTIME_DRIVER=durable_objects या centrifugo), साझा cache (QUIRE_CACHE_DRIVER=postgres या valkey) और HTTP email provider चाहिए। इनके बिना Worker शुरू होने से मना करता है और log हर setting का नाम देता है। Durable Objects driver apps/realtime-worker में realtime Worker का client है (fan-out, presence और history के लिए प्रति channel एक Durable Object, disconnect के लिए प्रति व्यक्ति एक); नीचे बताए अनुसार इसे साथ deploy करें या Centrifugo इस्तेमाल करें।

हिस्से

हिस्सा Cloudflare पर
web nodejs_compat वाला Worker
Postgres बाहरी, Hyperdrive से पहुँचा: application role के लिए HYPERDRIVE, उसी physical database पर report role के लिए REPORT_HYPERDRIVE। शुरू होते समय web tier हर connection string को DATABASE_URL और QUIRE_REPORT_DATABASE_URL में कॉपी करता है
फ़ाइलें R2, इसकी S3 API से (S3_ENDPOINT=https://<account>.r2.cloudflarestorage.com); FILES binding bucket जोड़ता है
Background jobs लिखने वाली request के साथ job जोड़ना हो तो Hyperdrive पर pg-boss। Companion worker पर QUIRE_QUEUE_DRIVER=cloudflare हो तो हल्के jobs (बिना क्रम की सूचनाएँ और webhook delivery) Cloudflare Queues से जाते हैं, इसलिए उनके लिए Postgres poll नहीं होता। Companion worker दोनों चलाता है
Realtime Durable Objects वाला realtime Worker, apps/realtime-worker
worker, scheduler, collab, content, ClamAV, Gotenberg, ffmpeg Companion container host। Worker इन्हें नहीं चला सकता
Tracing Workers observability, wrangler.jsonc में चालू

REPORT_HYPERDRIVE, HYPERDRIVE द्वारा नामित physical database के लिए report role देता है। नीचे बताए अनुसार यह लक्ष्य अतिरिक्त physical databases पर pin किए tenant की सेवा नहीं करता।

यह लक्ष्य क्या नहीं कर सकता

शुरू होते समय सभी समस्याएँ एक साथ सूचीबद्ध करके अस्वीकार:

  • SMTP नहीं। QUIRE_EMAIL_PROVIDER_CONFIG में HTTP provider इस्तेमाल करें।
  • स्थानीय disk नहीं। QUIRE_STORAGE_DRIVER को object storage बताना होगा।
  • In-process realtime या cache नहीं। Workers requests के बीच memory साझा नहीं करते, इसलिए QUIRE_REALTIME_DRIVER=inprocess और QUIRE_CACHE_DRIVER=memory अस्वीकार होते हैं।
  • Worker में ClamAV, Gotenberg या ffmpeg नहीं। Worker पर सेट CLAMAV_URL, GOTENBERG_URL और FFMPEG_PATH अस्वीकार हैं; इसके बजाय companion worker पर सेट करें।
  • समर्पित database वाले संगठन नहीं। Worker के Hyperdrive bindings deploy के समय तय होते हैं, इसलिए अपना database रखने वाले संगठन को स्पष्ट “यहाँ उपलब्ध नहीं” पृष्ठ मिलता है। उसे Compose या Vercel से सेवा दें।

और एक बात जिसे अस्वीकार नहीं किया जाता, पर जानना चाहिए: framework के दस्तावेज़ कुछ भी कहें, Workers पर prerendering और incremental static regeneration काम नहीं करते। हर route हर request पर render होता है।

इस लक्ष्य पर transactions छोटे रखें और network call के दौरान कभी खुला न रखें: connection pool में लौटने पर Hyperdrive session state रीसेट करता है, इसलिए tenant context हर transaction के लिए सेट होता है।

डिप्लॉय करना

  1. Resources बनाएँ: 
    bun run --bun wrangler hyperdrive create quire-app --connection-string="postgres://quire_app:...@db.example.com:5432/quire"
bun run --bun wrangler hyperdrive create quire-report --connection-string="postgres://quire_report:...@db.example.com:5432/quire"
bun run --bun wrangler r2 bucket create quire-files
bun run --bun wrangler queues create quire-jobs
    दोनों Hyperdrive IDs को apps/web/wrangler.jsonc में रखें।
  2. एक-एक करके secrets bun run --bun wrangler secret put <NAME> से सेट करें, यह apps/web से चलाएँ: QUIRE_SECRET_KEY, QUIRE_MASTER_KEY, QUIRE_EMAIL_PROVIDER_CONFIG, S3_ACCESS_KEY_ID, S3_SECRET_ACCESS_KEY, QUIRE_COLLAB_SIGNING_KEY, QUIRE_REALTIME_WORKER_SECRET। सामान्य settings (QUIRE_APP_ORIGIN, QUIRE_CONTENT_ORIGIN, QUIRE_PLATFORM_DOMAINS, QUIRE_DATABASE_ID, S3_ENDPOINT, S3_BUCKET, QUIRE_COLLAB_URL) vars में रखें।
  3. apps/web से build और deploy करें: 
    NITRO_PRESET=cloudflare-module bun run build
bun run --bun wrangler deploy
  4. Realtime Worker को web tier का QUIRE_REALTIME_WORKER_SECRET और उसका token secret QUIRE_REALTIME_TOKEN_SECRET के रूप में देकर deploy करें (web tier अपने QUIRE_REALTIME_TOKEN_SECRET, या वह unset हो तो QUIRE_SECRET_KEY से realtime tokens पर हस्ताक्षर करता है; जो वह इस्तेमाल करता है वही लें)। Web tier पर QUIRE_REALTIME_WORKER_URL को उसके पते पर सेट करें: 
    cd apps/realtime-worker
bun run --bun wrangler secret put QUIRE_REALTIME_WORKER_SECRET
bun run --bun wrangler secret put QUIRE_REALTIME_TOKEN_SECRET
bun run --bun wrangler deploy
  5. Cloudflare Queues पर हल्के jobs के लिए हर हल्की queue के लिए एक queue बनाएँ और companion worker पर ये सेट करें (Queues पर read और write अधिकार वाला API token): 
    bun run --bun wrangler queues create quire-events-notifications
bun run --bun wrangler queues create quire-events-notifications-dead
bun run --bun wrangler queues create quire-events-webhooks
bun run --bun wrangler queues create quire-events-webhooks-dead
    QUIRE_QUEUE_DRIVER=cloudflare, CLOUDFLARE_ACCOUNT_ID, CLOUDFLARE_QUEUES_TOKEN, और QUIRE_QUEUE_PREFIX सेट करें यदि उसका मान quire- न हो।
  6. Vercel मार्गदर्शिका के चरण 3 के अनुसार companion host चलाएँ। हर Worker deployment से पहले migration वहाँ चलती है।

अस्वीकृत कॉन्फ़िगरेशन bun run --bun wrangler tail में “The web tier did not start on cloudflare” के बाद बदलने वाली हर setting सहित दिखता है।

नेविगेशन

खोजने के लिए लिखें…

↑↓ नेविगेट करें↵ चुनेंEsc बंद करें