Cloudflare Workers for nybegynnere

Workers vs. «vanlig hosting»

Tradisjonelt: server som alltid kjører. Workers: funksjoner som kjører ved forespørsel. For statisk side + lite API er det ofte enklere og billigere enn VPS.

Cloudflare Assets holder dist/ fra Vite build. Worker kjører først (run_worker_first) for redirect og API.

Typiske oppgaver i stacken jeg dokumenterer

• 301 www og http → https canonical host.
• /api/subscribe → MailerLite (se MailerLite-oppsett).
• AI/markdown: valgfritt markdown for assistenter (Stien ut).
• 404: not_found_handling med egen 404-side.

wrangler og deploy

wrangler.jsonc definerer Worker-navn, assets, routes. wrangler deploy etter npm run build. CI på Cloudflare Workers Builds bruker monorepo-script med override per app (stienut, snarveien, hub).

Snarveien Del 7 (publiser) er handholdt første deploy.

Secrets

API-nøkler settes med wrangler secret put, ikke i git. Lokalt: .env for dev middleware. Samme subscribe-modul begge steder.

Slik så det ut hos meg

stienut.holisti.no, snarveien.holisti.no og hub deployes som separate Workers med egne wrangler-filer. Subscribe-logikk deles fra lib/subscribe.mjs. Første gang var forvirrende. Nå er mønsteret gjentakbart.

Prerender + Assets gir SEO HTML per route. Worker gir kontroll uten å miste statisk hastighet.

Med AI

Cloudflare Workers feilsøk:
Worker: [navn]
Problem: [deploy feiler / subscribe 500 / redirect loop]
wrangler.jsonc snippet: [lim inn config UTEN secrets]
Hva sjekke? Norsk, steg for steg.

html_handling og canonical

Jeg bruker drop-trailing-slash slik canonical uten skråstrek er konsistent. Redirect www og http til https host. Små detaljer, men de påvirker hvilken URL Google og AI lagrer.

Lokal vs prod

npm run dev for UX. npm run build og statisk server eller wrangler for prerender-sjekk. Ikke stol på Vite preview for title per path.

Første deploy-sjekkliste

Før du sier «live»: build uten feil, wrangler deploy fullført, https fungerer, www redirecter, test subscribe med egen e-post, sjekk én dyp route for riktig title i kildekoden. Én time sjekkliste slår panikk neste morgen.

Hvis subscribe feiler i prod men virker i dev: sammenlign secrets og group ID. Det er klassikeren.

Når du ikke trenger Worker ennå

Første grunnmur på Stien ut kan bruke enklere hosting eller mal. Worker blir relevant når du vil egen API, redirect-disiplin og samme stack som Snarveien. Ikke last deg med Worker før du har noe å deploye.