---
title: "Vefþrepið á Vercel"
description: "Keyrðu vefþrep Quire á Vercel með fylgdarhýsil."
image: "https://docs.quirelms.com/og.png"
---

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

# Vefþrepið á Vercel

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

Hönnunin er í `docs/architecture/23-ops.md` kafla 5. Vercel keyrir aðeins
vefþrepið. Allt annað keyrir á fylgdarhýsil sem þú rekur, og hann er ekki
valkvæmur.

## Staðan í þessari útgáfu <!--quire:status-in-this-release-->

Uppsetningin er til staðar (`apps/web/vercel.json`, `vercel` Nitro-
forstillingin og ræsingarathuganirnar). Vercel þarf sameiginlega skráageymslu
(`QUIRE_STORAGE_DRIVER=s3` eða `azure`), rauntímarekil sem virkar þvert á
tilvik falla (`QUIRE_REALTIME_DRIVER=sse` eða `centrifugo`) og tölvupóstveitu
yfir HTTP. Án þeirra neitar vefþrepið að ræsa og annállinn nefnir hverja
vantarandi stillingu.

## Hlutarnir <!--quire:the-pieces-->

| Hlutur | Hvar hann keyrir |
| --- | --- |
| `web` | Vercel Functions, Node-keyrslutími: síður, REST, MCP, LTI, mótteknir vefkrókar |
| `worker`, `scheduler`, `collab`, `content` | Fylgdarhýsill: Fly, Railway, ECS eða eigin Docker-hýsill með `docker/compose.yaml` |
| Postgres | Ytri, bak við viðskiptapúllara: Neon, Supabase eða RDS með PgBouncer |
| Skrár | S3 eða R2. Enginn varanlegur diskur er til staðar |
| Bakgrunnsverk | Sett í biðröð með pg-boss innan viðskipta beiðninnar, keyrð af fylgdarvinnsluvélinni. Með `QUIRE_QUEUE_DRIVER=vercel` á fylgdarvinnsluvélinni fara léttu verkin (óraðaðar tilkynningar og vefkrókasendingar) í gegnum Vercel Queues (`VERCEL_QUEUE_REGION`, `VERCEL_QUEUE_TOKEN`), svo púlerað Postgres er ekki kannað fyrir þau |
| Endurtekin verk | Fylgdarstýringin. Engin Vercel Cron-leið er til, því cron sem vinnur inni í falli rennur út á tíma |
| Rekjanleiki | OpenTelemetry til söfnunartækis þíns, `OTEL_EXPORTER_OTLP_ENDPOINT` |

## Hvað þetta markumhverfi getur ekki <!--quire:what-this-target-cannot-do-->

Vefþrepið athugar þetta þegar það ræsir og neitar, og nefnir hvert vandamál,
frekar en að bila síðar við fyrsta tölvupóstinn sem kemst aldrei á leiðarenda:

- **Enginn SMTP.** Vercel lokar á SMTP útfara. Stilltu `QUIRE_EMAIL_PROVIDER_CONFIG`
  á HTTP-veitu (Postmark, SES, Mailgun, SendGrid eða Resend).
  `QUIRE_SMTP_URL` er hafnað.
- **Enginn staðbundinn diskur.** `QUIRE_STORAGE_DRIVER=local` er hafnað.
- **Ekkert sameiginlegt minni milli kalla.** `QUIRE_REALTIME_DRIVER=inprocess`
  er hafnað. Atburðir sendir af þjóni eru takmarkaðir við tímamörk fallsins;
  biðlarinn tengist aftur með bendli, svo enginn atburður tapast, en viðvera
  er ekki í boði.
- **Föst leigjendagagnagrunna eru takmarkaðir** við um átta, því hver þeirra er
  enn einn tengingapúllarinn í umhverfi sem getur ekki deilt púllurum.

## Uppsetning <!--quire:deploying-->

1. Stofnaðu Vercel-verkefni úr geymslunni með **Root Directory**
   `apps/web`. `apps/web/vercel.json` stillir uppsetningar- og byggingarskipanirnar
   (`NITRO_PRESET=vercel`) og sendir `/sw.js` án skyndiminningar.
2. Stilltu umhverfisbreyturnar. Frá `docker/.env.example`, að minnsta kosti:
   `QUIRE_DEPLOY_TARGET=vercel`, `QUIRE_APP_ORIGIN`, `QUIRE_CONTENT_ORIGIN`,
   `QUIRE_PLATFORM_DOMAINS`, `QUIRE_SECRET_KEY`, `QUIRE_MASTER_KEY`,
   `DATABASE_URL` (fang púllarans), `QUIRE_REPORT_DATABASE_URL`,
   `QUIRE_AUDIT_DATABASE_URL`, `QUIRE_DATABASE_ID`,
   `QUIRE_EMAIL_PROVIDER_CONFIG`, `QUIRE_MAIL_FROM`, geymslustillingarnar,
   og `QUIRE_COLLAB_URL` og `QUIRE_COLLAB_SIGNING_KEY` sem benda á
   samvinnuþjónustu fylgdarhýsilsins.
   `QUIRE_REPORT_DATABASE_URL` tilheyrir líkamlega gagnagrunninum sem
   `DATABASE_URL` nefnir. Fyrir hvern viðbótarskráðan gagnagrunn skaltu bæta
   hans eigin `quire_report` tengislóð við bæði vef- og vinnsluumhverfið og
   skráðu síðan nafn umhverfisbreytunnar sem `env:NAME` í stjórnborði
   vettvangsins. Greining bilar lokuð ef skýrsluslóð þess gagnagrunns vantar.
3. Á fylgdarhýslnum skaltu keyra `docker/compose.yaml` án `web`
   þjónustunnar, með sömu `docker/.env`:
   ```sh
   docker compose -f docker/compose.yaml up -d migrate init worker scheduler collab content
   ```
   Flutningar keyra þar, áður en hverri Vercel-útgáfu er hleypt út.
4. Settu út. Við hafnaðri uppsetningu byrjar annáll fallsins á „The web
   tier did not start on vercel“ og telur upp hverja stillingu til að breyta.

## Uppfærsla <!--quire:upgrading-->

Flyttu fyrst frá fylgdarhýslnum, hleypdu síðan út nýju Vercel-
útgáfunni og veltu síðan vinnsluvélum fylgdarhýsilsins: röðin í
[upgrade.md](/is/ops/upgrade/). Augnabliksbakfærsla Vercel er bakfærsla kóða og er
alltaf örugg innan útgáfu.

Source: https://docs.quirelms.com/is/ops/vercel/index.mdx