- Added lock file exclusions for pnpm in .gitignore. - Removed obsolete package-lock.json from the api and portal directories. - Enhanced Cloudflare adapter with additional interfaces for zones and tunnels. - Improved Proxmox adapter error handling and logging for API requests. - Updated Proxmox VM parameters with validation rules in the API schema. - Enhanced documentation for Proxmox VM specifications and examples.
3.7 KiB
3.7 KiB
Sankofa Phoenix - Deployment Documentation Index
Quick Navigation Guide
🎯 Start Here
For Immediate Deployment
-
- Production deployment instructions
- Step-by-step guide
- Current status
-
- Step-by-step execution guide
- Timeline estimates
- Rollback procedures
For Planning
-
- Complete infrastructure requirements
- Software requirements
- Environment configuration
-
- Current infrastructure status
- Resource availability
- Deployment readiness
📚 Core Documentation
Infrastructure
-
- Infrastructure status
- VM requirements
- Resource allocation
-
- VM deployment patterns
- Best practices
- Resource guidelines
-
- Quick start guide
- Troubleshooting tips
Application Deployment
-
- Application deployment steps
- Database setup
- Keycloak configuration
-
- Keycloak setup
- OIDC configuration
- Client setup
VM Configuration
-
- SMOM-DBIS-138 VM updates
- Enhanced template details
-
- Infrastructure VM updates
- Template VM updates
-
- Complete VM summary
- Verification checklist
🔧 Operational Documentation
Monitoring and Observability
- Launch Checklist
- Pre-launch verification
- Success criteria
- Support readiness
Architecture
-
- Overall architecture
- Component overview
-
- Datacenter specifications
- Hardware requirements
-
- Blockchain design
- EEA compliance
📋 Checklists
Pre-Deployment
- Resource quota verified
- Kubernetes cluster ready
- Database accessible
- Keycloak configured
- Cloudflare account ready
Deployment
- Control plane deployed
- Applications deployed
- Infrastructure VMs deployed
- Application VMs deployed
- Monitoring stack deployed
Post-Deployment
- All services healthy
- All VMs running
- Guest agent on all VMs
- Monitoring operational
- Smoke tests passing
🚀 Quick Reference
Essential Commands
# Resource check
./scripts/check-proxmox-quota.sh
# Deploy VMs
kubectl apply -f examples/production/smom-dbis-138/
# Check status
kubectl get proxmoxvm -A
kubectl get pods -A
# Run tests
./scripts/smoke-tests.sh
Key Files
- VM YAML files:
examples/production/smom-dbis-138/*.yaml - Infrastructure VMs:
examples/production/nginx-proxy-vm.yaml,cloudflare-tunnel-vm.yaml - Scripts:
scripts/*.sh - GitOps:
gitops/apps/*/
📞 Support
Troubleshooting
- Check controller logs:
kubectl logs -n crossplane-system -l app=crossplane-provider-proxmox - Check VM status:
kubectl get proxmoxvm -A -o wide - Check pod logs:
kubectl logs <pod-name> -n <namespace>
Documentation
- All deployment docs:
docs/ - Scripts:
scripts/ - Examples:
examples/production/
Last Updated: 2025-01-XX