Te wāhanga ipurangi i ngā Cloudflare Workers

Whakatū tētahi wāhanga ipurangi Quire kua whakaiti i ngā Cloudflare Workers.

Ko te hoahoa te docs/architecture/23-ops.md wāhanga 6. Ka mahi ngā Workers i tētahi wāhanga ipurangi kua whakaiti. Kāore kei tōna rohe te ōrite āheinga i ngā Workers (PRD wāhanga 12): ka āraihia i te wā tīmata, me te kī ia ingoa, te mea kāore e taea ana e tēnei wāhi.

Te tū i tēnei whakaputanga

Kua tū te whakarite (apps/web/wrangler.jsonc, te tūtohu cloudflare-module o te Nitro, te hono Hyperdrive me ngā tātaritanga tīmata). Ka hiahiatia e tētahi Worker te kohinga whakarite S3 mō te R2 (QUIRE_STORAGE_DRIVER=s3), tētahi kaiwhakarato tūturu i waenga i ngā tono (QUIRE_REALTIME_DRIVER=durable_objects rānei centrifugo), tētahi kohinga tohono (QUIRE_CACHE_DRIVER=postgres rānei valkey) me tētahi kaiwhakarato īmēra HTTP. Me te kore ēnei, ka ārai te Worker te tīmata, ā, ka kīia i tana rārangi pūrongo ia tautuhinga. Ko te kaiwhakarato Durable Objects tētahi kaihoko o te Worker tūturu i te apps/realtime-worker (tētahi Durable Object ia ara mō te tukunga, te noho tūmatanui me te whakapapa, tētahi ia tāngata mō ngā wehenga); whakaturia ia i te taha, i te āhua raro, rānei whakamahia te Centrifugo.

Ngā wāhanga

Wāhanga	I te Cloudflare
`web`	Tētahi Worker me te `nodejs_compat`
Postgres	O waho, e tae ana ma te Hyperdrive: te `HYPERDRIVE` mō te tūwāhi taupānga, te `REPORT_HYPERDRIVE` mō te tūwāhi pūrongo i tētahi pūtaka ā-tinana. Ka tārua te wāhanga ipurangi ia hono kōrero ki te `DATABASE_URL` me te `QUIRE_REPORT_DATABASE_URL` i te wā tīmata
Ngā kōnae	R2, ma tana API S3 (`S3_ENDPOINT=https://<account>.r2.cloudflarestorage.com`); ka hono te tohu `FILES` ki te pākete
Ngā mahi i muri	pg-boss ma te Hyperdrive i te wā me tukuhia te mahi me tētahi tuhi. Me te `QUIRE_QUEUE_DRIVER=cloudflare` i te kai mahi tautoko, ka haere ngā mahi māmā (ngā whakamōhiotanga me ngā tuku webhook kāore e whakarārangihia) i te wāhi o ngā Cloudflare Queues, nō reira kāore e tono tukutahi ana te Postgres mō ēnei. Ka mahi te kai mahi tautoko i ērua
Tūturu	Te Worker tūturu, te `apps/realtime-worker`, me ngā Durable Objects
`worker`, `scheduler`, `collab`, `content`, ClamAV, Gotenberg, ffmpeg	Tētahi ipupā kaiwāhi tautoko. Kāore e taea e tētahi Worker te mahi i a rātou
Te mātātai	Te aroturuki Worker, e whakawāhia ana i te `wrangler.jsonc`

Ka tuku te REPORT_HYPERDRIVE i te tūwāhi pūrongo mō te pūtaka ā-tinana e kīia ana e te HYPERDRIVE. Kāore e tuku tēnei wāhi i ngā wāhanga e pūmau ana ki ētahi atu pūtaka ā-tinana, i te āhua e ārahitia ana i raro.

Te mea kāore e taea ana

Ka āraihia i te wā tīmata, me te tuhia ia raruraru i te wā kotahi:

Kāore he SMTP. Whakamahia tētahi kaiwhakarato HTTP i te QUIRE_EMAIL_PROVIDER_CONFIG.
Kāore he papa ā-rohe. Me kī te QUIRE_STORAGE_DRIVER i tētahi kohinga āhuatanga.
Kāore he tūturu rānei kohinga i roto i te pū. Ka kore e tohono ngā Workers i tētahi mahi mātā i waenga i ngā tono, nō reira ka āraihia te QUIRE_REALTIME_DRIVER=inprocess me te QUIRE_CACHE_DRIVER=memory.
Kāore he ClamAV, Gotenberg rānei ffmpeg i te Worker. Ka āraihia ngā CLAMAV_URL, GOTENBERG_URL me te FFMPEG_PATH e tautuhia ana i te Worker; tautuhia rātou i te kai mahi tautoko.
Kāore he rōpū pūtaka motuhake. Ka tautuhia ngā hono Hyperdrive o tētahi Worker i te wā whakaturanga, nō reira ka whiwhi tētahi rōpū me tōna ake pūtaka tētahi whārangi mārama “unavailable here”. Whakatematema ia mai i te Compose rānei i te Vercel.

Ā, tētahi mea kāore e āraihia engari me mōhio: kāore e mahi i ngā Workers te whakaahua i mua me te whakahou tūturu ā-tikitiki, ahakoa te āhua e kōrerotia ana e te tuhinga tohutohu o te whakaraupapa. Ka whakaahua ia ara ia tono.

I tēnei wāhi pupuritia ngā whakawhitinga poto, ā, kāore e pupuria ia ā-wāhanga i te karanga kupenga: ka whakatika anō te Hyperdrive i te tū hono i te wā ka hoki te hono ki te pūtuki, nō reira ka tautuhia te horopaki wāhanga ia whakawhitinga.

Te whakaturanga

Hangaia ngā rauemi:

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

Ka tautuhia ngā id Hyperdrive e rua i te apps/web/wrangler.jsonc.

Tautuhia ngā kupu tūmataiti, tētahi ā-wāhanga ma te bun run --bun wrangler secret put <NAME> mai i te 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. Ngā tautuhinga kāore tūmataiti (QUIRE_APP_ORIGIN, QUIRE_CONTENT_ORIGIN, QUIRE_PLATFORM_DOMAINS, QUIRE_DATABASE_ID, S3_ENDPOINT, S3_BUCKET, QUIRE_COLLAB_URL) ka tukuna ki te vars.

Hanga whakaturia mai i te apps/web:

NITRO_PRESET=cloudflare-module bun run build
bun run --bun wrangler deploy

Whakaturia te Worker tūturu, me te QUIRE_REALTIME_WORKER_SECRET o te wāhanga ipurangi me tana kupu tūmataiti tohu hei QUIRE_REALTIME_TOKEN_SECRET (ka tā te wāhanga ipurangi ngā tohu tūturu me tana ake QUIRE_REALTIME_TOKEN_SECRET, rānei me te QUIRE_SECRET_KEY mēnā kāore e tautuhia, nō reira whakamahia tētahi e whakamahia ana e ia), ā, tautuhia te QUIRE_REALTIME_WORKER_URL i te wāhanga ipurangi ki tōna wāhi:
```
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
```
Mō ngā mahi māmā i ngā Cloudflare Queues, hanga tētahi rārangi mō ia mahi māmā, ā, tautuhia ēnei i te kai mahi tautoko (tētahi tohu API e āea ana te pānui me te tuhi i ngā Queues):
```
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, me te QUIRE_QUEUE_PREFIX mēnā kāore te quire-.
Whakatematema te pūrere tautoko i te āhua i te aratohu Vercel, kaupapa 3. Ka tū ngā whakawhiti i reira, i mua i ia whakaturanga Worker.

Ka whakaatuhia tētahi whakarite kāore e tāria i te bun run --bun wrangler tail ma te “The web tier did not start on cloudflare”, i muri i a ia ia tautuhinga hurihia.