Files
stiftung-management-system/DEPLOYMENT.md
Stiftung Development c8afaaba6a docs: add deployment guide and test production pipeline
- Document deployment secrets configuration
- Verify production deployment pipeline
- Test automated deployment with deployment user
- Ready for production deployment
2025-09-06 20:44:49 +02:00

1.4 KiB

Deployment Guide

Production Deployment Status

The automated deployment pipeline is now configured and ready!

Deployment Secrets Configured:

  • PROD_HOST - Production server address
  • PROD_USERNAME - SSH username (deployment)
  • PROD_SSH_KEY - SSH private key for authentication

Deployment Process:

  1. Automatic Triggers:

    • Push to main branch
    • Manual workflow dispatch from GitHub Actions
  2. Pipeline Steps:

    • Code quality checks (flake8, black, isort, bandit)
    • Automated testing with PostgreSQL
    • Docker image building
    • Secure deployment to production server
    • Health checks and verification
  3. Deployment Files:

    • deploy-production/ - Ubuntu/Debian production setup
    • deploy-synology/ - Synology NAS deployment option

Manual Deployment:

If you need to deploy manually:

# 1. Prepare production server
sudo bash deploy-production/server-setup.sh

# 2. Deploy application
bash deploy-production/deploy.sh

Monitoring:

  • GitHub Actions: Monitor deployment status
  • Server logs: docker-compose logs -f
  • Application health: Check configured health endpoints

Next Steps:

  1. Monitor the first automated deployment
  2. Configure SSL certificates with Certbot
  3. Set up monitoring and backups
  4. Configure domain DNS

Last updated: September 6, 2025 Pipeline configured for user: deployment