basforge

Ищем по названиям, тексту и разборам «Если не работает».

    EN
    МануалHomelabProxmox

    Шаблон Ubuntu с cloud-init в Proxmox: машина с ключом и адресом за минуту

    Облачный образ Ubuntu превращаем в шаблон Proxmox, а cloud-init при первой загрузке клона ставит пользователя, ключ SSH, адрес и имя машины. Установщик не нужен: новая машина — qm clone, две строки настройки и qm start, через минуту в неё входим по ключу. Этим же путём делаются тестовые серверы под мануалы.

    Что получится

    шаблон 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.

    Шаги

    1. Скачиваем облачный образ и сверяем сумму

      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, дальше всё так же.

    2. Кладём ключ, который пустим в машины

      Публичный ключ с компьютера, с которого будем входить («Ключи SSH»), — в файл на хосте:

      echo 'ssh-ed25519 AAAA…строка целиком… example-user@laptop' > /root/example-user.pub

      Ключей несколько — по одному в строке того же файла.

    3. Создаём машину из образа

      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=1 Proxmox будет общаться с гостевым агентом: выключение, адреса, заморозка диска при бэкапе («Гостевой агент»)

      Строка за строкой то же в конфиге машины — «Конфиг VM Proxmox».

    4. Настраиваем 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 становится шаблоном: она больше не запускается, её диск только для чтения, а значок в дереве другой.

    5. Добавляем гостевой агент в шаблон

      В облачном образе 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 («Гостевой агент»).

    6. Клонируем машину

      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.

    7. Входим

      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.

    Ещё не проверено

    1. qemu-guest-agent ставится из vendor-data при первой загрузке клона Ubuntu 24.04 ↑