Deployment
Guidelines for deploying applications powered by an5 ORM across cloud providers and containerized environments.
Active Context: Deploying Typescript application with Googlesheets database.
Production Checklist
Before going live:
- Set
DATABASE_URLsecurely via cloud environment secrets manager. - Configure connection pooling limits appropriate for your container concurrency.
- Enable TLS/SSL connection encryption (
sslmode=require,encrypt=true). - Run automated health check before accepting traffic.
- Verify automated database backup and disaster recovery schedules.
Environment Configuration
Production Connection String
Set DATABASE_URL according to your target cloud database provider:
# Production DATABASE_URL (Active: Googlesheets)
DATABASE_URL=googlesheets://spreadsheetId;clientEmail=service-account@project.iam.gserviceaccount.com;privateKey=your-encoded-key
# Application environment
NODE_ENV=production
LOG_LEVEL=warn
Runtime Initialization
import { createAn5Adapter } from "@an5/adapters";
const db = createAn5Adapter({
connectionString: process.env.DATABASE_URL!,
});
await db.$connect();
Container Deployment (Docker)
Multi-stage Dockerfile tailored for your stack:
FROM node:20-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build
FROM node:20-alpine AS runner
WORKDIR /app
ENV NODE_ENV=production
COPY --from=builder /app/dist ./dist
COPY --from=builder /app/node_modules ./node_modules
EXPOSE 3000
CMD ["node", "dist/index.js"]
Next Steps
- Troubleshooting - Connection diagnostics and common error resolutions
- Configuration - Full runtime options reference