c39465c2bd
Some checks failed
Test / test (push) Has been cancelled
Co-authored-by: Cursor <cursoragent@cursor.com>
126 lines
3.2 KiB
Markdown
126 lines
3.2 KiB
Markdown
# 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.
|