Initial commit: loc_az_hci (smom-dbis-138 excluded via .gitignore)

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-08 09:04:46 -08:00
commit c39465c2bd
386 changed files with 50649 additions and 0 deletions
--- a/docs/temporary/QUICK_START.md
+++ b/docs/temporary/QUICK_START.md
@@ -0,0 +1,125 @@
+# Quick Start Guide
+
+## Current Status
+
+✅ **Ready to Deploy**
+- Proxmox connections verified (both servers)
+- Environment variables configured
+- Setup scripts created
+- Terraform configuration ready
+
+## Immediate Next Steps
+
+### 1. Create Service VMs
+
+**Option A: Proxmox Web UI (Recommended)**
+- Access: https://192.168.1.206:8006 or https://192.168.1.49:8006
+- See `CREATE_VMS.md` for detailed instructions
+
+**Option B: Terraform**
+```bash
+cd terraform/proxmox
+terraform init
+terraform plan
+terraform apply
+```
+
+### 2. Install OS on VMs
+
+For each VM:
+1. Boot from Ubuntu 22.04 LTS ISO
+2. Complete installation
+3. Configure static IP addresses:
+   - Cloudflare Tunnel: 192.168.1.60
+   - K3s Master: 192.168.1.188
+   - Git Server: 192.168.1.121
+   - Observability: 192.168.1.82
+
+### 3. Run Setup Scripts
+
+**On Cloudflare Tunnel VM:**
+```bash
+# Copy script to VM
+scp scripts/setup-cloudflare-tunnel.sh user@192.168.1.60:/tmp/
+
+# SSH to VM and run
+ssh user@192.168.1.60
+sudo bash /tmp/setup-cloudflare-tunnel.sh
+```
+
+**On K3s VM:**
+```bash
+# Copy script to VM
+scp scripts/setup-k3s.sh user@192.168.1.188:/tmp/
+
+# SSH to VM and run
+ssh user@192.168.1.188
+sudo bash /tmp/setup-k3s.sh
+```
+
+## Service VM Specifications
+
+| VM Name | VM ID | IP Address | CPU | RAM | Disk | Purpose |
+|---------|-------|------------|-----|-----|------|---------|
+| cloudflare-tunnel | 100 | 192.168.1.60 | 2 | 4GB | 40GB | Cloudflare Tunnel |
+| k3s-master | 101 | 192.168.1.188 | 4 | 8GB | 80GB | Kubernetes |
+| git-server | 102 | 192.168.1.121 | 4 | 8GB | 100GB | Git Server |
+| observability | 103 | 192.168.1.82 | 4 | 8GB | 200GB | Monitoring |
+
+## Connection Information
+
+### Proxmox
+- **ML110**: https://192.168.1.206:8006
+- **R630**: https://192.168.1.49:8006
+- **Username**: root@pam
+- **Password**: (from `.env` file: `PVE_ROOT_PASS`)
+
+### Cloudflare
+- **Dashboard**: https://dash.cloudflare.com
+- **Zero Trust**: https://one.dash.cloudflare.com
+- **Tunnel Token**: (from `.env` file: `CLOUDFLARE_TUNNEL_TOKEN`)
+
+## Testing Connections
+
+```bash
+# Test Proxmox
+./scripts/utils/test-proxmox-connection.sh
+
+# Test Cloudflare (if API key configured)
+./scripts/utils/test-cloudflare-connection.sh
+```
+
+## Documentation
+
+- **CREATE_VMS.md** - Detailed VM creation guide
+- **DEPLOYMENT_WITHOUT_AZURE.md** - Complete deployment plan
+- **docs/cloudflare-integration.md** - Cloudflare setup details
+- **docs/deployment-guide.md** - General deployment guide
+
+## Troubleshooting
+
+### Proxmox Connection Issues
+- Verify IP addresses in `.env` file
+- Check network connectivity: `ping 192.168.1.206`
+- Accept self-signed certificate in browser
+
+### VM Creation Issues
+- Ensure sufficient storage on Proxmox host
+- Check VM ID availability (use `./scripts/proxmox/create-service-vms.sh`)
+- Verify network bridge configuration
+
+### Cloudflare Tunnel Issues
+- Verify tunnel token in `.env`
+- Check DNS records in Cloudflare Dashboard
+- Review tunnel logs: `journalctl -u cloudflared -f`
+
+## Next Steps After VM Creation
+
+1. ✅ Create VMs (this step)
+2. ⏭️ Install OS and configure networking
+3. ⏭️ Run setup scripts
+4. ⏭️ Configure Cloudflare Tunnel
+5. ⏭️ Deploy Kubernetes services
+6. ⏭️ Set up GitOps
+
+See `DEPLOYMENT_WITHOUT_AZURE.md` for complete workflow.