@deftai/directive-content 0.55.0

package/deployments/google/via-cloud-run.md

@@ -0,0 +1,330 @@
+# Deploy via Cloud Run
+
+Deploy containerized applications using Google Cloud Run. Fully managed serverless platform that automatically scales containers.
+
+## Overview
+
+Cloud Run provides:
+- **Serverless Containers**: Run any containerized application
+- **Auto-scaling**: Scale to zero, pay only for usage
+- **Request-based Billing**: Pay per request and compute time
+- **HTTPS Endpoints**: Automatic SSL certificates
+- **Simple Deployment**: From source code or container images
+
+## Prerequisites
+
+- Google Cloud account with project
+- gcloud CLI installed
+- Docker (optional, can build remotely)
+- Application code or container image
+
+## Quick Start
+
+### 1. Install gcloud CLI
+
+```bash
+# macOS
+brew install google-cloud-sdk
+
+# Initialize
+gcloud init
+
+# Authenticate
+gcloud auth login
+```
+
+### 2. Deploy from Source
+
+```bash
+# Deploy directly from source (buildpacks)
+gcloud run deploy myapp \
+  --source . \
+  --region us-central1 \
+  --allow-unauthenticated
+
+# Follow prompts, Cloud Run builds and deploys automatically
+```
+
+### 3. Deploy from Container Image
+
+```bash
+# Build with Cloud Build
+gcloud builds submit --tag gcr.io/PROJECT_ID/myapp
+
+# Deploy
+gcloud run deploy myapp \
+  --image gcr.io/PROJECT_ID/myapp \
+  --region us-central1 \
+  --allow-unauthenticated
+```
+
+## Deploy from Dockerfile
+
+```bash
+# Submit build
+gcloud builds submit --tag gcr.io/PROJECT_ID/myapp
+
+# Deploy with options
+gcloud run deploy myapp \
+  --image gcr.io/PROJECT_ID/myapp \
+  --region us-central1 \
+  --platform managed \
+  --allow-unauthenticated \
+  --port 8080 \
+  --memory 512Mi \
+  --cpu 1 \
+  --max-instances 10 \
+  --set-env-vars "APP_ENV=production"
+```
+
+## Configuration
+
+### Environment Variables
+
+```bash
+# Set environment variables
+gcloud run services update myapp \
+  --region us-central1 \
+  --set-env-vars "APP_ENV=production,LOG_LEVEL=info"
+
+# From file
+gcloud run services update myapp \
+  --region us-central1 \
+  --env-vars-file .env.yaml
+```
+
+### Secrets
+
+```bash
+# Create secret in Secret Manager
+echo -n "my-secret-value" | gcloud secrets create db-password --data-file=-
+
+# Grant access to Cloud Run service account
+gcloud secrets add-iam-policy-binding db-password \
+  --member="serviceAccount:PROJECT_NUMBER-compute@developer.gserviceaccount.com" \
+  --role="roles/secretmanager.secretAccessor"
+
+# Use secret in Cloud Run
+gcloud run services update myapp \
+  --region us-central1 \
+  --set-secrets "DB_PASSWORD=db-password:latest"
+```
+
+### Resource Limits
+
+```bash
+gcloud run services update myapp \
+  --region us-central1 \
+  --memory 1Gi \
+  --cpu 2 \
+  --timeout 300 \
+  --max-instances 100 \
+  --min-instances 0
+```
+
+## Custom Domains
+
+```bash
+# Map custom domain
+gcloud run services update myapp \
+  --region us-central1 \
+  --allow-unauthenticated
+
+# Add domain mapping
+gcloud run domain-mappings create \
+  --service myapp \
+  --domain www.example.com \
+  --region us-central1
+
+# Update DNS records as instructed
+```
+
+## Traffic Splitting
+
+```bash
+# Deploy new revision
+gcloud run deploy myapp \
+  --image gcr.io/PROJECT_ID/myapp:v2 \
+  --region us-central1 \
+  --no-traffic
+
+# Split traffic
+gcloud run services update-traffic myapp \
+  --region us-central1 \
+  --to-revisions REVISION1=80,REVISION2=20
+```
+
+## CI/CD Integration
+
+### GitHub Actions
+
+```yaml
+# .github/workflows/cloud-run.yml
+name: Deploy to Cloud Run
+
+on:
+  push:
+    branches: [main]
+
+env:
+  PROJECT_ID: my-project
+  SERVICE: myapp
+  REGION: us-central1
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    
+    steps:
+      - uses: actions/checkout@v3
+      
+      - uses: google-github-actions/auth@v1
+        with:
+          credentials_json: ${{ secrets.GCP_CREDENTIALS }}
+      
+      - uses: google-github-actions/setup-gcloud@v1
+      
+      - name: Build and push
+        run: |
+          gcloud builds submit --tag gcr.io/$PROJECT_ID/$SERVICE
+      
+      - name: Deploy to Cloud Run
+        run: |
+          gcloud run deploy $SERVICE \
+            --image gcr.io/$PROJECT_ID/$SERVICE \
+            --region $REGION \
+            --platform managed \
+            --allow-unauthenticated
+```
+
+### Cloud Build
+
+```yaml
+# cloudbuild.yaml
+steps:
+  # Build container image
+  - name: 'gcr.io/cloud-builders/docker'
+    args: ['build', '-t', 'gcr.io/$PROJECT_ID/myapp', '.']
+  
+  # Push to Container Registry
+  - name: 'gcr.io/cloud-builders/docker'
+    args: ['push', 'gcr.io/$PROJECT_ID/myapp']
+  
+  # Deploy to Cloud Run
+  - name: 'gcr.io/cloud-builders/gcloud'
+    args:
+      - 'run'
+      - 'deploy'
+      - 'myapp'
+      - '--image=gcr.io/$PROJECT_ID/myapp'
+      - '--region=us-central1'
+      - '--platform=managed'
+      - '--allow-unauthenticated'
+
+images:
+  - 'gcr.io/$PROJECT_ID/myapp'
+```
+
+## VPC Access
+
+```bash
+# Create VPC connector
+gcloud compute networks vpc-access connectors create myconnector \
+  --network default \
+  --region us-central1 \
+  --range 10.8.0.0/28
+
+# Use connector
+gcloud run services update myapp \
+  --region us-central1 \
+  --vpc-connector myconnector \
+  --vpc-egress all-traffic
+```
+
+## Database Integration
+
+### Cloud SQL
+
+```bash
+# Connect to Cloud SQL
+gcloud run services update myapp \
+  --region us-central1 \
+  --add-cloudsql-instances PROJECT_ID:REGION:INSTANCE_NAME \
+  --set-env-vars "DB_HOST=/cloudsql/PROJECT_ID:REGION:INSTANCE_NAME"
+```
+
+### Firestore
+
+```bash
+# Set environment variable
+gcloud run services update myapp \
+  --region us-central1 \
+  --set-env-vars "FIRESTORE_PROJECT_ID=PROJECT_ID"
+```
+
+## Monitoring
+
+### View Logs
+
+```bash
+# Stream logs
+gcloud run services logs tail myapp --region us-central1
+
+# View recent logs
+gcloud run services logs read myapp --region us-central1 --limit 100
+```
+
+### Metrics
+
+Access Cloud Monitoring for:
+- Request count
+- Request latency
+- Container CPU/memory usage
+- Billable instance time
+
+## Best Practices
+
+1. **Use Cloud Build**: Build images remotely
+2. **Scale to Zero**: Save costs for low-traffic services
+3. **Set Max Instances**: Prevent runaway costs
+4. **Use Secrets Manager**: Never hardcode secrets
+5. **Health Checks**: Ensure container responds on /
+6. **Minimum Instances**: Use for latency-sensitive apps
+7. **VPC Connector**: For private resource access
+8. **Traffic Splitting**: Test changes gradually
+9. **Optimize Container**: Reduce cold start times
+10. **Monitor Costs**: Set budget alerts
+
+## Troubleshooting
+
+```bash
+# Check service status
+gcloud run services describe myapp --region us-central1
+
+# View revisions
+gcloud run revisions list --service myapp --region us-central1
+
+# Check IAM permissions
+gcloud run services get-iam-policy myapp --region us-central1
+```
+
+## Cost Optimization
+
+```bash
+# Scale to zero when idle
+--min-instances 0
+
+# Right-size resources
+--memory 512Mi --cpu 1
+
+# Use request timeout
+--timeout 60
+
+# Monitor and optimize per-request costs
+```
+
+## References
+
+- [Cloud Run Documentation](https://cloud.google.com/run/docs)
+- [Cloud Run Pricing](https://cloud.google.com/run/pricing)
+- [Best Practices](https://cloud.google.com/run/docs/tips)

package/deployments/google/via-gke.md

@@ -0,0 +1,23 @@
+# Deploy via Google Kubernetes Engine (GKE)
+
+Deploy containerized applications using GKE. Managed Kubernetes with Google Cloud integration.
+
+## Quick Start
+
+```bash
+# Create cluster
+gcloud container clusters create mycluster \
+  --zone us-central1-a \
+  --num-nodes 3
+
+# Get credentials
+gcloud container clusters get-credentials mycluster \
+  --zone us-central1-a
+
+# Deploy application
+kubectl apply -f deployment.yaml
+```
+
+## References
+
+- [GKE Documentation](https://cloud.google.com/kubernetes-engine/docs)

package/deployments/netlify/README.md

@@ -0,0 +1,99 @@
+# Netlify Deployment Module
+
+Deft guidance for deploying applications to Netlify.
+
+## Status
+
+- ! Optional module
+- ~ Good for Deft usage
+
+## Overview
+
+Netlify specializes in JAMstack deployments with built-in CI/CD and serverless functions.
+
+## Deployment Methods
+
+| File | Method | Best For |
+|------|--------|----------|
+| `via-git.md` | Git Integration | Automatic deploy-on-push workflows (default) |
+| `via-cli.md` | Netlify CLI | Local testing, custom CI/CD pipelines |
+| `via-functions.md` | Netlify Functions | Serverless APIs alongside static sites |
+
+## Supported Frameworks
+
+Netlify supports all major static site generators and frameworks:
+
+- **Next.js** — Static and SSR support
+- **Gatsby** — Optimized builds and plugins
+- **Hugo** — Fast static site generation
+- **Jekyll** — Ruby-based static sites
+- **Eleventy** — Flexible static site generator
+- **SvelteKit** — Full-stack Svelte framework
+- **Astro** — Modern static site builder
+- **Any static HTML/CSS/JS**
+
+## Deployment Approaches
+
+### Git-Based Deployments
+
+- Connect repository for continuous deployment
+- Deploy previews for every pull request
+- Branch deploys for staging environments
+- Automatic build detection and configuration
+
+### CLI Deployments
+
+```bash
+# Install Netlify CLI
+npm i -g netlify-cli
+
+# Link to existing site or create new
+netlify init
+
+# Deploy draft for testing
+netlify deploy
+
+# Deploy to production
+netlify deploy --prod
+```
+
+### Netlify Functions
+
+- Deploy serverless functions alongside your site
+- Background functions for async processing
+- Edge functions for request manipulation at CDN edge
+
+### Build Plugins
+
+- Extend build process with Netlify plugins
+- Image optimization, analytics, A/B testing
+- Custom build workflows
+
+## Quick Decision Guide
+
+- **JAMstack sites**: Git integration — automatic builds on push
+- **Static site generators**: Git integration — framework detection
+- **Quick prototypes**: Drag & drop — instant deployment
+- **Serverless APIs**: Netlify Functions — backend alongside frontend
+- **Edge logic**: Edge Functions — request handling at CDN
+- **CI/CD pipelines**: Netlify CLI — custom build workflows
+- **A/B testing**: Split Testing — built-in feature
+
+## Key Features
+
+- **Instant Rollbacks**: One-click rollback to any deploy
+- **Deploy Previews**: Unique URL for every PR
+- **Form Handling**: Built-in form processing
+- **Identity**: Built-in authentication
+- **Large Media**: Git LFS alternative
+- **Analytics**: Privacy-first analytics
+- **Automatic HTTPS**: Free SSL certificates
+
+## References
+
+- [Netlify Documentation](https://docs.netlify.com/)
+- [Netlify CLI](https://docs.netlify.com/cli/get-started/)
+- [Deploy with Git](https://docs.netlify.com/site-deploys/create-deploys/)
+- [Netlify Functions](https://docs.netlify.com/functions/overview/)
+- [Edge Functions](https://docs.netlify.com/edge-functions/overview/)
+- [Build Plugins](https://docs.netlify.com/configure-builds/build-plugins/)

package/deployments/netlify/via-cli.md

@@ -0,0 +1,17 @@
+# Deploy via Netlify CLI
+
+Deploy to Netlify using the command-line interface for local testing and CI/CD.
+
+## Quick Start
+
+```bash
+# Install CLI
+npm install -g netlify-cli
+
+# Deploy
+netlify deploy --prod
+```
+
+## References
+
+- [CLI Documentation](https://docs.netlify.com/cli/get-started/)

package/deployments/netlify/via-functions.md

@@ -0,0 +1,19 @@
+# Deploy Netlify Functions
+
+Deploy serverless functions alongside your static site.
+
+## Quick Start
+
+```javascript
+// netlify/functions/hello.js
+exports.handler = async (event) => {
+  return {
+    statusCode: 200,
+    body: JSON.stringify({ message: "Hello World" })
+  };
+};
+```
+
+## References
+
+- [Functions Documentation](https://docs.netlify.com/functions/overview/)

package/deployments/netlify/via-git.md

@@ -0,0 +1,25 @@
+# Deploy via Git Integration
+
+Deploy to Netlify using Git integration with GitHub, GitLab, or Bitbucket. Automatic deploys on every push.
+
+## Quick Start
+
+1. Connect repository in Netlify dashboard
+2. Configure build settings  
+3. Push to trigger automatic deployment
+
+## Build Configuration
+
+```toml
+# netlify.toml
+[build]
+  command = "npm run build"
+  publish = "dist"
+
+[build.environment]
+  NODE_VERSION = "18"
+```
+
+## References
+
+- [Git Integration Documentation](https://docs.netlify.com/site-deploys/create-deploys/)

package/deployments/vercel/README.md

@@ -0,0 +1,90 @@
+# Vercel Deployment Module
+
+Deft guidance for deploying applications to Vercel.
+
+## Status
+
+- ! Optional module
+- ~ Good for Deft usage
+
+## Overview
+
+Vercel optimizes for frontend frameworks and full-stack JavaScript/TypeScript with exceptional Next.js support.
+
+## Deployment Methods
+
+| File | Method | Best For |
+|------|--------|----------|
+| `via-git.md` | Git Integration | Automatic deployments with preview URLs (default) |
+| `via-cli.md` | Vercel CLI | Local testing, custom CI/CD pipelines |
+| `via-api.md` | Vercel API | Programmatic deployments, custom automation |
+
+## Supported Frameworks
+
+Vercel has zero-config support for:
+
+- **Next.js** — First-class support, optimal performance
+- **React** — Create React App, Vite, custom setups
+- **Vue.js** — Nuxt, Vite, Vue CLI
+- **Svelte** — SvelteKit, Vite
+- **Angular** — Full support
+- **Static Sites** — Any static site generator
+
+## Deployment Approaches
+
+### Git-Based Deployments
+
+- Connect repository for automatic deployments on every push
+- Preview deployments for every pull request
+- Production deployments from main/master branch
+- Environment variables per branch/environment
+
+### CLI Deployments
+
+```bash
+# Install Vercel CLI
+npm i -g vercel
+
+# Deploy to preview
+vercel
+
+# Deploy to production
+vercel --prod
+```
+
+### Edge Functions & Middleware
+
+- Deploy serverless Edge Functions alongside your frontend
+- Middleware for request modification at the edge
+- Global distribution with low latency
+
+### CI/CD Integration
+
+- **GitHub Actions**: Use `vercel-action` for custom workflows
+- **GitLab CI/CD**: Deploy via Vercel CLI
+- **Other CI**: Integrate using Vercel CLI or API
+
+## Quick Decision Guide
+
+- **Next.js apps**: Git integration — deploy on push, automatic optimization
+- **Preview workflows**: Git integration — preview URLs for every PR
+- **Local testing**: Vercel CLI — deploy from local machine
+- **Custom pipelines**: GitHub Actions + Vercel CLI — advanced automation
+- **API-driven**: Vercel API — programmatic deployments
+
+## Key Features
+
+- **Automatic HTTPS**: Free SSL certificates
+- **Global CDN**: Edge network for optimal performance
+- **Serverless Functions**: Backend APIs alongside frontend
+- **Edge Functions**: Code running at the edge
+- **Image Optimization**: Automatic image handling
+- **Analytics**: Built-in web analytics
+
+## References
+
+- [Vercel Documentation](https://vercel.com/docs)
+- [Vercel CLI Documentation](https://vercel.com/docs/cli)
+- [Deploy with Git](https://vercel.com/docs/deployments/git)
+- [Edge Functions](https://vercel.com/docs/functions/edge-functions)
+- [Next.js on Vercel](https://vercel.com/docs/frameworks/nextjs)

package/deployments/vercel/via-api.md

@@ -0,0 +1,16 @@
+# Deploy via Vercel API
+
+Deploy to Vercel using the REST API for custom automation and programmatic deployments.
+
+## Quick Start
+
+```bash
+curl -X POST https://api.vercel.com/v13/deployments \
+  -H "Authorization: Bearer $VERCEL_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"name": "myapp", "gitSource": {"type": "github", "repo": "user/repo"}}'
+```
+
+## References
+
+- [API Documentation](https://vercel.com/docs/rest-api)

package/deployments/vercel/via-cli.md

@@ -0,0 +1,17 @@
+# Deploy via Vercel CLI
+
+Deploy to Vercel using the command-line interface for local testing and CI/CD workflows.
+
+## Quick Start
+
+```bash
+# Install CLI
+npm install -g vercel
+
+# Deploy to production
+vercel --prod
+```
+
+## References
+
+- [CLI Documentation](https://vercel.com/docs/cli)

package/deployments/vercel/via-git.md

@@ -0,0 +1,24 @@
+# Deploy via Git Integration
+
+Deploy to Vercel using Git integration with GitHub, GitLab, or Bitbucket. Automatic deployments and preview URLs.
+
+## Quick Start
+
+1. Import project in Vercel dashboard
+2. Configure framework preset
+3. Push to deploy automatically
+
+## Configuration
+
+```json
+// vercel.json
+{
+  "buildCommand": "npm run build",
+  "outputDirectory": "dist",
+  "framework": "vite"
+}
+```
+
+## References
+
+- [Git Integration Documentation](https://vercel.com/docs/deployments/git)