cloudflare-d1 0.1.0

data/examples/roda/setup.sh

@@ -0,0 +1,128 @@
+#!/bin/bash
+set -e
+
+echo "🚀 Cloudflare D1 + Roda + Containers Setup"
+echo "=========================================="
+echo ""
+
+# Check prerequisites
+echo "Checking prerequisites..."
+
+if ! command -v wrangler &> /dev/null; then
+    echo "❌ Wrangler CLI not found. Install with: npm install -g wrangler"
+    exit 1
+fi
+echo "✅ Wrangler CLI found"
+
+if ! command -v docker &> /dev/null; then
+    echo "❌ Docker not found. Please install Docker Desktop"
+    exit 1
+fi
+echo "✅ Docker found"
+
+if ! docker info &> /dev/null; then
+    echo "❌ Docker daemon not running. Please start Docker Desktop"
+    exit 1
+fi
+echo "✅ Docker daemon running"
+
+if ! command -v bundle &> /dev/null; then
+    echo "❌ Bundler not found. Install with: gem install bundler"
+    exit 1
+fi
+echo "✅ Bundler found"
+
+echo ""
+echo "Prerequisites check complete!"
+echo ""
+
+# Install Ruby dependencies
+echo "📦 Installing Ruby dependencies..."
+bundle install
+echo "✅ Dependencies installed"
+echo ""
+
+# Create D1 database
+echo "🗄️  Creating D1 database..."
+echo "Running: wrangler d1 create roda-api-db"
+echo ""
+
+DB_OUTPUT=$(wrangler d1 create roda-api-db 2>&1 || true)
+echo "$DB_OUTPUT"
+
+if echo "$DB_OUTPUT" | grep -q "already exists"; then
+    echo "Database already exists, continuing..."
+    DATABASE_ID=$(echo "$DB_OUTPUT" | grep -oE '[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}' | head -1)
+elif echo "$DB_OUTPUT" | grep -q "database_id"; then
+    DATABASE_ID=$(echo "$DB_OUTPUT" | grep -oE '[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}' | head -1)
+else
+    echo "⚠️  Could not automatically extract database ID"
+    echo "Please create a database manually with: wrangler d1 create roda-api-db"
+    exit 1
+fi
+
+echo ""
+echo "✅ Database created/found: $DATABASE_ID"
+echo ""
+
+# Get account ID
+echo "📋 Getting your Cloudflare account ID..."
+ACCOUNT_ID=$(wrangler whoami 2>&1 | grep -oE 'Account ID: [0-9a-f]+' | cut -d' ' -f3)
+
+if [ -z "$ACCOUNT_ID" ]; then
+    echo "⚠️  Could not automatically get account ID"
+    echo "Please run: wrangler whoami"
+    read -p "Enter your Account ID: " ACCOUNT_ID
+fi
+
+echo "✅ Account ID: $ACCOUNT_ID"
+echo ""
+
+# Set secrets
+echo "🔐 Setting secrets..."
+echo ""
+
+echo "Setting CLOUDFLARE_ACCOUNT_ID..."
+echo "$ACCOUNT_ID" | wrangler secret put CLOUDFLARE_ACCOUNT_ID
+
+echo ""
+echo "Now you need to set your API token."
+echo "Get it from: https://dash.cloudflare.com/profile/api-tokens"
+echo "Create a token with 'Edit Cloudflare Workers' permissions"
+echo ""
+read -p "Enter your API Token: " API_TOKEN
+echo "$API_TOKEN" | wrangler secret put CLOUDFLARE_API_TOKEN
+
+echo ""
+echo "Setting DATABASE_ID..."
+echo "$DATABASE_ID" | wrangler secret put DATABASE_ID
+
+echo ""
+echo "✅ Secrets configured"
+echo ""
+
+# Deploy
+echo "🚀 Deploying to Cloudflare..."
+echo ""
+echo "This will take a few minutes on first deployment..."
+echo ""
+
+wrangler deploy
+
+echo ""
+echo "============================================"
+echo "✅ Deployment complete!"
+echo ""
+echo "Your API is available at:"
+echo "https://roda-d1-api.your-subdomain.workers.dev"
+echo ""
+echo "Get your URL with: wrangler deployments list"
+echo ""
+echo "Test your API:"
+echo "  curl https://your-url/health"
+echo "  curl https://your-url/users"
+echo ""
+echo "View logs:"
+echo "  wrangler tail"
+echo ""
+echo "============================================"

data/examples/roda/worker.js

@@ -0,0 +1,119 @@
+/**
+ * Cloudflare Worker that routes requests to Roda container instances
+ */
+
+/**
+ * Container class configuration
+ * Extends the Container base class to configure the Ruby/Roda application
+ */
+export class RodaContainer extends Container {
+  // Port the container application listens on
+  defaultPort = 8080;
+
+  // Time to keep container alive after inactivity
+  sleepAfter = "10m";
+
+  // Static environment variables (set at class level)
+  // For dynamic values, override in fetch() using startAndWaitForPorts()
+  envVars = {
+    PORT: "8080",
+    RACK_ENV: "production",
+  };
+
+  // Lifecycle hooks
+  override onStart() {
+    console.log("[RodaContainer] Container starting...");
+  }
+
+  override onStop() {
+    console.log("[RodaContainer] Container stopping...");
+  }
+
+  override onError(error) {
+    console.error("[RodaContainer] Error:", error);
+  }
+}
+
+/**
+ * Main Worker export
+ * Handles incoming requests and routes them to container instances
+ */
+export default {
+  async fetch(request, env, ctx) {
+    const url = new URL(request.url);
+
+    // Health check endpoint (runs on Worker, not container)
+    if (url.pathname === "/health") {
+      return new Response(
+        JSON.stringify({
+          status: "healthy",
+          service: "roda-d1-api",
+          timestamp: new Date().toISOString(),
+        }),
+        {
+          headers: { "content-type": "application/json" },
+        }
+      );
+    }
+
+    // Get container instance
+    // Using getByName with a fixed ID creates a single stateful instance
+    // For load balancing across multiple instances, use getById with random IDs
+    const containerStub = env.RODA_CONTAINER.getByName("main");
+
+    // Start container with runtime environment variables (secrets)
+    await containerStub.startAndWaitForPorts({
+      startOptions: {
+        envVars: {
+          CLOUDFLARE_ACCOUNT_ID: env.CLOUDFLARE_ACCOUNT_ID,
+          CLOUDFLARE_API_TOKEN: env.CLOUDFLARE_API_TOKEN,
+          DATABASE_ID: env.DATABASE_ID,
+        },
+      },
+    });
+
+    try {
+      // Forward the request to the container
+      const response = await containerStub.fetch(request);
+
+      // Add custom headers
+      const headers = new Headers(response.headers);
+      headers.set("X-Powered-By", "Cloudflare-Containers");
+
+      return new Response(response.body, {
+        status: response.status,
+        statusText: response.statusText,
+        headers: headers,
+      });
+    } catch (error) {
+      console.error("Container request failed:", error);
+
+      return new Response(
+        JSON.stringify({
+          error: "Container unavailable",
+          message: error.message,
+        }),
+        {
+          status: 503,
+          headers: { "content-type": "application/json" },
+        }
+      );
+    }
+  },
+};
+
+/**
+ * Alternative routing strategies:
+ *
+ * 1. Load balanced (stateless):
+ *    const containerId = Math.floor(Math.random() * 3);
+ *    const containerStub = env.RODA_CONTAINER.getById(containerId.toString());
+ *
+ * 2. Session-based (sticky):
+ *    const sessionId = request.headers.get("X-Session-ID") || "default";
+ *    const containerStub = env.RODA_CONTAINER.getByName(sessionId);
+ *
+ * 3. Path-based routing:
+ *    const pathHash = hashCode(url.pathname);
+ *    const containerStub = env.RODA_CONTAINER.getById(pathHash.toString());
+ */

data/examples/roda/wrangler.jsonc

@@ -0,0 +1,68 @@
+{
+  // Application name - must be unique across Cloudflare
+  "name": "roda-d1-api",
+
+  // Compatibility date for Workers runtime
+  "compatibility_date": "2024-01-01",
+
+  // Main Worker entrypoint
+  "main": "worker.js",
+
+  // Container configuration
+  "containers": [
+    {
+      // Unique identifier for this container class
+      "class_name": "RodaContainer",
+
+      // Path to Dockerfile (wrangler will build and push)
+      "image": "./Dockerfile",
+
+      // Maximum number of concurrent container instances
+      "max_instances": 10,
+
+      // Instance type: lite, basic, standard-1, standard-2, standard-3, standard-4
+      "instance_type": "lite",
+    },
+  ],
+
+  // Durable Objects bindings
+  "durable_objects": {
+    "bindings": [
+      {
+        // Binding name used in Worker code
+        "name": "RODA_CONTAINER",
+
+        // Must match container class_name
+        "class_name": "RodaContainer",
+      },
+    ],
+  },
+
+  // Migrations to register Durable Objects
+  "migrations": [
+    {
+      "tag": "v1",
+      // Must use new_sqlite_classes for container-backed Durable Objects
+      "new_sqlite_classes": ["RodaContainer"],
+    },
+  ],
+
+  // Environment variables (non-sensitive)
+  "vars": {
+    "PORT": "8080",
+  },
+
+  // Secrets (set with: wrangler secret put <NAME>)
+  // Run these commands:
+  //   wrangler secret put CLOUDFLARE_ACCOUNT_ID
+  //   wrangler secret put CLOUDFLARE_API_TOKEN
+  //   wrangler secret put DATABASE_ID
+
+  // Optional: Custom routes
+  "routes": [
+    {
+      "pattern": "roda-d1-api.your-domain.com/*",
+      "custom_domain": true,
+    },
+  ],
+}