Some checks failed
Test / test (push) Has been cancelled
Co-authored-by: Cursor <cursoragent@cursor.com>
143 lines
6.0 KiB
Markdown
143 lines
6.0 KiB
Markdown
# Access Paths Visual Map
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────────┐
|
|
│ YOUR WORKSTATION │
|
|
│ │
|
|
│ SSH Key: ~/.ssh/id_ed25519_proxmox │
|
|
│ Browser: Access to Web UIs │
|
|
│ Scripts: Automation tools │
|
|
└─────────────────────────────────────────────────────────────────┘
|
|
│
|
|
│
|
|
┌─────────────────────┼─────────────────────┐
|
|
│ │ │
|
|
▼ ▼ ▼
|
|
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
|
|
│ Proxmox │ │ Proxmox │ │ Virtual │
|
|
│ ML110 │ │ R630 │ │ Machines │
|
|
│ │ │ │ │ │
|
|
│ 192.168.1.206│ │ 192.168.1.49 │ │ 100-103 │
|
|
└──────────────┘ └──────────────┘ └──────────────┘
|
|
│ │ │
|
|
│ │ │
|
|
┌────┴────┐ ┌────┴────┐ ┌────┴────┐
|
|
│ │ │ │ │ │
|
|
▼ ▼ ▼ ▼ ▼ ▼
|
|
┌─────┐ ┌─────┐ ┌─────┐ ┌─────┐ ┌─────┐ ┌─────┐
|
|
│Web │ │ SSH │ │Web │ │ SSH │ │Console│ │ SSH │
|
|
│UI │ │ │ │UI │ │ │ │ │ │ │
|
|
│✅ │ │ ✅ │ │✅ │ │ ❌ │ │ ✅ │ │ ❌ │
|
|
└─────┘ └─────┘ └─────┘ └─────┘ └─────┘ └─────┘
|
|
│ │ │ │ │ │
|
|
└────┬────┘ └────┬────┘ └────┬────┘
|
|
│ │ │
|
|
▼ ▼ ▼
|
|
┌─────────┐ ┌─────────┐ ┌─────────┐
|
|
│ API │ │ API │ │ QEMU │
|
|
│ ✅ │ │ ✅ │ │ Guest │
|
|
└─────────┘ └─────────┘ │ Agent │
|
|
│ ❌ │
|
|
└─────────┘
|
|
```
|
|
|
|
## Access Path Status
|
|
|
|
### ✅ Working Paths
|
|
|
|
**Proxmox ML110 (192.168.1.206):**
|
|
- ✅ Web UI: https://192.168.1.206:8006
|
|
- ✅ SSH: `ssh -i ~/.ssh/id_ed25519_proxmox root@192.168.1.206`
|
|
- ✅ API: https://192.168.1.206:8006/api2/json
|
|
|
|
**Proxmox R630 (192.168.1.49):**
|
|
- ✅ Web UI: https://192.168.1.49:8006
|
|
- ✅ API: https://192.168.1.49:8006/api2/json
|
|
|
|
**Virtual Machines (100-103):**
|
|
- ✅ Console: Via Proxmox Web UI
|
|
- ✅ Network: All reachable (ping)
|
|
- ✅ Port 22: All open
|
|
|
|
### ❌ Not Working (With Fixes)
|
|
|
|
**SSH to VMs:**
|
|
- ❌ Authentication failing
|
|
- 🔧 Fix: Use Proxmox console to add SSH key
|
|
|
|
**SSH to R630:**
|
|
- ❌ Authentication failing
|
|
- 🔧 Fix: Enable SSH and add key
|
|
|
|
**QEMU Guest Agent:**
|
|
- ❌ Not running in VMs
|
|
- 🔧 Fix: Install via console
|
|
|
|
## Access Flow Diagram
|
|
|
|
```
|
|
Workstation
|
|
│
|
|
├─→ Proxmox ML110 (✅ Web UI, ✅ SSH, ✅ API)
|
|
│ │
|
|
│ └─→ VM Console (✅ Available)
|
|
│ └─→ QEMU Guest Agent (❌ Not installed)
|
|
│
|
|
├─→ Proxmox R630 (✅ Web UI, ❌ SSH, ✅ API)
|
|
│ │
|
|
│ └─→ VM Console (✅ Available)
|
|
│
|
|
└─→ Virtual Machines (❌ SSH, ✅ Network, ✅ Console)
|
|
│
|
|
├─→ VM 100: 192.168.1.60 (cloudflare-tunnel)
|
|
├─→ VM 101: 192.168.1.188 (k3s-master)
|
|
├─→ VM 102: 192.168.1.121 (git-server)
|
|
└─→ VM 103: 192.168.1.82 (observability)
|
|
```
|
|
|
|
## Troubleshooting Decision Tree
|
|
|
|
```
|
|
Need to access VM?
|
|
│
|
|
├─→ SSH working? → Use SSH
|
|
│
|
|
├─→ SSH not working?
|
|
│ │
|
|
│ ├─→ Console available? → Use Console
|
|
│ │
|
|
│ ├─→ QEMU Guest Agent? → Use qm guest exec
|
|
│ │
|
|
│ └─→ Network reachable? → Use service APIs
|
|
│
|
|
└─→ Need Proxmox host access?
|
|
│
|
|
├─→ SSH working? → Use SSH
|
|
│
|
|
├─→ SSH not working?
|
|
│ │
|
|
│ ├─→ Web UI available? → Use Web UI
|
|
│ │
|
|
│ └─→ API working? → Use API
|
|
│
|
|
└─→ Physical access? → Use Console/KVM
|
|
```
|
|
|
|
## Priority Matrix
|
|
|
|
| Task | Priority 1 | Priority 2 | Priority 3 |
|
|
|------|-----------|------------|------------|
|
|
| VM Management | Web UI | SSH | API |
|
|
| Service Config | SSH | Console | QEMU Agent |
|
|
| Automation | API | SSH | Web UI |
|
|
| Troubleshooting | Console | SSH | QEMU Agent |
|
|
|
|
---
|
|
|
|
**Legend:**
|
|
- ✅ Working
|
|
- ❌ Not working
|
|
- 🔧 Needs fix
|
|
- ⏳ Pending
|
|
|