blackcanyontickets/DEPLOYMENT_GUIDE.md

Docker Deployment Guide

This guide covers setting up Black Canyon Tickets with separated Docker Compose files for optimal deployment workflow.

Overview

• Astro App: Rebuilt on each Git deployment
• Directus + PostgreSQL: Persistent infrastructure, deployed once
• NGINX: Reverse proxy to both services
• Certbot: SSL certificates (existing setup)

Server Setup (One-Time)

1. Install Dependencies

# Update system
sudo apt update && sudo apt upgrade -y

# Install Docker & Docker Compose
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo usermod -aG docker $USER

# Log out and back in for Docker group to take effect

2. Clone Repository

cd /var/www
sudo git clone https://github.com/your-org/bct-whitelabel.git
sudo chown -R $USER:$USER bct-whitelabel
cd bct-whitelabel

3. Configure Environment

# Copy infrastructure environment template
cp .env.infrastructure .env.infrastructure.local

# Edit with your production values
nano .env.infrastructure.local

Required values in .env.infrastructure.local:

# Generate these with: openssl rand -hex 32
DIRECTUS_KEY=your-32-char-random-key-here
DIRECTUS_SECRET=your-32-char-random-secret-here

# Strong passwords
DIRECTUS_DB_PASSWORD=your-secure-db-password
DIRECTUS_ADMIN_PASSWORD=your-secure-admin-password

# Your domain
DIRECTUS_ADMIN_EMAIL=admin@blackcanyontickets.com
DIRECTUS_CORS_ORIGIN=https://portal.blackcanyontickets.com

# Email (optional)
DIRECTUS_SMTP_PASSWORD=your-resend-api-key

4. Create Docker Network

# Create shared network for services
docker network create bct-network

5. Deploy Infrastructure

# Load environment and start infrastructure
export $(cat .env.infrastructure.local | xargs)
npm run docker:infrastructure:up

# Verify services are running
docker ps
npm run docker:infrastructure:logs

6. Configure NGINX

# Copy simplified configuration
sudo cp nginx-example.conf /etc/nginx/sites-available/blackcanyontickets

# Enable site
sudo ln -s /etc/nginx/sites-available/blackcanyontickets /etc/nginx/sites-enabled/

# Test configuration
sudo nginx -t

7. Setup SSL with Certbot

# Get SSL certificate (Certbot handles NGINX config automatically)
sudo certbot --nginx -d portal.blackcanyontickets.com

# Reload NGINX with SSL
sudo systemctl reload nginx

Git Deployment Script

Update your deployment script to only rebuild the Astro app:

Simple Deploy Script

#!/bin/bash
set -e

echo "Deploying BCT Astro app..."

# Navigate to project directory
cd /var/www/bct-whitelabel

# Pull latest changes
git pull origin main

# Rebuild only Astro app (infrastructure stays running)
npm run docker:astro:up

echo "Deployment complete!"

That's it! Your infrastructure (Directus + PostgreSQL) keeps running.

Daily Operations

Check Service Status

# View all running containers
docker ps

# Check logs
npm run docker:astro:logs          # Astro app logs
npm run docker:infrastructure:logs # Directus + PostgreSQL logs

# Health checks
curl http://localhost:3000/api/health  # Astro health
curl http://localhost:8055/server/health  # Directus health

Restart Services

# Restart Astro app only
npm run docker:astro:down
npm run docker:astro:up

# Restart infrastructure (rare)
npm run docker:infrastructure:down
npm run docker:infrastructure:up

View Service URLs

• Main App: https://portal.blackcanyontickets.com
• Directus Admin: https://portal.blackcanyontickets.com/admin
• Directus API: https://portal.blackcanyontickets.com/api/directus

Backup Strategy

Database Backup

# Create backup script
cat > backup-db.sh << 'EOF'
#!/bin/bash
BACKUP_DIR="/var/backups/bct"
DATE=$(date +%Y%m%d_%H%M%S)

mkdir -p $BACKUP_DIR

# Backup PostgreSQL
docker exec bct-whitelabel-postgres-1 pg_dump -U directus directus > $BACKUP_DIR/directus_$DATE.sql

# Keep only last 7 days
find $BACKUP_DIR -name "directus_*.sql" -mtime +7 -delete

echo "Backup completed: $BACKUP_DIR/directus_$DATE.sql"
EOF

chmod +x backup-db.sh

# Add to crontab for daily backups
echo "0 2 * * * /var/www/bct-whitelabel/backup-db.sh" | crontab -

Upload Backup

# Backup Directus uploads
tar -czf /var/backups/bct/directus_uploads_$(date +%Y%m%d).tar.gz \
  -C /var/lib/docker/volumes/bct-whitelabel_directus_uploads/_data .

Troubleshooting

Common Issues

1. Services won't start

   # Check logs
   docker logs bct-whitelabel-directus-1
   docker logs bct-whitelabel-postgres-1
   
   # Check network
   docker network ls | grep bct-network
   

2. Database connection issues

   # Verify PostgreSQL is running
   docker exec bct-whitelabel-postgres-1 pg_isready -U directus
   
   # Check environment variables
   echo $DIRECTUS_DB_PASSWORD
   

3. NGINX proxy errors

   # Test NGINX config
   sudo nginx -t
   
   # Check upstream connectivity
   curl http://localhost:3000
   curl http://localhost:8055
   

Reset Infrastructure (if needed)

# WARNING: This will delete all Directus data
npm run docker:infrastructure:down
docker volume rm bct-whitelabel_postgres_data bct-whitelabel_directus_uploads bct-whitelabel_directus_extensions
npm run docker:infrastructure:up

Monitoring

Log Monitoring

# Real-time logs
tail -f /var/log/nginx/access.log
npm run docker:astro:logs -f
npm run docker:infrastructure:logs -f

# Log rotation (add to /etc/logrotate.d/bct)
/var/www/bct-whitelabel/logs/*.log {
    daily
    missingok
    rotate 7
    compress
    delaycompress
    notifempty
    sharedscripts
}

Resource Monitoring

# Container stats
docker stats

# Disk usage
docker system df
docker volume ls

Auto-Start Services on Boot

Configure Docker Services to Auto-Start

# Create systemd service for infrastructure
sudo tee /etc/systemd/system/bct-infrastructure.service > /dev/null << 'EOF'
[Unit]
Description=BCT Infrastructure (Directus + PostgreSQL)
Requires=docker.service
After=docker.service

[Service]
Type=oneshot
RemainAfterExit=yes
WorkingDirectory=/var/www/bct-whitelabel
ExecStart=/usr/bin/docker-compose -f docker-compose.infrastructure.yml up -d
ExecStop=/usr/bin/docker-compose -f docker-compose.infrastructure.yml down
TimeoutStartSec=0

[Install]
WantedBy=multi-user.target
EOF

# Enable and start the service
sudo systemctl enable bct-infrastructure.service
sudo systemctl start bct-infrastructure.service

One-Command Astro Redeploy

Add this to your server for quick deployments:

# Create deployment alias
echo 'alias redeploy-bct="cd /var/www/bct-whitelabel && git pull && npm run docker:astro:up"' >> ~/.bashrc
source ~/.bashrc

# Now you can simply run:
redeploy-bct

This setup provides a robust, maintainable deployment pipeline where your Astro app can be updated frequently while keeping your CMS and database stable.