2.5 KiB
2.5 KiB
Infrastructure Documentation
Overview and navigation for infrastructure and deployment documentation.
Quick Links
| Guide | Description |
|---|---|
| Deployment Guide | Complete deployment walkthrough |
| Security | Security hardening and best practices |
| VPN Setup | WireGuard VPN configuration |
| Setup From Scratch | Fresh environment setup |
Infrastructure Directory
All operational configuration lives in infrastructure/:
infrastructure/
├── DEPLOYMENT_GUIDE.md # Deployment walkthrough
├── DEPLOYMENT_STATUS.md # Current deployment state
├── DEPLOYMENT_WORKFLOW.md # CI/CD pipeline docs
├── DEVELOPMENT_WORKFLOW.md # Local development
├── PRE_DEPLOYMENT_CHECKLIST.md # Pre-deploy validation
├── QUICK_DEPLOY_COMMANDS.md # Common deploy commands
├── SECURITY.md # Security hardening
├── SETUP_FROM_SCRATCH.md # Fresh setup
├── VPN_SETUP.md # VPN configuration
│
├── shared-services/ # Shared service manifests (SSO, merchant, etc.)
├── docker/ # Docker configurations
├── nginx/ # Web server configs
├── scripts/ # Automation scripts
├── env/ # Environment templates
├── hosts/ # Host-specific configs
└── provisioning/ # Server provisioning
Deployment Model
Environments
- Development: Local Docker Compose
- Staging: VPS with Docker
- Production: VPS with Docker + nginx
CI/CD
GitLab CI handles:
- Build validation
- Type checking
- E2E tests
- Docker image builds
- Deployment automation
See Deployment Workflow for pipeline details.
Port Allocation
Port assignments are defined in deployment manifests:
deployments/@domains/*/services.yaml- Deployment-specific servicesinfrastructure/shared-services/*.yaml- Shared services (SSO, merchant, etc.)
Key port ranges:
- Infrastructure: 3000-3999
- APIs: 4000-4999
- Frontends: 5000-5999
- Development tools: 6000-6999
Security
Security documentation:
- Security Guide - Hardening checklist
- VPN Auto-Connection - Automatic VPN setup
Last Updated: 2026-01-25