Документація
Початок роботи
Шість кроків: від порожнього облікового запису до працюючої віртуальної машини. Вам знадобиться хост із Linux у тій самій мережі, де живе ваш кластер Proxmox, і права root на цьому хості.
Перш ніж почати
- Вузол або кластер Proxmox VE, доступний через HTTPS із того хоста, який ви збираєтеся використати
- 64-бітний x86-хост із Linux і systemd у тій самій мережі, на якому у вас є root
- Шаблон у Proxmox, з якого клонуватимуться машини
Створіть обліковий запис
Зареєструйтеся, і ви одразу опинитеся в панелі з уже запущеним пробним періодом. Платіжних даних ніхто не питає, і хост можна підключити відразу.
Створіть агента
У панелі додайте агента й дайте йому назву, яка каже, де він стоїть, наприклад майданчик або стійку. Код активації панель показує один-єдиний раз, тож збережіть його в надійному місці, перш ніж піти зі сторінки.
Встановіть агента на свій хост
Панель складає команду в один рядок із короткочасним посиланням для встановлення. Виконайте її від імені root на хості з Linux. Вона перевіряє архітектуру, завантажує виконуваний файл, звіряє контрольну суму з платформою, створює службовий обліковий запис і каталоги, отримує файл ліцензії, реєструє агента та запускає службу під systemd.
shellcurl -fsSL https://app.provibr.com/api/install/<token> | shКод активації команда запитує в терміналі, а не приймає його в командному рядку, тож код ніколи не потрапляє ні в історію вашої оболонки, ні до списку процесів.Перевірте, що він піднявся:
shellsystemctl status provibr-agent journalctl -u provibr-agent -fЗа кілька секунд агент зʼявиться в панелі як «у мережі». Якщо цього не сталося, причину назве журнал служби на хості.
Отримайте TLS-відбиток свого вузла Proxmox
Provibr привʼязується саме до того сертифіката, який справді віддає ваш вузол Proxmox. Це власний серверний сертифікат вузла, а не сертифікат центру, що його видав, і не сертифікат зворотного проксі перед ним. Виконайте це з хоста агента, щоб зняти відбиток саме з того, що побачить агент:
shellopenssl s_client -connect pve.example.com:8006 </dev/null 2>/dev/null | \ openssl x509 -noout -fingerprint -sha256Скопіюйте шістнадцяткове значення, розділене двокрапками. Префікс, який openssl друкує перед ним, можна залишити; панель приймає обидва варіанти. Якщо ви замінили сертифікат вузла, зніміть відбиток заново: поновлення його змінює.Те саме значення можна побачити й у вебінтерфейсі Proxmox: у розділі вузла System, далі Certificates, у записі про власний вебсертифікат вузла.
Підключіть інтеграцію Proxmox
У панелі додайте інтеграцію, оберіть Proxmox VE і щойно встановленого агента. Заповніть хост, ідентифікатор API-токена, секрет токена й відбиток із попереднього кроку. Облікові дані один раз передаються цьому агенту й запечатуються в його сейфі; платформа зберігає лише назви полів.
На практиці відбиток не є необовʼязковим. Без нього агент не може вирішити, чи належить вам сертифікат, який йому пропонують, і зʼєднання відхиляється, а не приймається наосліп.Коли інтеграція повідомить, що вона активна, відкрийте її налаштування й задайте назву вузла, сховище та діапазон ID машин, якими Provibr може користуватися. Інтеграція без діапазону не може нічого створити, і це зроблено навмисно: саме діапазон тримає панель подалі від машин, яких ви їй не передавали.
Створіть свою першу машину
Додайте тариф із потрібними ядрами, памʼяттю й диском і вкажіть у ньому пул адрес. Далі створіть сервер: оберіть інтеграцію, тариф і операційну систему для клонування. Панель стежить за завданням клонування, доки воно виконується, і машина зʼявляється вже з адресою з вашого пулу в конфігурації cloud-init.
Якщо щось не вдасться, журнал активності сервера покаже причину, яку повідомив агент, вашою мовою, а під нею наведе дослівну цитату вихідного повідомлення від Proxmox.