Розробка Serverless Functions для сайту (Cloudflare Workers)

Розробка Serverless Functions для сайту (Cloudflare Workers)

Cloudflare Workers працюють на V8 isolates — не на Node.js і не на контейнерах. Це дає холодний старт менше 1 мс та виконання на 300+ edge-вузлах по всьому світу. Безплатний тариф включає 100 000 запитів на день.

Відмінність від AWS Lambda та Vercel Functions

Workers запускаються на кожному Cloudflare PoP — користувач з Москви отримує відповідь від найближчого вузла, не з us-east-1. Це критично для завдань, чутливих до latency. Обмеження: Workers використовують Web API, а не Node.js API — fs, child_process, нативні модулі недоступні.

Базовий Worker

// src/index.ts
export default {
  async fetch(request: Request, env: Env): Promise<Response> {
    const url = new URL(request.url);

    if (url.pathname === "/api/contact" && request.method === "POST") {
      return handleContact(request, env);
    }

    if (url.pathname === "/api/geo") {
      return handleGeo(request);
    }

    return new Response("Not found", { status: 404 });
  },
};

async function handleContact(request: Request, env: Env): Promise<Response> {
  const data = await request.json<{ name: string; email: string; message: string }>();

  // Відправлення через Resend API
  const emailResponse = await fetch("https://api.resend.com/emails", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${env.RESEND_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      from: "[email protected]",
      to: ["[email protected]"],
      subject: `Повідомлення від ${data.name}`,
      text: `${data.name} (${data.email}): ${data.message}`,
    }),
  });

  if (!emailResponse.ok) {
    return Response.json({ error: "Email send failed" }, { status: 500 });
  }

  return Response.json({ ok: true });
}

// Геолокація з заголовків Cloudflare
function handleGeo(request: Request): Response {
  const cf = (request as any).cf;
  return Response.json({
    country: cf?.country,
    city: cf?.city,
    timezone: cf?.timezone,
    latitude: cf?.latitude,
    longitude: cf?.longitude,
  });
}

Wrangler та розгортання

# wrangler.toml
name = "my-site-api"
main = "src/index.ts"
compatibility_date = "2024-11-01"

[vars]
ENVIRONMENT = "production"

[[routes]]
pattern = "yourdomain.com/api/*"
zone_name = "yourdomain.com"

npm install -g wrangler
wrangler login
wrangler dev          # локальна розробка
wrangler deploy       # розгортання

Секрети:

wrangler secret put RESEND_API_KEY
wrangler secret put DATABASE_URL

Workers KV: зберігання даних

KV — key-value сховище, з гарантією eventual consistency. Підходить для кешу, сесій, конфігурації.

// Прив'язка в wrangler.toml
// [[kv_namespaces]]
// binding = "CACHE"
// id = "abc123..."

export default {
  async fetch(request: Request, env: Env & { CACHE: KVNamespace }) {
    const cacheKey = new URL(request.url).pathname;
    const cached = await env.CACHE.get(cacheKey);

    if (cached) {
      return new Response(cached, {
        headers: { "Content-Type": "application/json", "X-Cache": "HIT" }
      });
    }

    const data = await fetchFreshData(request);
    await env.CACHE.put(cacheKey, JSON.stringify(data), { expirationTtl: 300 });

    return Response.json(data);
  }
};

D1: SQLite на edge

D1 — serverless SQLite-база даних Cloudflare. Підходить для невеликих обсягів даних (до 10 GB).

export default {
  async fetch(request: Request, env: Env & { DB: D1Database }) {
    const { results } = await env.DB.prepare(
      "SELECT * FROM products WHERE category = ? ORDER BY created_at DESC LIMIT 20"
    ).bind("electronics").all();

    return Response.json(results);
  }
};

Обмеження Workers

• CPU time: 10 мс (безплатно), 30 с (Paid)
• Пам'ять: 128 MB
• Немає Node.js built-ins (fs, path, crypto — лише Web Crypto API)
• Немає довгоживучих з'єднань до PostgreSQL (використовуйте Hyperdrive або HTTP API)

Hyperdrive: PostgreSQL з Workers

export default {
  async fetch(request: Request, env: Env & { HYPERDRIVE: Hyperdrive }) {
    const client = new Client({ connectionString: env.HYPERDRIVE.connectionString });
    await client.connect();

    const result = await client.query("SELECT * FROM users WHERE id = $1", [userId]);
    await client.end();

    return Response.json(result.rows[0]);
  }
};

Hyperdrive проксирує з'єднання до зовнішної PostgreSQL через connection pool на стороні Cloudflare, розв'язуючи проблему latency при підключенні до віддаленої БД.

Терміни

Базовий Worker з маршрутизацією та 3–5 ендпоїнтами — 2–3 дні. Інтеграція KV та D1, CI/CD через GitHub Actions — плюс 2 дні.