Astro + Cloudflare: Деплой на Edge за 5 минут

# 1. Установите Wrangler CLI
npm install -g wrangler

# 2. Войдите в аккаунт
wrangler login

# 3. Соберите проект
npm run build

# 4. Задеплойте
wrangler pages deploy dist/ --project-name my-site

npx astro add cloudflare

// astro.config.mjs
import { defineConfig } from 'astro/config';
import cloudflare from '@astrojs/cloudflare';

export default defineConfig({
  output: 'server', // Или 'hybrid' для частичного SSR
  adapter: cloudflare({
    platformProxy: {
      enabled: true, // Локальная эмуляция Cloudflare в dev
    },
  }),
});

---
// src/pages/profile.astro — только эта страница рендерится на сервере
export const prerender = false; // Отключить пресоздание

const user = await getUserFromCookie(Astro.request);
---

<h1>Привет, {user.name}!</h1>

# Создать базу данных
wrangler d1 create my-db

# Создать таблицы
wrangler d1 execute my-db --command "
  CREATE TABLE posts (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    title TEXT NOT NULL,
    content TEXT,
    published_at TEXT DEFAULT CURRENT_TIMESTAMP
  )
"

# wrangler.toml
name = "my-site"
compatibility_date = "2026-01-01"

[[d1_databases]]
binding = "DB"
database_name = "my-db"
database_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

// src/pages/api/posts.ts
import type { APIRoute } from 'astro';

export const GET: APIRoute = async ({ locals }) => {
  // locals.runtime.env — доступ к Cloudflare bindings
  const db = locals.runtime.env.DB;

  const { results } = await db
    .prepare('SELECT * FROM posts ORDER BY published_at DESC')
    .all();

  return new Response(JSON.stringify(results), {
    headers: { 'Content-Type': 'application/json' },
  });
};

wrangler kv namespace create "CACHE"

# wrangler.toml
[[kv_namespaces]]
binding = "CACHE"
id = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

// Кэширование API-ответа
export const GET: APIRoute = async ({ locals }) => {
  const kv = locals.runtime.env.CACHE;

  // Попробовать из кэша
  const cached = await kv.get('weather-data', 'json');
  if (cached) return new Response(JSON.stringify(cached));

  // Запросить данные
  const data = await fetch('https://api.weather.com/today').then((r) => r.json());

  // Кэшировать на 1 час
  await kv.put('weather-data', JSON.stringify(data), { expirationTtl: 3600 });

  return new Response(JSON.stringify(data));
};

wrangler r2 bucket create my-uploads

// Загрузка файла через API-роут
export const POST: APIRoute = async ({ request, locals }) => {
  const r2 = locals.runtime.env.MY_BUCKET;
  const formData = await request.formData();
  const file = formData.get('file') as File;

  const key = `uploads/${Date.now()}-${file.name}`;
  await r2.put(key, file.stream(), {
    httpMetadata: { contentType: file.type },
  });

  return new Response(
    JSON.stringify({
      url: `https://your-domain.ru/${key}`,
    }),
  );
};

# Добавить секрет (не попадёт в git)
wrangler secret put STRIPE_SECRET_KEY

# Добавить обычную переменную
wrangler pages secret put PUBLIC_SITE_URL

// В SSR — через locals.runtime.env
const stripeKey = locals.runtime.env.STRIPE_SECRET_KEY;

// В SSG/build-time — через import.meta.env
const siteUrl = import.meta.env.PUBLIC_SITE_URL;

npm run dev
# Локально эмулируются: D1, KV, R2, Workers AI

# .github/workflows/deploy.yml
name: Deploy to Cloudflare Pages
on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
      - run: npm ci
      - run: npm run build
      - uses: cloudflare/pages-action@v1
        with:
          apiToken: ${{ secrets.CF_API_TOKEN }}
          accountId: ${{ secrets.CF_ACCOUNT_ID }}
          projectName: my-site
          directory: dist