Что получится
шаблон 9000 tpl-ubuntu-2404: облачный образ Ubuntu 24.04, cloud-init, гостевой агент
машина 111 web1: клон шаблона, диск 30 ГБ, адрес 10.0.0.11, вход example-user по ключу
время от клона до входа по SSH — около минуты; если cloud-init ставит обновления — несколько минут
Облачный образ — это уже установленная Ubuntu без пользователя и пароля, около 600 МБ. Всё, что делает
установщик, — пользователь, ключ, сеть, имя — при первой загрузке делает cloud-init. Proxmox подкладывает ему
настройки на маленьком виртуальном CD-ROM (ide2), а cloud-init в госте его читает. Тот же механизм у
провайдеров VPS («cloud-init»).
Команды — в Shell узла от root. Сеть — мост vmbr0 и домашняя 10.0.0.0/24 с роутером 10.0.0.1
(«Сеть Proxmox»); хранилище под диски — local-lvm, на ZFS — local-zfs.
Шаги
Скачиваем облачный образ и сверяем сумму
mkdir -p /root/images && cd /root/images wget https://cloud-images.ubuntu.com/releases/24.04/release/ubuntu-24.04-server-cloudimg-amd64.img wget https://cloud-images.ubuntu.com/releases/24.04/release/SHA256SUMS sha256sum -c --ignore-missing SHA256SUMS # …cloudimg-amd64.img: OKДля Ubuntu 26.04 — то же с
26.04в обоих адресах. Образ Debian 13 —debian-13-genericcloud-amd64.qcow2на cloud.debian.org, дальше всё так же.Кладём ключ, который пустим в машины
Публичный ключ с компьютера, с которого будем входить («Ключи SSH»), — в файл на хосте:
echo 'ssh-ed25519 AAAA…строка целиком… example-user@laptop' > /root/example-user.pubКлючей несколько — по одному в строке того же файла.
Создаём машину из образа
qm create 9000 --name tpl-ubuntu-2404 --ostype l26 \ --cores 2 --cpu host --memory 2048 \ --net0 virtio,bridge=vmbr0 \ --scsihw virtio-scsi-single \ --scsi0 local-lvm:0,import-from=/root/images/ubuntu-24.04-server-cloudimg-amd64.img,discard=on \ --ide2 local-lvm:cloudinit \ --boot order=scsi0 \ --serial0 socket --vga serial0 \ --agent enabled=1Опция Что делает 9000номер машины; шаблоны держим в своём диапазоне, чтобы не путать с рабочими --cpu hostгость видит процессор хоста целиком: быстрее всего, но живая миграция — только на узел с таким же процессором --net0 virtio,bridge=vmbr0сетевая карта VirtIO в домашнем мосте --scsihw virtio-scsi-singleконтроллер VirtIO SCSI, свой на каждый диск — так у диска может быть свой поток ввода-вывода --scsi0 …,import-from=…0— размер не задаём: диск создаётся из образа, размером с образdiscard=onместо, освобождённое в госте, возвращается в тонкий пул («Discard у диска») --ide2 local-lvm:cloudinitдиск cloud-init, на нём Proxmox передаёт настройки --serial0 socket --vga serial0консоль облачных образов идёт в последовательный порт --agent enabled=1Proxmox будет общаться с гостевым агентом: выключение, адреса, заморозка диска при бэкапе («Гостевой агент») Строка за строкой то же в конфиге машины — «Конфиг VM Proxmox».
Настраиваем cloud-init и превращаем в шаблон
qm set 9000 --ciuser example-user --sshkeys /root/example-user.pub \ --nameserver "1.1.1.1 9.9.9.9" --ipconfig0 ip=dhcp qm template 9000--ciuser— пользователь сsudoбез пароля; пароль не задаём, вход только по ключу.--nameserver— без него машина возьмёт DNS из настроек хоста.--ipconfig0 ip=dhcp— по умолчанию адрес от роутера; у клона заменим на свой.- При первой загрузке cloud-init обновляет пакеты: опция Upgrade packages, в консоли
--ciupgrade. Ради скорости её выключают (--ciupgrade 0), тогда обновляемся сами после входа.
До
qm templateмашину не запускаем. После первой загрузки в образе появится свой/etc/machine-id, и все клоны получат его копию: у них совпадут идентификаторы DHCP и адреса.После
qm templateмашина 9000 становится шаблоном: она больше не запускается, её диск только для чтения, а значок в дереве другой.Добавляем гостевой агент в шаблон
В облачном образе Ubuntu нет
qemu-guest-agent. Чтобы не ставить его руками в каждую машину, отдаём cloud-init ещё один файл — vendor-data. Сначала разрешаем хранилищуlocalхранить сниппеты: Datacenter › Storage ›local› Edit › Content — добавляем Snippets. Затем:cat > /var/lib/vz/snippets/vendor-agent.yaml <<'EOF' #cloud-config packages: - qemu-guest-agent runcmd: - systemctl start qemu-guest-agent EOF qm set 9000 --cicustom "vendor=local:snippets/vendor-agent.yaml"Пользователя, ключ и сеть Proxmox по-прежнему пишет сам:
vendor=заменяет только vendor-data, остальные части cloud-init не трогает. Агент поставится при первой загрузке каждого клона1; если нет — ставим руками,sudo apt install qemu-guest-agent(«Гостевой агент»).Клонируем машину
qm clone 9000 111 --name web1 --full qm set 111 --ipconfig0 ip=10.0.0.11/24,gw=10.0.0.1 qm disk resize 111 scsi0 30G qm set 111 --onboot 1 qm start 111 qm terminal 111 # видно загрузку; выход — Ctrl+O--full— полный клон, независимая копия диска. Без него клон связанный: занимает меньше и создаётся мгновенно, но держится на диске шаблона — шаблон тогда не удалить, пока жив хоть один клон.- Имя машины (
--name) cloud-init делаетhostname. qm disk resizeдо первой загрузки: cloud-init сам растянет раздел до 30 ГБ.--onboot 1— машина запустится после перезагрузки хоста.
Первая загрузка идёт дольше следующих: cloud-init создаёт пользователя, ставит агент, а с
ciupgrade— и обновления. Готово, когда в консоли строкаCloud-init … finished.Входим
ssh [email protected] cloud-init status # status: done hostname # web1 df -h / # /dev/sda1 29G …С хоста — что агент отвечает:
qm guest cmd 111 ping # пустой вывод и код 0 — агент на связи qm guest cmd 111 network-get-interfaces # адреса машины глазами агентаДальше машина — обычный сервер на Ubuntu: первый вход и защита — «Первый вход на сервер», Docker — «Docker на Ubuntu».
Если не работает
qm create падает: storage 'local-lvm' does not exist
- Причина
- Хост ставили на ZFS: хранилище под диски называется
local-zfs. - Делаем
- Смотрим имена в
pvesm statusи подставляем своё в--scsi0и--ide2. Или задаём его один раз,STORAGE=local-zfs, и дальше пишем$STORAGE:0,….
Консоль машины в noVNC пустая или пишет starting serial terminal
- Причина
- У машины
--vga serial0: экрана нет, консоль идёт в последовательный порт, а облачные образы Ubuntu выводят туда загрузку. - Делаем
- Console › xterm.js в интерфейсе или
qm terminal 111на хосте; выход — Ctrl+O. Если загрузка не видна, жмём Enter — появится приглашение входа.
ssh [email protected] — Permission denied (publickey)
- Причина
- Ключ не попал в cloud-init: файл в
--sshkeysпустой, ключ не тот, или пользователь в--ciuserдругой. - Делаем
qm cloudinit dump 111 user— в выводеssh_authorized_keysс нужным ключом иnameпользователя. Правимqm setи пересоздаём машину из шаблона: cloud-init применяет пользователя только при первой загрузке.
Два клона получают от роутера один и тот же адрес
- Причина
- Шаблон до превращения в шаблон загружали: в нём остался
/etc/machine-id, и у клонов он одинаковый.systemd-networkdстроит из него идентификатор DHCP, и роутер видит одно устройство. - Делаем
- В каждом клоне:
sudo truncate -s 0 /etc/machine-id && sudo rm -f /var/lib/dbus/machine-id && sudo reboot. Шаблон впредь доqm templateне запускаем.
Увеличили диск, а df -h / показывает старый размер
- Причина
- cloud-init растягивает раздел только при первой загрузке. Диск увеличили после неё.
- Делаем
- В машине:
sudo growpart /dev/sda 1 && sudo resize2fs /dev/sda1.
Машина пингует 1.1.1.1, а имена не резолвятся
- Причина
- Без
--nameserverмашина берёт DNS из настроек хоста. Если хост смотрит в DNS, недоступный из сети гостей, имена в госте не резолвятся. - Делаем
qm set 111 --nameserver "1.1.1.1 9.9.9.9"и перезагрузка машины — cloud-init перепишет сеть.
Как проверить
Второй клон — та же команда с другим номером, именем и адресом:
qm clone 9000 112 --name web2 --full && qm set 112 --ipconfig0 ip=10.0.0.12/24,gw=10.0.0.1 && qm start 112
Через минуту ssh [email protected] входит по ключу, hostname печатает web2, а в дереве Proxmox у машины 112
на вкладке Summary видны её адреса — их передал гостевой агент. Обе машины отвечают на свои адреса, и у них
разные cat /etc/machine-id.
Ещё не проверено
- qemu-guest-agent ставится из vendor-data при первой загрузке клона Ubuntu 24.04 ↑