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

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

PufferPanel

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

Дані OAuth2

PufferPanel автентифікується клієнтом OAuth2, а не ключем API: ідентифікатором клієнта та секретом клієнта. Створіть його в панелі у своєму обліковому записі та вставте обидва в Provibr разом з адресою панелі.

  • Хост: повна адреса панелі, наприклад http://panel.example.com:8080. Порт 8080 типовий для нової інсталяції; панель за зворотним проксі працює на 443, і немає порту, який Provibr міг би додати, не вгадуючи.
  • Ідентифікатор клієнта: ідентифікатор клієнта OAuth2.
  • Секрет клієнта: секрет, що належить цьому клієнту.
  • Відбиток TLS (необовʼязково): лише для хоста https://, щоб закріпити сертифікат.
Секрет клієнта показується один раз, під час створення клієнта. Скопіюйте його одразу: PufferPanel більше його не показує, а наполовину скопійований секрет дає звичайну помилку автентифікації замість того, щоб повідомити, що він неповний.

Що може клієнт, залежить від облікового запису, якому він належить. Надайте йому обліковий запис адміністратора, щоб він міг створювати та видаляти сервери.

Транспорт

Свіжий PufferPanel використовує звичайний HTTP на порту 8080. Якщо панель за TLS із самопідписаним сертифікатом, укажіть його відбиток; тоді агент довіряє лише цьому сертифікату замість того, щоб вимикати перевірку. Прочитайте його за допомогою:

shell
openssl s_client -connect <host>:443 </dev/null 2>/dev/null | \
  openssl x509 -noout -fingerprint -sha256
Команди та вивід термінала всюди англійською і в панелі, і на цих сторінках. Один текст, одна правда: те, що ви читаєте тут, ваш хост виведе дослівно так само.

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

Шаблони

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

Шаблон спільноти типово використовує середовище host, якому потрібні бінарні файли, яких немає на свіжому хості панелі. Provibr перемикається на docker-варіант шаблону, який несе їх у своєму образі: сервер, який інакше не зібрався б через відсутній бінарний файл.

Тарифи

Ігровий тариф несе назву шаблону та обмеження ресурсів. Замовлення йде через тариф, і ручного шляху немає: PufferPanel вимагає повне визначення шаблону inline, а це саме те, що робить за вас каталог.

Розміщення

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

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

Життєвий цикл

Створення, запуск, зупинка, перезапуск, примусова зупинка, перевстановлення та видалення — усе працює. Видалення спершу зупиняє сервер, бо демон відмовляється видаляти запущений контейнер.

Призупинення

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

Оскільки панель не примусово застосовує призупинення, будь-хто з прямим доступом до інсталяції PufferPanel може знову запустити сервер. Блокування — це поняття Provibr, а не панелі, і саме тому чесно казати, що постачальник його не примушує.

Чого Provibr не робить

Немає консолі, бо консоль PufferPanel працює на опитуванні, а не як живий термінал. Немає й графіків, крім процесора та памʼяті, бо це все, що повідомляє точка статистики панелі. Provibr не керує панеллю, її вузлами, файлами, резервними копіями чи користувачами; ігровий сервер на панелі — це інтеграція.