Deployment Skill

Deployment Flow

feature/* → PR → CI checks → merge to master → Coolify auto-deploy

Production URL: https://learntotarkov.com Deployment time: ~3 minutes from merge to live

3-Tier Validation System

Pre-push hooks catch 95%+ of deployment failures locally:

Tier 1: Quick Validation (~15-30s) - ALWAYS RUNS

• •Nixpacks configuration valid
• •No test packages in build (Chromium, Playwright)
• •Required env vars documented
• •Standalone build structure valid

Tier 2: Full Validation (~2-3 min) - IF TYPESCRIPT CHANGED

• •TypeScript type checking
• •ESLint / Prettier
• •All unit tests pass
• •Prisma client generation

Tier 3: Docker Build (~2-4 min) - IF DEPLOYMENT FILES CHANGED

Triggers if these files change:

• •nixpacks.toml, Dockerfile, package.json
• •next.config.ts, pnpm-lock.yaml, .dockerignore

Tests:

• •Docker image builds
• •Container starts
• •Health checks pass

Manual Validation Commands

# Tier 1: Quick checks only
bash scripts/test-coolify-build.sh --quick

# Tier 2: Nixpacks plan validation
bash scripts/test-coolify-build.sh --plan

# Tier 3: Full Docker build test
bash scripts/test-coolify-build.sh

# Force rebuild without cache
bash scripts/test-coolify-build.sh --no-cache

Coolify Auto-Deployment

How It Works

1. •Code merged to master
2. •GitHub webhook triggers Coolify
3. •Coolify validates webhook signature
4. •Deployment queued and executed:
   • •Clone at commit SHA
   • •Build Docker image
   • •Run healthcheck
   • •Rolling update (zero downtime)
   • •Remove old container

Webhook Configuration

• •URL: http://95.217.155.28:8000/webhooks/source/github/events/manual
• •Events: Push to master only
• •Secret: HMAC-SHA256 signed

Monitoring Deployments

Coolify Dashboard: http://95.217.155.28:8000/ Navigate: Projects → EFT-Tracker → Deployments

Programmatic Monitoring:

import { getCoolifyAPIClient } from "@eft-tracker/utils";

const client = getCoolifyAPIClient();
const deployment = await client.getDeployment("uuid");
// Status: 'queued' | 'in_progress' | 'finished' | 'failed' | 'cancelled'

API Routes:

• •GET /api/deployment/status?deploymentId=<uuid>
• •GET /api/deployment/logs?deploymentId=<uuid>

Common Issues

Tier 1: "Sentry packages found"

cd apps/web && pnpm install

Tier 1: "Standalone output not found"

cd apps/web && npm run build

Tier 3: "Docker not running"

Start Docker Desktop. Only needed for Tier 3.

Windows: EPERM errors on build

Enable Developer Mode in Windows Settings → Privacy & Security → For developers

Or let CI handle it - pre-push hook detects Windows and relies on CI.

Files Reference

Environment Variables

Required for deployment monitoring:

• •COOLIFY_API_URL - http://95.217.155.28:8000/api/v1
• •COOLIFY_API_TOKEN - Bearer token (read-only)

Deployment Checklist

Before Merging

• • All CI checks pass
• • Pre-push validation passed
• • No deployment-critical file changes without Tier 3 test
• • Smoke tests ready to verify

After Deployment

• • Check Coolify dashboard for success
• • Verify production URL responds
• • Run smoke tests: gh workflow run smoke-tests.yml
• • Monitor for errors in first 30 minutes

Troubleshooting

Deployment Failed in Coolify

1. •Check Coolify logs (Dashboard → Deployments → View logs)
2. •Common causes:
   • •Missing env vars
   • •Docker build failure
   • •Healthcheck timeout
   • •Port conflict

Rollback

1. •Go to Coolify Dashboard
2. •Navigate to Deployments
3. •Find last successful deployment
4. •Click "Redeploy" on that commit

Manual Deployment

If webhooks aren't working:

1. •Coolify Dashboard → EFT-Tracker
2. •Click "Redeploy" button
3. •Wait for build (~3 min)

Performance Notes

Before (with Sentry): 25+ min deployments After (Sentry removed): ~3 min deployments

Local validation catches issues before the 3+ minute deployment cycle.