chore(examples): multitenant deploys example

Author: NathanFlurry

examples/multitenant-deploys/Dockerfile

@@ -0,0 +1,27 @@
+FROM node:18-alpine
+
+WORKDIR /app
+
+# Install rivet CLI
+RUN apk add --no-cache curl unzip
+RUN curl -fsSL https://get.rivet.gg/install.sh | sh
+
+# Copy package files and install dependencies
+COPY package.json yarn.lock ./
+RUN yarn install --frozen-lockfile
+
+# Copy application code
+COPY . .
+
+# Build the application
+RUN yarn build
+
+# Expose the port the app will run on
+EXPOSE 3000
+
+# Create a non-root user
+RUN addgroup -S appgroup && adduser -S appuser -G appgroup
+USER appuser
+
+# Start the application
+CMD ["node", "dist/index.js"]

examples/multitenant-deploys/README.md

@@ -0,0 +1,88 @@
+# Multitenant Deploys for Rivet
+
+A simple Node.js service for handling multi-tenant deployments with Rivet.
+
+## Features
+
+- Accepts source code uploads via a multipart POST request
+- Validates the presence of a Dockerfile
+- Deploys the code to Rivet using `rivet publish`
+- Sets up a custom domain route for the application
+
+## Getting Started
+
+### Prerequisites
+
+- Node.js 18 or higher
+- Yarn package manager
+- Rivet CLI installed
+- A Rivet account with a project and environment
+
+### Environment Variables
+
+You'll need to set the following environment variables:
+
+```bash
+RIVET_CLOUD_TOKEN=your_rivet_token
+RIVET_PROJECT=your_project_id
+RIVET_ENVIRONMENT=your_environment_name
+PORT=3000 # Optional, defaults to 3000
+```
+
+### Installation
+
+```bash
+# Install dependencies
+yarn install
+
+# Start the server
+yarn dev
+```
+
+### Testing
+
+```bash
+yarn test
+```
+
+## API Usage
+
+### Deploy Endpoint
+
+`POST /deploy`
+
+**Request:**
+- Multipart form data
+- Required fields:
+  - `appId`: Unique identifier for the application (3-63 characters, alphanumeric with hyphens)
+  - `Dockerfile`: A valid Dockerfile for the application
+  - Additional files for the application
+
+**Response:**
+```json
+{
+  "success": true,
+  "appId": "your-app-id",
+  "hostname": "your-app-id.example.com",
+  "publishOutput": "Output from rivet publish",
+  "routeUpdate": { /* Response from Rivet routes API */ }
+}
+```
+
+**Error Response:**
+```json
+{
+  "error": "Error message",
+  "message": "Detailed error message"
+}
+```
+
+## Example Usage
+
+```bash
+curl -X POST http://localhost:3000/deploy \
+  -F "appId=my-app" \
+  -F "Dockerfile=@./Dockerfile" \
+  -F "index.js=@./index.js" \
+  -F "package.json=@./package.json"
+```

examples/multitenant-deploys/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "multitenant-deploys",
+  "packageManager": "[email protected]",
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "test": "vitest run",
+    "build": "tsc"
+  },
+  "dependencies": {
+    "@hono/node-server": "^1.7.0",
+    "@rivet-gg/api-full": "workspace:*",
+    "axios": "^1.6.7",
+    "hono": "^4.0.5",
+    "temp": "^0.9.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.19",
+    "@types/temp": "^0.9.4",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.3",
+    "vitest": "^1.2.2"
+  }
+}

examples/multitenant-deploys/src/index.ts

@@ -0,0 +1,135 @@
+import { serve } from "@hono/node-server";
+import { Hono } from "hono";
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import temp from "temp";
+import { RivetClient } from "@rivet-gg/api-full";
+
+// Auto-track and cleanup temp directories/files
+temp.track();
+const execAsync = promisify(exec);
+
+// Config (should be moved to env vars in production)
+const PORT = process.env.PORT || 3000;
+const RIVET_CLOUD_TOKEN = process.env.RIVET_CLOUD_TOKEN;
+const RIVET_PROJECT = process.env.RIVET_PROJECT;
+const RIVET_ENVIRONMENT = process.env.RIVET_ENVIRONMENT;
+
+if (!RIVET_CLOUD_TOKEN || !RIVET_PROJECT || !RIVET_ENVIRONMENT) {
+	console.error(
+		"Missing required environment variables: RIVET_CLOUD_TOKEN, RIVET_PROJECT, RIVET_ENVIRONMENT",
+	);
+	process.exit(1);
+}
+
+const rivet = new RivetClient({ token: RIVET_CLOUD_TOKEN });
+
+const app = new Hono();
+
+app.onError((err, c) => {
+	console.error("Error during operation:", err);
+	return c.json(
+		{
+			error: "Operation failed",
+			message: err instanceof Error ? err.message : String(err),
+		},
+		500,
+	);
+});
+
+app.get("/", (c) => {
+	return c.text("Multitenant Deploy Service");
+});
+
+app.post("/deploy", async (c) => {
+	// Get the form data
+	const formData = await c.req.formData();
+	const appId = formData.get("appId");
+
+	if (!appId || typeof appId !== "string") {
+		return c.json({ error: "Missing or invalid appId" }, 400);
+	}
+
+	// Validate app ID (alphanumeric and hyphens only, 3-30 chars)
+	if (!/^[a-z0-9-]{3,30}$/.test(appId)) {
+		return c.json(
+			{
+				error: "Invalid appId format. Must be 3-30 characters, lowercase alphanumeric with hyphens.",
+			},
+			400,
+		);
+	}
+
+	// Create a temp directory for the files
+	const tempDir = await temp.mkdir("rivet-deploy-");
+
+	// Process and save each file
+	let hasDockerfile = false;
+	for (const [fieldName, value] of formData.entries()) {
+		// Skip non-file fields
+		if (!(value instanceof File)) continue;
+
+		const filePath = path.join(tempDir, fieldName);
+
+		// Ensure parent directory exists
+		await fs.mkdir(path.dirname(filePath), { recursive: true });
+
+		// Write the file
+		await fs.writeFile(filePath, Buffer.from(await value.arrayBuffer()));
+
+		// Check if this is a Dockerfile
+		if (fieldName === "Dockerfile" || fieldName.endsWith("/Dockerfile")) {
+			hasDockerfile = true;
+		}
+	}
+
+	if (!hasDockerfile) {
+		return c.json({ error: "Dockerfile is required" }, 400);
+	}
+
+	// Run rivet publish command
+	console.log(`Publishing app ${appId} from ${tempDir}...`);
+	const tags = {
+		// Differentiates from other actor types
+		kind: "app",
+		// Specify which app this is
+		app: appId,
+	};
+	const publishResult = await execAsync(
+		`RIVET_CLOUD_TOKEN=${RIVET_CLOUD_TOKEN} rivet publish ${appId} ${tempDir} -e ${RIVET_ENVIRONMENT}`,
+		{ maxBuffer: 10 * 1024 * 1024 }, // 10MB buffer for output
+	);
+
+	console.log("Publish output:", publishResult.stdout);
+
+	// TODO: Create containers
+	// TODO: Attach env vars
+
+	// Update the route
+	const hostname = `${appId}.rivet.run`;
+	rivet.routes.update(`app-${appId}`, {
+		project: RIVET_PROJECT,
+		environment: RIVET_ENVIRONMENT,
+		body: {
+			hostname,
+			path: "/",
+			stripPrefix: false,
+			routeSubpaths: true,
+			target: { actors: { selectorTags: tags } },
+		},
+	});
+
+	return c.json({
+		success: true,
+		appId,
+		hostname,
+	});
+});
+
+console.log(`Server starting on port ${PORT}...`);
+serve({
+	fetch: app.fetch,
+	port: Number(PORT),
+});