bmc_hub/PRODUCTION_QUICK_START.md

2.6 KiB

BMC Hub - Quick Production Setup

🚀 Hurtig Start (TL;DR)

# 1. På din Mac - tag en release
cd /Users/christianthomas/DEV/bmc_hub_dev
git tag v1.0.0 && git push origin v1.0.0

# 2. På production server
mkdir -p /srv/podman/bmc_hub_v1.0 && cd /srv/podman/bmc_hub_v1.0

# 3. Download setup script
curl https://raw.githubusercontent.com/ct/bmc_hub/v1.0.0/scripts/deploy_production.sh -o setup.sh
chmod +x setup.sh

# 4. Opret .env (brug template nedenfor)
nano .env

# 5. Kør deployment
./setup.sh

# 6. Start services
podman-compose up -d --build

# 7. Verificer
curl http://localhost:8000/health

📋 Minimal .env Template

# Version
RELEASE_VERSION=v1.0.0

# Gitea server
GITEA_URL=https://g.bmcnetworks.dk

# Gitea (opret token på https://g.bmcnetworks.dk/user/settings/applications)
GITHUB_TOKEN=glpat-xxxxxxxxxxxxx
GITHUB_REPO=ct/bmc_hub

# Database (SKIFT PASSWORD!)
POSTGRES_USER=bmc_hub_prod
POSTGRES_PASSWORD=din_stærke_password_her
POSTGRES_DB=bmc_hub_prod
DATABASE_URL=postgresql://bmc_hub_prod:din_stærke_password_her@postgres:5432/bmc_hub_prod

# Security (generer med: python3 -c "import secrets; print(secrets.token_urlsafe(32))")
SECRET_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# API
API_PORT=8000
CORS_ORIGINS=http://172.16.31.183:8001

# Safety (BEHOLD true!)
ECONOMIC_READ_ONLY=true
ECONOMIC_DRY_RUN=true

🔄 Opdater til Ny Version

cd /srv/podman/bmc_hub_v1.0

# Ændr version i .env
nano .env  # RELEASE_VERSION=v1.1.0

# Rebuild
podman-compose down
podman-compose up -d --build

# Check
podman-compose logs -f api

📖 Fuld Dokumentation

Se PRODUCTION_DEPLOYMENT.md for detaljeret guide.

🆘 Problemer?

# Check logs
podman-compose logs -f

# Check containers
podman ps -a

# Restart
podman-compose restart

# Start forfra
podman-compose down -v
podman-compose up -d --build

📁 Struktur på Production Server

/srv/podman/bmc_hub_v1.0/
├── .env                    # Din konfiguration (opret selv)
├── docker-compose.yml      # Downloaded fra Gitea
├── Dockerfile              # Downloaded fra Gitea
├── requirements.txt        # Downloaded fra Gitea
├── migrations/             # SQL migrations
│   └── init.sql
├── logs/                   # Application logs
├── uploads/                # Uploaded files
└── data/                   # Application data
    └── invoice_templates/

VIGTIGT: Kun disse filer downloades til serveren. Al application kode hentes automatisk af Docker/Podman fra Gitea release når containeren bygges.