Перейти до вмісту

Документація

Hetzner

Hetzner продає дві речі через два API: Cloud, орендований проєкт із віртуальних серверів із погодинною тарифікацією, і Robot, виділені машини за місячним договором. Ця сторінка про інтеграцію Cloud, єдину, яку можна увімкнути сьогодні, і все на ній випливає з однієї відмінності: хости вам не належать, тож немає вузла, який треба обрати, сховища, яке треба вказати, і діапазону номерів, який треба роздавати.

Одна інтеграція — це один проєкт

Токен API Hetzner належить рівно одному проєкту й не бачить нічого поза ним. Обліковий запис із трьома проєктами стає в нас трьома інтеграціями, кожна зі своїм токеном і власним бюджетом запитів.

Ми не можемо прочитати назву проєкту, бо у Hetzner для цього немає ендпоїнта. Дайте кожній інтеграції назву, яку ви впізнаєте, бо саме вона єдина відрізняє їх у панелі.

Токен

Одне поле, і це всі облікові дані. Створіть його в Hetzner Cloud Console, у розділі Security → API tokens, у межах проєкту, яким має керувати Provibr.

  • Виберіть Read & Write. Токен лише для читання підключається без проблем, і перевірка зʼєднання стає зеленою, бо вона лише читає; збій настає на першій кнопці, яка щось змінює.
  • Токен на читання й запис — це все або нічого: без областей дії, без строку дії, без обмеження за IP. Хто його має, може вилучити будь-який сервер цього проєкту.
  • Вставте токен точно так, як він виглядає. Токен із зайвим пробілом буде відхилено, і Hetzner повідомить про це так само, як про хибний токен.
Токен потрапляє прямо до вашого агента й запечатується там. Платформа зберігає лише те, що інтеграція існує, і ніколи сам токен.

Машини зʼявляються через імпорт

Provibr ігнорує кожен сервер, про який йому нічого не сказано, тож нова інтеграція показує порожній список. Відкрийте інтеграцію, запустіть імпорт і позначте сервери, які хочете бачити в панелі.

Це навмисно: у проєкті зазвичай є й машини, що не мають жодного стосунку до клієнтів, і автоматичне їх приймання внесло б їх у підрахунок потужності без чийогось запиту.

Що можна робити з машиною

Запуск, зупинка, коректне вимкнення, вилучення та перебудова на іншому образі. Вилучення справді вилучає: машина зникає, і тарифікація припиняється. Перебудова зберігає і адресу IPv4, і блок IPv6.

Коректне вимкнення вважається успішним щойно надіслано сигнал ACPI, а не коли гостьова система його виконала. Стан ще кілька секунд може показувати «працює».

Призупинення не існує, і це не вада

Hetzner тарифікує сервер, доки той існує, працює він чи ні. Вимкнення тому коштує вашому клієнтові рівно стільки ж і не дає йому нічого; саме тому Provibr його не пропонує, і застосування ліцензійних обмежень теж цього не робить.

Коли обліковий запис перевищує свій ліміт, Provibr повідомляє про це й відмовляє в нових машинах, але не вимикає жодного сервера Hetzner. Щоб чесно звільнити тут потужність, машину треба вилучити.

Чого ще немає

Томи, фаєрволи та основні IP-адреси є в Hetzner окремими обʼєктами з власним строком життя та власною ціною. Тому тут немає ні вкладки обладнання, ні правил фаєрвола, ні призначення адрес. Призупинити теж неможливо: Hetzner не має власного призупинення, тому машина, яка перевищує вашу потужність, вимикається.

Robot, виділена лінійка Hetzner, — це окрема інтеграція з власним вузлом і власними обліковими даними, і вона ще не підключається. Коли підключиться, вона отримає власний розділ на цій сторінці: кроки справді різні, тож вони лишаться окремо, а не зіллються в одну інструкцію.