Deployment ve CI/CD

Cloudflare Workers'a deploy, production yapılandırması, environment variables ve deployment best practices.

Achidemy, Cloudflare Workers üzerinde çalışır ve Wrangler CLI ile deploy edilir. Bu sayfa deployment sürecini, production yapılandırmasını ve best practices’i açıklar.

Deployment Süreci

1. Build

npm run build

İşlemler:

React Router build (react-router build)
TypeScript type checking (react-router typegen)
Client ve server bundle’ları oluşturulur
Output: build/client/ ve build/server/

2. Deploy

npm run deploy
# veya
npm run build && wrangler deploy

İşlemler:

build/client/ static assets olarak deploy edilir
build/server/ worker code olarak deploy edilir
workers/app.ts worker entry point olarak kullanılır

Production Yapılandırması

Environment Variables

Public Variables: wrangler.toml içinde [vars] bölümünde tanımlanır.

[vars]
BASE_URL = "https://achidemy.net"
BETTER_AUTH_URL = "https://achidemy.net"
GOOGLE_CLIENT_ID = "..."
BUNNY_LIBRARY_ID = "..."
# vb.

Secret Variables: CLI ile eklenir (git’e commit edilmez).

# Veritabanı
wrangler secret put DATABASE_URL

# Stripe
wrangler secret put STRIPE_SECRET_KEY
wrangler secret put STRIPE_WEBHOOK_SECRET

# Exchange Rate API (kur botu için)
wrangler secret put EXCHANGE_API_KEY

# Better Auth
wrangler secret put BETTER_AUTH_SECRET

# Resend (e-posta)
wrangler secret put RESEND_API_KEY

# Bunny
wrangler secret put BUNNY_API_KEY
wrangler secret put BUNNY_STORAGE_KEY
wrangler secret put BUNNY_VIDEO_SECURITY_KEY

Hyperdrive Configuration

Production: Hyperdrive ID wrangler.toml içinde tanımlıdır.

[[hyperdrive]]
binding = "HYPERDRIVE"
id = "59c4a12da58e45d3993436576a163c85"
localConnectionString = "postgresql://..."  # Sadece yerel için

Not: Production’da Hyperdrive üzerinden bağlantı sağlanır; yerel geliştirmede localConnectionString kullanılır (Neon pooler URL’si ile aynı veritabanına işaret etmelidir).

Custom domain ve rotalar (Achidemy)

Worker, apex ve B2B wildcard için aynı uygulamayı sunar. wrangler.toml örneği:

[[routes]]
pattern = "achidemy.net/*"
zone_name = "achidemy.net"

[[routes]]
pattern = "*.achidemy.net/*"
zone_name = "achidemy.net"

DNS’te achidemy.net ve *.achidemy.net için Cloudflare proxy kayıtları bu Worker’a yönlendirilir; SSL için wildcard sertifika kullanılır.

Durable Objects

Production: Durable Object binding’leri wrangler.toml içinde tanımlıdır.

[[durable_objects.bindings]]
name = "CHAT_ROOM"
class_name = "ChatRoom"

[[migrations]]
tag = "v1"
new_sqlite_classes = ["ChatRoom"]

Pre-Deployment Checklist

1. Environment Variables

Tüm secret’lar Cloudflare’de tanımlı mı?
Public variable’lar wrangler.toml içinde güncel mi?
BASE_URL ve BETTER_AUTH_URL production URL’ine ayarlı mı?

2. Database

Migration’lar production DB’ye uygulandı mı?
Hyperdrive ID doğru mu?
Connection string test edildi mi?

3. Stripe

Production Stripe key’leri kullanılıyor mu?
Webhook endpoint production URL’ine ayarlı mı?
Webhook secret production için güncel mi?

4. Build

npm run build hatasız çalışıyor mu?
TypeScript type errors yok mu?
React Router typegen çalışıyor mu?

5. Testing

Yerel testler geçiyor mu? (npm run start)
Critical path’ler test edildi mi? (login, payment, course creation)

Deployment Komutları

Full Deploy

npm run deploy

Adımlar:

npm run build — Build işlemi
wrangler deploy — Cloudflare’e deploy

Manual Deploy

# 1. Build
npm run build

# 2. Type check (opsiyonel ama önerilir)
npm run typecheck

# 3. Deploy
wrangler deploy

Preview Deploy

wrangler deploy --env preview

Kullanım: Production’a deploy etmeden önce test için.

CI/CD Pipeline (Gelecek)

GitHub Actions Örneği

name: Deploy to Cloudflare

on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: actions/setup-node@v3
        with:
          node-version: '18'
      - run: npm ci
      - run: npm run build
      - run: npm run typecheck
      - uses: cloudflare/wrangler-action@v3
        with:
          apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
          accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}

Gereksinimler:

CLOUDFLARE_API_TOKEN — GitHub Secrets’a eklenmeli
CLOUDFLARE_ACCOUNT_ID — GitHub Secrets’a eklenmeli

Rollback Stratejisi

Önceki Versiyona Dönme

# Son deployment'ı görüntüle
wrangler deployments list

# Belirli bir deployment'a rollback
wrangler rollback [deployment-id]

Database Rollback

Migration geri alma:

# Migration dosyasını geri al
# Örnek: Drizzle migration'ı geri almak için SQL script çalıştır
psql $DATABASE_URL < rollback_script.sql

Not: Database rollback dikkatli yapılmalıdır; veri kaybına yol açabilir.

Monitoring ve Alerts

Cloudflare Dashboard

Workers Logs: wrangler tail veya Cloudflare Dashboard
Analytics: Request sayısı, error rate, response time
Durable Objects: Chat room sayısı, WebSocket bağlantıları

Error Tracking

Önerilen: Sentry entegrasyonu

// Production'da error tracking aktif et
if (import.meta.env.PROD) {
  Sentry.captureException(error);
}

Uptime Monitoring

Önerilen: UptimeRobot, Pingdom veya Cloudflare Uptime Monitoring

Ana sayfa: https://achidemy.net
Health check endpoint: /api/health (gelecekte eklenebilir)

Performance Optimization

1. Asset Optimization

Image Optimization: Bunny CDN kullanılır
Code Splitting: React Router otomatik code splitting yapar
Bundle Size: npm run build ile bundle analizi yapılabilir

2. Caching

Static Assets: Cloudflare CDN cache
API Responses: Cache-Control header’ları kullanılabilir
Database: Hyperdrive connection pooling

3. Edge Caching

Cloudflare Cache: Static sayfalar için edge cache
Cache Rules: wrangler.toml veya Cloudflare Dashboard’dan yapılandırılabilir

Troubleshooting

Deployment Hatası

Sorun: wrangler deploy başarısız oluyor.

Çözümler:

Cloudflare API token kontrolü
Account ID kontrolü
wrangler.toml syntax kontrolü
Build output kontrolü (build/ klasörü var mı?)

Runtime Hatası

Sorun: Production’da uygulama çalışmıyor.