mirror of
https://github.com/Grace-Solutions/Depl0y-Custom.git
synced 2026-07-26 11:28:19 +00:00
Alphaeus Mote
140 lines
3.0 KiB
Markdown
140 lines
3.0 KiB
Markdown
# Cloud Images - Quick Start Guide
|
|
|
|
## What Are Cloud Images?
|
|
|
|
Cloud images let you deploy VMs in **30 seconds** instead of 20 minutes. No manual OS installation needed!
|
|
|
|
---
|
|
|
|
## One-Time Setup (Takes 1 Minute)
|
|
|
|
### Step 1: Check Status in Web UI
|
|
|
|
Go to **Settings** → Look for **"Cloud Image Setup"** section
|
|
|
|
- **Green box (✅)**: Already configured! Skip to "Using Cloud Images" below.
|
|
- **Yellow box (⚠️)**: Setup needed. Continue to Step 2.
|
|
|
|
### Step 2: Run Setup Script
|
|
|
|
**IMPORTANT:** Run this script **ON YOUR DEPL0Y SERVER** (not on Proxmox!)
|
|
|
|
**Option A: Copy from Web UI**
|
|
1. Click the **"Copy"** button in Settings page
|
|
2. SSH to your **Depl0y server** (hostname: `deploy`)
|
|
3. Paste and run the command
|
|
|
|
**Option B: Manual Command**
|
|
|
|
SSH to your **Depl0y server** and run:
|
|
|
|
```bash
|
|
sudo /tmp/enable_cloud_images.sh
|
|
```
|
|
|
|
**If you're already logged into the Depl0y server:**
|
|
Just run the command directly - no need to SSH anywhere!
|
|
|
|
### Step 3: Enter Password
|
|
|
|
When prompted, enter your **Proxmox root password**:
|
|
|
|
```
|
|
Password: [your-proxmox-root-password]
|
|
```
|
|
|
|
(Password won't be displayed as you type - this is normal)
|
|
|
|
### Step 4: Done!
|
|
|
|
You'll see:
|
|
|
|
```
|
|
✅ SUCCESS!
|
|
|
|
Cloud images are now fully configured!
|
|
```
|
|
|
|
Go back to **Settings** in web UI and click **"Re-check Status"** to verify.
|
|
|
|
---
|
|
|
|
## Using Cloud Images
|
|
|
|
### Create a VM:
|
|
|
|
1. Go to **"Create VM"** in web UI
|
|
2. Select **"Cloud Image (Fast)"** installation method
|
|
3. Choose a cloud image:
|
|
- Ubuntu 24.04 LTS
|
|
- Ubuntu 22.04 LTS
|
|
- Ubuntu 20.04 LTS
|
|
- Debian 12
|
|
- Debian 11
|
|
4. Configure CPU, RAM, disk size
|
|
5. Enter your desired **username** and **password**
|
|
6. Click **"Create VM"**
|
|
|
|
### Deployment Times:
|
|
|
|
- **First time using a cloud image**: 5-10 minutes (creates template)
|
|
- **Every time after that**: 30 seconds ⚡
|
|
|
|
---
|
|
|
|
## Troubleshooting
|
|
|
|
### Error: "SSH access not configured"
|
|
|
|
**Fix:** Run the setup script again:
|
|
```bash
|
|
sudo /tmp/enable_cloud_images.sh
|
|
```
|
|
|
|
### Setup script fails with "Permission denied"
|
|
|
|
**Possible causes:**
|
|
- Wrong password
|
|
- SSH password auth disabled on Proxmox
|
|
|
|
**Fix:** Try password again, or manually enable SSH password authentication on Proxmox.
|
|
|
|
### VM boots but no OS
|
|
|
|
**Cause:** Template is missing or corrupt
|
|
|
|
**Fix:** Delete and recreate template:
|
|
```bash
|
|
ssh root@pve.agit8or.net "qm destroy 9001"
|
|
```
|
|
Then create a new VM - template will be recreated.
|
|
|
|
### Can't login to VM
|
|
|
|
**Cause:** Cloud-init didn't configure credentials
|
|
|
|
**Fix:** Check cloud-init logs via Proxmox console:
|
|
```bash
|
|
sudo cat /var/log/cloud-init.log
|
|
```
|
|
|
|
---
|
|
|
|
## Get Help
|
|
|
|
- **Full documentation**: `CLOUD_IMAGES_GUIDE.md`
|
|
- **Check logs**: `sudo journalctl -u depl0y-backend -f`
|
|
- **Verify SSH**: `sudo -u depl0y ssh root@pve.agit8or.net "echo test"`
|
|
- **Check templates**: `ssh root@pve.agit8or.net "qm list | grep 900"`
|
|
|
|
---
|
|
|
|
## Summary
|
|
|
|
✅ **One-time setup**: 1 minute
|
|
✅ **Maintenance**: Zero
|
|
✅ **Deployment time**: 30 seconds
|
|
✅ **Manual installation**: Never again
|
|
|
|
**Questions?** See full guide: `CLOUD_IMAGES_GUIDE.md`
|