Deployment Guide

npm install -g wrangler

# Start Wrangler dev server
npm run dev

# Or with custom port
npx wrangler dev --port 8788

# Execute ensemble
curl -X POST http://localhost:8787/api/v1/execute \
  -H "Content-Type: application/json" \
  -d '{
    "ensemble": "hello-world",
    "input": {
      "name": "World"
    }
  }'

# .dev.vars (DO NOT COMMIT)
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GROQ_API_KEY=gsk_...

.dev.vars

npx wrangler login

name = "my-conductor-project"
main = "src/index.ts"
compatibility_date = "2024-01-01"

[ai.gateway]
id = "my-gateway"
cache_ttl = 3600

[[kv_namespaces]]
binding = "CACHE"
id = "your-kv-namespace-id"

[[d1_databases]]
binding = "DB"
database_name = "my-database"
database_id = "your-database-id"

[[r2_buckets]]
binding = "STORAGE"
bucket_name = "my-bucket"

[ai]
binding = "AI"

# Create KV namespace
npx wrangler kv:namespace create CACHE

# Create D1 database
npx wrangler d1 create my-database

# Create R2 bucket
npx wrangler r2 bucket create my-bucket

# Set production secrets
npx wrangler secret put OPENAI_API_KEY
npx wrangler secret put ANTHROPIC_API_KEY
npx wrangler secret put GROQ_API_KEY

# Deploy to production
npm run deploy

# Or deploy with wrangler directly
npx wrangler deploy

https://my-conductor-project.your-subdomain.workers.dev

# wrangler.dev.toml
name = "my-project-dev"

[[kv_namespaces]]
binding = "CACHE"
id = "dev-kv-id"

# wrangler.prod.toml
name = "my-project-prod"

[[kv_namespaces]]
binding = "CACHE"
id = "prod-kv-id"

# Development
npx wrangler deploy --config wrangler.dev.toml

# Production
npx wrangler deploy --config wrangler.prod.toml

[vars]
ENVIRONMENT = "production"
API_VERSION = "v1"
LOG_LEVEL = "info"

console.log('Environment:', env.ENVIRONMENT);

api.example.com CNAME my-project.your-subdomain.workers.dev

curl https://api.example.com/health

# .github/workflows/deploy.yml
name: Deploy to Cloudflare Workers

on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'

      - name: Install dependencies
        run: npm ci

      - name: Run tests
        run: npm test

      - name: Deploy to Cloudflare Workers
        uses: cloudflare/wrangler-action@v3
        with:
          apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}

# .gitlab-ci.yml
deploy:
  image: node:20
  script:
    - npm ci
    - npm test
    - npx wrangler deploy
  only:
    - main
  variables:
    CLOUDFLARE_API_TOKEN: $CLOUDFLARE_API_TOKEN

# Tail logs in real-time
npx wrangler tail

# Filter logs
npx wrangler tail --search "error"

// Structured logging
console.log(JSON.stringify({
  level: 'info',
  message: 'Ensemble executed',
  ensemble: 'company-intelligence',
  duration: result.executionTime,
  success: result.success
}));

// Log errors with context
console.error(JSON.stringify({
  level: 'error',
  message: error.message,
  stack: error.stack,
  ensemble: ensembleName,
  input: sanitizeInput(input),
  timestamp: Date.now()
}));

# Member-level caching
- member: expensive-operation
  cache:
    ttl: 3600

config:
  routing: cloudflare-gateway  # Persistent caching

// Lazy load built-in members
import { getBuiltInRegistry } from '@ensemble-edge/conductor';
const member = getBuiltInRegistry().create('scrape', config, env);

const startTime = performance.now();
const result = await executor.executeEnsemble(ensemble, input);
const duration = performance.now() - startTime;

console.log('Performance:', {
  ensemble: ensemble.name,
  duration,
  cacheHits: result.metadata?.cacheHits,
  memberCount: result.metadata?.memberCount
});

// Implement rate limiting
const rateLimiter = new Map<string, number>();

export default {
  async fetch(request, env, ctx) {
    const clientId = request.headers.get('x-client-id');

    // Check rate limit
    const requestCount = rateLimiter.get(clientId) || 0;
    if (requestCount > 100) {
      return new Response('Rate limit exceeded', { status: 429 });
    }

    rateLimiter.set(clientId, requestCount + 1);

    // Process request
    return handleRequest(request, env, ctx);
  }
};

npx wrangler deployments list

npx wrangler whoami
npx wrangler list

curl https://your-worker.workers.dev/health

npm run build
npx wrangler deploy

npx wrangler kv:namespace create CACHE
# Add ID to wrangler.toml

npx wrangler secret put API_KEY