Ka papa pūnaewele ma Vercel

Aia ka hoʻolālā ma ka māhele 5 o docs/architecture/23-ops.md. Holo wale ka papa pūnaewele ma Vercel. Holo nā mea ʻē aʻe a pau ma kekahi host hoa āu e mālama ai; he koi nō ia.

Kūlana o kēia mana

Ua mākaukau ka hoʻonohonoho (apps/web/vercel.json, ka hoʻonohonoho mua Nitro vercel, a me nā nānā hoʻomaka). Pono ʻo Vercel i waihona faila kaʻana (QUIRE_STORAGE_DRIVER=s3 a i ʻole azure), mea hoʻokele manawa maoli e hana ana ma waena o nā laʻana hana (QUIRE_REALTIME_DRIVER=sse a i ʻole centrifugo), a me mea hoʻolako leka uila HTTP. Inā ʻaʻohe o lākou, hōʻole ka papa pūnaewele e hoʻomaka a papa inoa kona moʻolelo i kēlā me kēia hoʻonohonoho i nele.

Nā ʻāpana

ʻĀpana	Kahi e holo ai
`web`	Vercel Functions, Bun runtime: nā ʻaoʻao, REST, MCP, LTI, nā webhook i loaʻa
`worker`, `scheduler`, `collab`, `content`	Host hoa: Fly, Railway, ECS, a i ʻole kou host Docker ponoʻī me `docker/compose.yaml`
Postgres	Waho, ma hope o pooler hana: Neon, Supabase, a i ʻole RDS me PgBouncer
Nā faila	S3 a i ʻole R2. ʻAʻohe disk paʻa
Nā hana hope	Hoʻokomo ʻia e pg-boss i loko o ka hana noi, holo ʻia e ka worker hoa. Me `QUIRE_QUEUE_DRIVER=vercel` ma ka worker hoa, holo nā hana māmā (nā leka hoʻomaopopo ʻole i hoʻonohonoho ʻia a me nā hoʻouna webhook) ma o Vercel Queues (`VERCEL_QUEUE_REGION`, `VERCEL_QUEUE_TOKEN`), i ʻole e huli ʻia lākou ma Postgres pool
Nā hana hoʻihoʻi	Ka scheduler hoa. ʻAʻohe ala Vercel Cron no ka mea hala ka palena manawa o kahi cron e hana ana i loko o ka function
Nā kaha	OpenTelemetry i kāu collector, `OTEL_EXPORTER_OTLP_ENDPOINT`

Nā mea hiki ʻole i kēia wahi

Nānā ka papa pūnaewele i kēia mau mea i ka hoʻomaka ʻana a hōʻole, me ka inoa o kēlā me kēia pilikia, ma kahi o ka hāʻule ʻana ma hope i ka leka uila mua hiki ʻole ke hoʻouna:

ʻAʻohe SMTP. Hoʻopaʻa ʻo Vercel i ka SMTP puka. E hoʻonoho iā QUIRE_EMAIL_PROVIDER_CONFIG i mea hoʻolako HTTP (Postmark, SES, Mailgun, SendGrid, a i ʻole Resend). Hōʻole ʻia QUIRE_SMTP_URL.
ʻAʻohe disk kūloko. Hōʻole ʻia QUIRE_STORAGE_DRIVER=local.
ʻAʻohe hoʻomanaʻo kaʻana ma waena o nā kāhea. Hōʻole ʻia QUIRE_REALTIME_DRIVER=inprocess. Kaupalena ʻia nā hanana i hoʻouna ʻia e ke kikowaena i ka palena manawa o ka function; hoʻohui hou ka client me cursor, no laila ʻaʻole nalowale kekahi hanana, akā ʻaʻohe ʻike noho.
Kaupalena ʻia nā waihona ʻikepili tenant i hoʻopaʻa ʻia ma kahi o ʻewalu, no ka mea, he pool pilina hou kēlā me kēia ma kahi kaiapuni hiki ʻole ke kaʻana i nā pool.

Hoʻouka hana

E hana i papahana Vercel mai ka waihona code me Papa Kuhikuhi Kumu apps/web. Hoʻonohonoho ʻo apps/web/vercel.json i nā kauoha hoʻouka a kūkulu (NITRO_PRESET=vercel) a lawelawe iā /sw.js me ka ʻole o ka cache.
E hoʻonoho i nā loli kaiapuni. Mai docker/.env.example, ma ka liʻiliʻi: QUIRE_DEPLOY_TARGET=vercel, QUIRE_APP_ORIGIN, QUIRE_CONTENT_ORIGIN, QUIRE_PLATFORM_DOMAINS, QUIRE_SECRET_KEY, QUIRE_MASTER_KEY, DATABASE_URL (helu wahi pooler), QUIRE_REPORT_DATABASE_URL, QUIRE_AUDIT_DATABASE_URL, QUIRE_DATABASE_ID, QUIRE_EMAIL_PROVIDER_CONFIG, QUIRE_MAIL_FROM, nā hoʻonohonoho waihona, a me QUIRE_COLLAB_URL a me QUIRE_COLLAB_SIGNING_KEY e kuhikuhi ana i ka lawelawe collab a ka host hoa. Hoʻohana ʻia QUIRE_REPORT_DATABASE_URL no ka waihona ʻikepili kino i kapa ʻia e DATABASE_URL. No kēlā me kēia waihona ʻikepili hou i hoʻopaʻa inoa ʻia, hoʻohui i kona URL pilina quire_report ponoʻī i nā kaiapuni web a me worker, a laila e hoʻopaʻa inoa i kona inoa loli kaiapuni ma ke ʻano env:NAME ma ka console paepae. Hāʻule paʻa ka helu ʻikepili inā nele ka URL hōʻike o ia waihona.
Ma ka host hoa, holo iā docker/compose.yaml me ka lawelawe web ʻole, a me ka docker/.env like:
```
docker compose -f docker/compose.yaml up -d migrate init worker scheduler collab content
```
Holo nā neʻe ʻikepili ma laila ma mua o ka hoʻoikaika ʻia ʻana o kēlā me kēia Vercel deploy.
Hoʻouka i ka hana. Inā hōʻole ʻia ka hoʻonohonoho, hoʻomaka ka moʻolelo function me “The web tier did not start on vercel” a papa inoa i kēlā me kēia hoʻonohonoho e hoʻololi ai.

Hōʻano hou

E neʻe mua i ka ʻikepili mai ka host hoa; a laila e hoʻoikaika i ka hoʻouka Vercel hou, a ma hope e hoʻololi mālie i nā worker o ka host hoa, e like me ke kaʻina ma upgrade.md. He hoʻihoʻi code ka hoʻihoʻi koke Vercel a palekana mau i loko o hoʻokahi mana.