Модуль Vultr WHMCS

Примітка : Будь ласка, прочитайте цей документ повністю, перш ніж встановити модуль Vultr WHMCS

Інформація про модуль

• Версія: 2.0.0 (оновлено)
• Дата випуску: 25 червня 2019 року
• Журнал змін
• Будь ласка, надсилайте звіти про будь-які проблеми/помилки в офіційний репозиторій Vultr WHMCS github

Вступ

Платформа Vultr пропонує потужний багатофункціональний API, який дозволяє користувачам контролювати кожен аспект свого облікового запису. Модуль Vultr WHMCS надає хостинг-провайдерам повністю автоматизоване рішення, яке дозволяє їм пропонувати своїм клієнтам надійні хмарні сервери на платформі Vultr.

Примітка: поточна версія модуля є повністю переписаною оригінальним модулем, але сумісна з існуючими продуктами на базі Vultr у WHMCS.

Системні вимоги

• WHMCS версії 7.2.x або новішої
• PHP версії 7.1.x або новішої
• MySQL  5.6 , MariaDB  5.6 , MariaDB  10.0 або MariaDB  10.1 .
• Завантажувач ionCube.

Передумови

• Ключ API Vultr
• Ваші IP-адреси сервера WHMCS додаються до білого списку для доступу до API

Примітки

• Ви повинні внести до білого списку IPv4 та IPv6-адреси свого сервера WHMCS для доступу до API
  • Якщо на вашому сервері є кілька адрес IPv4, ви можете занести їх окремо або всю підмережу.
  • Якщо ваш сервер має IPv6-адресу, найкраще додати всю підмережу /64 у білий список
• Версія WHMCS 6 не підтримується через закінчення терміну служби.
• Версія PHP 7.0.x не підтримується через закінчення терміну служби.
• Немає планів підтримувати старіші версії WHMCS та PHP.
• Ви повинні використовувати настроювані параметри, згенеровані модулем для продуктів. Створення власного, ймовірно, спричинить конфлікт.

Обмеження

Нижче наведено список опцій, які модуль не включає в дизайн.

1. Додайте додаткові адреси IPv4.
2. Увімкніть приватну мережу після розгортання віртуальної машини.
3. Перемикання між ОС і додатками.
4. Перемикання між Linux і Windows.

Область застосування

У цьому документі описано процес встановлення та налаштування офіційного модуля Vultr WHMCS. Модулі, завантажені зі сторонніх веб-сайтів, не підтримуються Vultr.

Особливості модуля

• Створення продуктів VPS в один клік на основі Vultr
  • Вам потрібно буде вручну встановити ціну для кожного продукту та параметра, який можна налаштувати.
• Розгортання та оновлення віртуальних машин
• Функція включення/вимкнення/цикл
• Консоль VNC HTML5
• Контроль rDNS
• Приватна мережа
• Скрипти запуску
• Ключі SSH
• Контроль знімків
• Розгортайте віртуальні машини зі списку попередньо визначених ISO
• Розгортайте віртуальні машини зі списку попередньо визначених знімків
• Увімкнути/вимкнути певні ISO та знімки для розгортань ВМ
• Увімкнути/вимкнути місця розгортання
• Підтримка Vultr DNS з підтримкою Vanity DNS (користувацького сервера імен).

Створення ключа API

1. Увійдіть у клієнтську зону Vultr.
2. Натисніть Обліковий запис.
3. Натисніть API.
4. Натисніть Увімкнути API.
5. Додайте до білого списку IP-адреси вашого сервера WHMCS у розділі «Контроль доступу».

Установка

Першим кроком є завантаження модуля Vultr WHMCS тут

Нова установка

1. Розпакуйте ZIP-архів.
2. Завантажте файли модуля на свій сервер WHMCS, дотримуючись ієрархії каталогів, визначеної нижче

Оновлення зі старішої версії модуля

1. Резервне копіювання бази даних і файлів
2. Повністю видаліть каталоги modules/addons/vultrта modules/servers/vultr.
3. Розпакуйте та завантажте новий модуль.

Ієрархія каталогів

Завантажений архів

• Модулі
  • додатки
    • vultr
  • сервери
    • vultr

Перше налаштування

1. Завантажте модуль, як описано вище
2. Увійдіть до своєї панелі адміністратора WHMCS і перейдіть до Setup -> Addon Modules.
3. Vultr ModuleНатисніть Configureкнопку поруч із .
4. Установіть прапорець біля Hooks Enabled.
5. Введіть свій ключ API в API Keyполе.
6. Установка Access Controlдля Administratorі інші ролі , які ви хочете включити його.
7. Натисніть Save Changes
8. Увійдіть до своєї панелі адміністратора WHMCS і перейдіть до, Addons -> Vultr Moduleщоб налаштувати параметри модуля, представлені в наступному розділі цього документа

Конфігурація модуля

У цьому розділі документації будуть продемонстровані всі доступні параметри конфігурації для модуля, пояснюється, як вони працюють, і пояснюється, як їх налаштувати.

Творець продукту

Цей розділ дозволить вам створити продукт на основі Vultr у WHMCS. Є два режими Single Product Creatorі Multiple Product Creator.

Single Product CreatorРежим дозволить вам створити продукт на основі наявних Vultr пакетів, виберіть групу продуктів і ціни на продукт , який ви додаєте. Ціни на параметри, що налаштовуються, такі як знімки, Windows, програми cPanel тощо… необхідно вручну додати до настроюваних параметрів продукту.

У Multi Product Creatorвашому WHMCS буде масово створюватися пакети VPS на основі Vultr, але вам доведеться вручну налаштувати ціни для кожного пакету, а також ціни для настроюваних параметрів, подібно до Single Product Creatorрежиму.

Продукти

У цьому розділі буде показано повний список усіх ваших продуктів на базі Vultr у WHMCS і дозволить вам швидко перейти до сторінки Editабо Configurable Optionsсторінки для кожного з них. Ви також можете видалити продукт з цієї сторінки. Цей розділ дуже корисний, коли ви хочете швидко знайти продукт Vultr у вашій адмінській зоні WHMCS, щоб змінити його або змінити параметри, що налаштовуються для нього.

DNS

Модуль Vultr WHMCS підтримує сервери імен Vanity (користувацькі ns1 і ns2.domain.com). Налаштування Vanity Nameservers вимагає першого кроку, який полягає в тому, щоб створити користувацькі сервери імен із вашим реєстратором домену та вказати їх на IP-адреси ns1.vultr.comта ns2.vultr.comвирішити. Зроблено, будь ласка, виконайте наведені нижче дії.

1. Увійдіть у свою панель адміністратора WHMCS.
2. Іди далі Addons -> Vultr Module.
3. Натисніть на DNS.
4. Додайте значення для Nameserver 1та Nameserver 2та натисніть Save Changes.
5. Ви закінчили.

Зверніть увагу, що Vanity Nameservers застосовуються до щойно доданих зон/доменів DNS. Існуючі потрібно буде змінити на https://my.vultr.com вручну.

Розташування сервера

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

Щоб вибрати, які місцеположення ввімкнути для своїх клієнтів, виконайте наведені нижче дії.

1. Увійдіть у свою панель адміністратора WHMCS.
2. Іди далі Addons -> Vultr Module.
3. Натисніть на Server Location.
4. Натисніть Enabledкнопку, щоб вимкнути місцеположення, які ви хочете вимкнути (натисніть кнопку, коли на ньому написано, що Disabledце знову ввімкнеться).
5. Ви закінчили.

Знімки

Модуль Vultr WHMCS дозволяє вам зробити один або кілька знімків у вашому обліковому записі, Publicтобто ви дозволите своїм клієнтам розгорнути нові віртуальні машини з цих знімків, якщо вони захочуть це зробити. Усі знімки у вашому обліковому записі встановлені Disabled за замовчуванням у модулі, і вам потрібно буде їх увімкнути.

Щоб вибрати, які знімки опублікувати для своїх клієнтів, виконайте наведені нижче дії.

1. Увійдіть у свою панель адміністратора WHMCS.
2. Іди далі Addons -> Vultr Module.
3. Натисніть на Snapshots.
4. Натисніть Disabledкнопку, щоб увімкнути знімки, які ви бажаєте оприлюднити (натисніть кнопку, коли на ньому Enabledбуде вказано , що знімок знову ввімкнеться).
5. Ви закінчили.

ISO

Подібно до функції Snapshot, ви можете створити один або кілька користувацьких завантажених ISO у своєму обліковому записі, Publicтобто ви дозволите своїм клієнтам розгортати нові віртуальні машини з цих ISO, якщо вони захочуть це зробити. Усі ISO у вашому обліковому записі встановлені Disabled за замовчуванням у модулі, і вам потрібно буде їх увімкнути.

Щоб вибрати, які знімки опублікувати для своїх клієнтів, виконайте наведені нижче дії.

1. Увійдіть у свою панель адміністратора WHMCS.
2. Іди далі Addons -> Vultr Module.
3. Натисніть на ISO.
4. Натисніть Disabledкнопку, щоб увімкнути ISO-файли, які ви бажаєте оприлюднити (натисніть кнопку, коли на ньому написано Enabled, що ISO знову ввімкнеться).
5. Ви закінчили.

Процес замовлення

Замовлення продуктів на основі Vultr у WHMCS складається з трьох кроків.

Крок 1

Замовлення клієнта в клієнтській зоні/кошику WHMCS: клієнт розміщуватиме замовлення на віртуальну машину. Їм буде запропоновано ввести:

• Ім'я хоста
• Пароль Root
• NS1 і NS2

Це стандартна форма замовлення WHMCS, і Vultr не має жодного контролю. Ви можете змінити свій шаблон форми замовлення WHMCS, щоб приховати будь-який з цих параметрів. Майте на увазі, що вибраний пароль root у порядку для не буде використовуватися, оскільки API Vultr згенерує випадковий безпечний пароль для кожної віртуальної машини. Крім того, якщо клієнт розгортається з моментального знімка, йому потрібно заздалегідь знати пароль root для знімка, інакше він не зможе увійти в систему.

Крім того, клієнту буде запропоновано вибрати, чи вмикати автоматичне резервне копіювання, обмеження знімків і тип ОС.

Що стосується типу ОС, у випадаючому меню, що відображається у формі замовлення , є 4 параметриOS Type

1. Список усіх доступних образів ОС
2. ISO
3. Знімок
4. Застосування

Якщо вибрати Application, увімкнеться список усіх доступних пропозицій Vultr для додатків одним кліком. ISO та Snapshot дозволять клієнту вибрати, з якого ISO або Snapshot розгорнути віртуальну машину.

Крок 2

Адміністратор затвердить замовлення та надасть послугу в WHMCS (або ви можете зробити цей процес автоматизованим у варіанті продукту в WHMCS так само, як і будь-який інший продукт у WHMCS.

Крок 3

Клієнту доведе��ься завершити процес замовлення в клієнтській області, вибравши ярлик/псевдонім для свого сервера, ім’я хосту та інші параметри, такі як ключ SSH, IPv6, приватна мережа або сценарій запуску.

FAQ

Я отримав повідомлення про помилку підключення.

Переконайтеся, що ваш ключ API не має префікса чи суфікса з пробілами, а IPv4 та IPv6-адреси вашого сервера внесено в білий список для доступу до API. Ви можете перевірити свої правила API в області членів .

Якщо ключ і правила ACL правильні, ви можете додатково перевірити свій ключ, увійшовши на свій сервер WHMCS і запустивши прямі виклики API за допомогою cURL. Приклади cURL наведено в нашому розділі прикладів API .

Як вказати стандартний сценарій запуску через систему автоматичного налаштування?

Як зазначено, очікується, що клієнт завершить розгортання віртуальної машини в клієнтській області після того, як налаштує свої параметри на свій смак. Пам’ятайте, що список місцеположень динамічно заповнюється залежно від доступності вибраного плану в хмарних розташуваннях Vultr – див. крок 3 вище. Наразі немає функції для налаштування глобального сценарію запуску.

Як оновити програми в параметрах конфігурації?

Якщо ви хочете перерахувати всі доступні програми, ви можете скористатися цією командою API та додати потрібні програми в параметри, які можна налаштувати. Автоматична синхронізація в модулі не існує.