Skip to content

Cloud Deployment

Zintrust is designed to run seamlessly on various cloud platforms, from serverless environments to traditional VPS.

Automated Workflows

The easiest way to set up cloud deployment is using the Zintrust CLI to generate GitHub Actions workflows.

bash
# Generate a workflow for AWS Lambda
zin add workflow --platform lambda

# Generate a workflow for Cloudflare Workers
zin add workflow --platform cloudflare

# Generate workflows for all supported platforms
zin add workflow --platform all

This will create a .github/workflows/deploy-cloud.yml file tailored to your chosen platform.

Cloudflare Workers

Zintrust can be deployed to Cloudflare Workers using the wrangler CLI.

bash
npm run deploy

By default, this deploy targets the production Wrangler environment. To deploy to a different environment:

bash
WRANGLER_ENV=development npm run deploy

Ensure you have configured your wrangler.toml with the necessary KV namespaces for secrets management.

AWS Lambda

Deploy Zintrust as a serverless function on AWS Lambda using the LambdaAdapter.

typescript
import { LambdaAdapter } from '@adapters/LambdaAdapter';
import { app } from './app';

export const handler = LambdaAdapter.create(app);

Vercel / Netlify

For frontend-heavy applications or documentation sites, Zintrust integrates perfectly with Vercel and Netlify.

DigitalOcean / Linode / AWS EC2

For traditional VPS deployments, follow the standard Deployment Guide using PM2 and Nginx.

Secrets Management

Zintrust's SecretsManager provides a unified interface for retrieving secrets from various cloud providers:

  • Cloudflare KV
  • AWS Secrets Manager
  • Environment Variables (Fallback)

Released under the MIT License.