Модуль Vultr WHMCS

• Информация о модуле
• Вступление
• Системные Требования
• Предпосылки
• Ограничения
• Сфера
• Особенности модуля
• Создание ключа API
• Монтаж
• Первая настройка
• Конфигурация модуля
• Процесс заказа
• часто задаваемые вопросы

Примечание . Пожалуйста, полностью прочтите этот документ перед установкой модуля 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.

Предпосылки

• Vultr API Key
• 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
  • Вам нужно будет вручную установить цену для каждого продукта и настраиваемую опцию.
• Развертывание и обновление виртуальных машин
• Включение / выключение / функция цикла
• Консоль HTML5 VNC
• Управление rDNS
• Частная сеть
• Скрипты запуска
• SSH ключи
• Управление снимками
• Развертывание виртуальных машин из списка предварительно определенных ISO
• Развертывание виртуальных машин из списка предварительно определенных снимков
• Включить / отключить определенные ISO и снимки для развертываний виртуальных машин
• Включить / отключить места развертывания
• Поддержка Vultr DNS с поддержкой Vanity DNS (Custom Nameserver)

Создание ключа 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Будет навалом создать Vultr на основе VPS пакетов в вашем WHMCS, но вам придется вручную настроить ценообразование для каждого пакета, а также о ценах на параметры настраиваемых, похожих на 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 применяются к вновь добавленным DNS-зонам / доменам. Существующие должны быть изменены вручную в https://my.vultr.com.

Расположение сервера

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

Чтобы выбрать места для ваших клиентов, выполните следующие действия:

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

Подобно функции моментальных снимков, вы можете создать один или несколько пользовательских загруженных ISO-файлов в своей учетной записи Public- это означает, что вы сможете позволить своим клиентам развертывать новые виртуальные машины из этих ISO-файлов, если они захотят это сделать. Все ISO-образы вашей учетной записи Disabled по умолчанию установлены в модуле, и вам нужно будет их включить.

Чтобы выбрать снимки, которые будут опубликованы для ваших клиентов, выполните следующие действия:

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

Процесс заказа

Заказ продуктов на базе Vultr в WHMCS - это трехэтапный процесс.

Шаг 1

Клиентские заказы в клиентской области WHMCS / корзине: клиент будет размещать заказ на виртуальную машину. Им будет предложено ввести:

• Hostname
• Root Password
• NS1 и NS2

Это стандартная форма заказа WHMCS, и Vultr не контролирует ее. Вы можете изменить шаблон формы заказа WHMCS, чтобы скрыть любой из этих параметров. Помните, что выбранный пароль root в заказе не будет использоваться, поскольку API Vultr будет генерировать случайный безопасный пароль для каждой виртуальной машины. Кроме того, если клиент развертывается из моментального снимка, ему необходимо заранее знать корневой пароль для моментального снимка, иначе он не сможет войти в систему.

Кроме того, клиенту будет предложено выбрать, следует ли включать автоматическое резервное копирование, ограничение моментальных снимков и тип ОС.

Что касается типа ОС, в раскрывающемся меню в форме заказа есть 4 параметра.OS Type

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

Выбор Applicationактивирует список всех доступных предложений Vultr для приложений одним нажатием. ISO и Snapshot позволят заказчику выбрать, из какого ISO или Snapshot развертывать виртуальную машину.

Шаг 2

Администратор утвердит заказ и предоставит услугу в WHMCS (или вы можете сделать этот автоматизированный процесс в опции продукта в WHMCS таким же образом, как и любой другой продукт в WHMCS.

Шаг 3

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

часто задаваемые вопросы

Я получил ошибку об ошибке подключения.

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

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

Как указать стандартный скрипт запуска через систему автоматической настройки?

Как уже говорилось, клиент должен завершить развертывание виртуальной машины в клиентской области после того, как он настроит свои параметры по своему вкусу. Помните, что список местоположений динамически заполняется в зависимости от доступности выбранного плана в облачных хранилищах Vultr - см. Шаг 3 выше. В настоящее время нет функции для настройки глобального сценария запуска.

Как мне обновить приложения в настройках конфигурации?

Если вы хотите перечислить все доступные приложения, вы можете использовать эту команду API и добавить нужные приложения в настраиваемые параметры. Автоматическая синхронизация не существует в модуле.