---
title: "Վեբ շերտը Cloudflare Workers-ում"
description: "Գործարկեք Quire-ի սահմանափակ վեբ շերտը Cloudflare Workers-ում։"
image: "https://docs.quirelms.com/og.png"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.quirelms.com/hy/llms.txt
> Use this file to discover all available pages before exploring further.

# Վեբ շերտը Cloudflare Workers-ում

<span id="the-web-tier-on-cloudflare-workers"></span>

Դիզայնը նկարագրված է `docs/architecture/23-ops.md` փաստաթղթի 6-րդ բաժնում։
Workers-ը գործարկում է վեբ շերտի սահմանափակ տարբերակը։ Workers-ում
հնարավորությունների ամբողջական համապատասխանությունը նախատեսված չէ (PRD-ի
12-րդ բաժին)․ այս թիրախում չաջակցվողը գործարկման պահին մերժվում է՝ ըստ անվան։

## Այս թողարկման վիճակը <!--quire:status-in-this-release-->

Կարգավորումն առկա է (`apps/web/wrangler.jsonc`, Nitro-ի
`cloudflare-module` նախադրված տարբերակը, Hyperdrive կամուրջը և մեկնարկի
ստուգումները)։ Worker-ին անհրաժեշտ է R2-ի համար S3-ին համատեղելի պահեստ
(`QUIRE_STORAGE_DRIVER=s3`), հարցումներում աշխատող իրական ժամանակի վարորդ
(`QUIRE_REALTIME_DRIVER=durable_objects` կամ `centrifugo`), համատեղ
օգտագործվող քեշ (`QUIRE_CACHE_DRIVER=postgres` կամ `valkey`) և HTTP էլ․ փոստի
ծառայություն։ Առանց դրանց Worker-ը մերժում է գործարկվել, և մատյանում նշվում է
յուրաքանչյուր կարգավորում։ Durable Objects վարորդը իրական ժամանակի Worker-ի
հաճախորդն է `apps/realtime-worker`-ում (ալիքի համար մեկ Durable Object՝
տարածման, ներկայության և պատմության համար, և անձի համար մեկ օբյեկտ՝ կապի
անջատումների համար)․ տեղակայեք այն վեբ շերտի հետ միասին՝ ստորև նշված կարգով,
կամ օգտագործեք Centrifugo։

## Բաղադրիչներ <!--quire:the-pieces-->

| Բաղադրիչ | Cloudflare-ում |
| --- | --- |
| `web` | Worker՝ `nodejs_compat` աջակցությամբ |
| Postgres | Արտաքին՝ Hyperdrive-ի միջոցով․ `HYPERDRIVE`՝ հավելվածի դերի, իսկ `REPORT_HYPERDRIVE`՝ նույն ֆիզիկական բազայի հաշվետվությունների դերի համար։ Վեբ շերտը մեկնարկելիս կապի յուրաքանչյուր տող պատճենում է `DATABASE_URL` և `QUIRE_REPORT_DATABASE_URL` փոփոխականներում |
| Ֆայլեր | R2՝ իր S3 API-ի միջոցով (`S3_ENDPOINT=https://<account>.r2.cloudflarestorage.com`)․ `FILES` կապը միացնում է պահեստը |
| Ֆոնային աշխատանքներ | pg-boss՝ Hyperdrive-ի միջոցով, երբ գրառումը պետք է հերթ դրվի գրելու գործողության հետ։ Ուղեկից աշխատողի վրա `QUIRE_QUEUE_DRIVER=cloudflare` արժեքի դեպքում թեթև աշխատանքները (չդասակարգված ծանուցումների և վեբհուքների առաքումները) դրա փոխարեն անցնում են Cloudflare Queues-ով, ուստի Postgres-ը դրանց համար չի հարցվում։ Ուղեկից աշխատողը երկուսն էլ գործարկում է |
| Իրական ժամանակ | Իրական ժամանակի Worker՝ `apps/realtime-worker`, Durable Objects-ով |
| `worker`, `scheduler`, `collab`, `content`, ClamAV, Gotenberg, ffmpeg | Ուղեկից կոնտեյներային հոսթ։ Worker-ը չի կարող դրանք գործարկել |
| Հետագծում | Workers-ի դիտարկելիություն, միացված `wrangler.jsonc`-ում |

`REPORT_HYPERDRIVE`-ը տրամադրում է հաշվետվությունների դերը `HYPERDRIVE`-ով
նշված ֆիզիկական բազայի համար։ Այս թիրախը չի սպասարկում լրացուցիչ ֆիզիկական
տվյալների բազաներին ամրագրված հաճախորդների, ինչպես նկարագրված է ստորև։

## Ինչ չի կարող անել այս թիրախը <!--quire:what-this-target-cannot-do-->

Գործարկման պահին մերժվում են բոլոր խնդիրները, և դրանք թվարկվում են միասին․

- **SMTP չկա։** `QUIRE_EMAIL_PROVIDER_CONFIG`-ում օգտագործեք HTTP ծառայություն։
- **Տեղային սկավառակ չկա։** `QUIRE_STORAGE_DRIVER`-ը պետք է նշի օբյեկտների պահեստ։
- **Նույն գործընթացում իրական ժամանակ կամ քեշ չկա։** Workers-ի հարցումները
  ընդհանուր հիշողություն չունեն, ուստի `QUIRE_REALTIME_DRIVER=inprocess` և
  `QUIRE_CACHE_DRIVER=memory` արժեքները մերժվում են։
- **Worker-ում ClamAV, Gotenberg կամ ffmpeg չկա։** Worker-ի վրա սահմանված
  `CLAMAV_URL`, `GOTENBERG_URL` և `FFMPEG_PATH` արժեքները մերժվում են․ դրանք
  սահմանեք ուղեկից աշխատողի վրա։
- **Նվիրված տվյալների բազայով կազմակերպություններ չկան։** Worker-ի Hyperdrive
  կապերը ամրագրվում են տեղակայման պահին, ուստի սեփական բազա ունեցող
  կազմակերպության համար ցուցադրվում է հստակ «այստեղ անհասանելի է» էջը։
  Սպասարկեք նրան Compose-ից կամ Vercel-ից։

Կա նաև մի բան, որը չի մերժվում, բայց պետք է իմանաք․ **նախնական render-ն ու
ինկրեմենտալ ստատիկ վերակառուցումը Workers-ում չեն աշխատում**՝ անկախ շրջանակի
փաստաթղթերի պնդումներից։ Յուրաքանչյուր ուղի render է արվում ամեն հարցման
ժամանակ։

Այս թիրախում գործարքները կարճ պահեք և երբեք մի պահեք ցանցային կանչի ընթացքում․
Hyperdrive-ը կապը խումբ վերադարձնելիս վերականգնում է աշխատաշրջանի վիճակը,
ուստի հաճախորդի համատեքստը սահմանվում է յուրաքանչյուր գործարքի համար։

## Տեղակայում <!--quire:deploying-->

1. Ստեղծեք ռեսուրսները․
   ```sh
   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-ի երկու ID-ներն էլ տեղադրեք `apps/web/wrangler.jsonc` ֆայլում։
2. Սահմանեք գաղտնի արժեքները՝ մեկ առ մեկ գործարկելով
   `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`։ Սովորական կարգավորումները
   (`QUIRE_APP_ORIGIN`, `QUIRE_CONTENT_ORIGIN`, `QUIRE_PLATFORM_DOMAINS`,
   `QUIRE_DATABASE_ID`, `S3_ENDPOINT`, `S3_BUCKET`, `QUIRE_COLLAB_URL`)
   տեղադրեք `vars`-ում։
3. Կառուցեք և տեղակայեք `apps/web` թղթապանակից․
   ```sh
   NITRO_PRESET=cloudflare-module bun run build
   bun run --bun wrangler deploy
   ```
4. Տեղակայեք իրական ժամանակի Worker-ը՝ վեբ շերտի
   `QUIRE_REALTIME_WORKER_SECRET`-ով և դրա token-ի գաղտնի բանալին որպես
   `QUIRE_REALTIME_TOKEN_SECRET`։ Վեբ շերտը ստորագրում է իրական ժամանակի
   token-ներն իր սեփական `QUIRE_REALTIME_TOKEN_SECRET`-ով կամ, եթե այն
   սահմանված չէ, `QUIRE_SECRET_KEY`-ով․ օգտագործեք դրանցից այն մեկը, որն այն
   օգտագործում է։ Վեբ շերտում `QUIRE_REALTIME_WORKER_URL`-ը սահմանեք այդ
   ծառայության հասցեով․
   ```sh
   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-ում թեթև աշխատանքների համար ստեղծեք մեկ հերթ՝ ըստ
   թեթև հերթի տեսակի, և սահմանեք դրանք ուղեկից աշխատողի վրա (հերթերը կարդալու
   ու գրելու իրավունքով API token)․
   ```sh
   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-ի ուղեցույցի](/hy/ops/vercel/), 3-րդ քայլի։
   Միգրացիաներն այնտեղ են գործարկվում՝ Worker-ի յուրաքանչյուր տեղակայումից
   առաջ։

Մերժված կազմաձևումը երևում է `bun run --bun wrangler tail` հրամանի ելքում՝ «The web tier did not start on cloudflare» տողով, որին հաջորդում են փոխելու ենթակա բոլոր կարգավորումները։

Source: https://docs.quirelms.com/hy/ops/cloudflare/index.mdx