Modul Vultr WHMCS

Informace o modulu

Úvod

Požadavky na systém

Předpoklady

Omezení

Rozsah

Vlastnosti modulu

Vytvoření klíče API

Instalace

První nastavení

Konfigurace modulu

Proces objednávání

FAQ

Poznámka : Před instalací modulu Vultr WHMCS si přečtěte celý tento dokument

Informace o modulu

• Verze: 2.0.0 (aktualizováno)
• Datum vydání: 25. června 2019
• Seznam změn
• Odešlete prosím jakékoli zprávy o problémech/chybách do oficiálního úložiště github Vultr WHMCS

Úvod

Platforma Vultr nabízí výkonné rozhraní API bohaté na funkce, které uživatelům umožňuje ovládat každý aspekt jejich účtu. Modul Vultr WHMCS poskytuje poskytovatelům hostingu plně automatizované řešení, které jim umožňuje nabízet svým zákazníkům spolehlivé cloudové servery na platformě Vultr.

Poznámka: Aktuální verze modulu je kompletní přepisem původního modulu, ale je kompatibilní se stávajícími produkty založenými na Vultr ve WHMCS.

Požadavky na systém

• WHMCS verze 7.2.x nebo novější
• PHP verze 7.1.x nebo novější
• MySQL  5.6 , MariaDB  5.6 , MariaDB  10.0 nebo MariaDB  10.1 .
• Zavaděč ionCube.

Předpoklady

• Klíč API Vultr
• IP adresy vašeho serveru WHMCS jsou na seznamu povolených pro přístup k rozhraní API

Poznámky

• Vy musíte whitelist vašeho WHMCS Serveru IPv4 a IPv6 adresy pro přístup k rozhraní API
  • Pokud má váš server více adres IPv4, můžete je přidat na seznam povolených jednotlivě nebo na seznam povolených pro celou podsíť.
  • Pokud má váš server adresu IPv6, je nejlepší přidat na seznam povolených celou podsíť /64
• WHMCS verze 6 není podporována kvůli dosažení konce životnosti.
• PHP verze 7.0.x není podporováno kvůli dosažení konce životnosti.
• Neplánuje se podpora starších verzí WHMCS a PHP.
• Vy musíte použít Volby konfigurovatelné generované modulem pro výrobky. Vytvoření vlastního pravděpodobně způsobí konflikt.

Omezení

Níže jsou seznam možností modul se nebude zahrnovat záměrné.

1. Přidejte další adresy IPv4.
2. Po nasazení virtuálního počítače povolte privátní sítě .
3. Přepínání mezi OS a aplikacemi.
4. Přepínání mezi Linuxem a Windows.

Rozsah

Tento dokument pokryje proces instalace a konfigurace oficiálního modulu Vultr WHMCS. Moduly stažené z webových stránek třetích stran nejsou podporovány Vultr.

Vlastnosti modulu

• Vytvoření produktů VPS na základě Vultr jedním kliknutím
  • Budete muset ručně nastavit ceny pro každý produkt a konfigurovatelnou možnost.
• Nasaďte a upgradujte virtuální stroje
• Funkce zapnutí/vypnutí/cyklování
• HTML5 VNC konzole
• Ovládání rDNS
• Soukromé sítě
• Spouštěcí skripty
• Klíče SSH
• Ovládání snímku
• Nasaďte virtuální počítače ze seznamu předdefinovaných ISO
• Nasaďte virtuální počítače ze seznamu předdefinovaných snímků
• Povolit/zakázat konkrétní ISO a snímky pro nasazení virtuálních počítačů
• Povolit/zakázat umístění nasazení
• Podpora Vultr DNS s podporou Vanity DNS (Custom Nameserver).

Vytvoření klíče API

1. Přihlaste se do klientské oblasti Vultr.
2. Klikněte na Účet.
3. Klikněte na API.
4. Klikněte na Povolit API.
5. Seznam povolených adres IP vašeho serveru WHMCS v části Řízení přístupu.

Instalace

Prvním krokem je stažení modulu Vultr WHMCS zde

Nová instalace

1. Rozbalte archiv ZIP.
2. Nahrajte soubory modulů na váš server WHMCS podle níže definované hierarchie adresářů

Upgradujte ze starší verze modulu

1. Zálohujte databázi a soubory
2. Úplně odstraňte adresáře modules/addons/vultra modules/servers/vultr.
3. Rozbalte a nahrajte nový modul.

Hierarchie adresářů

Stažený archiv

• Moduly
  • doplňky
    • vultr
  • servery
    • vultr

První nastavení

1. Nahrajte modul podle výše uvedených pokynů
2. Přihlaste se do svého administrátorského panelu WHMCS a přejděte na Setup -> Addon Modules.
3. Vedle Vultr Moduleklepněte na Configuretlačítko.
4. Zaškrtněte políčko vedle Hooks Enabled.
5. Do API Keypole zadejte svůj API klíč .
6. Nastavení Access Controlpro Administratora další role, pro které to chcete povolit.
7. Klikněte Save Changes
8. Přihlaste se do svého administrátorského panelu WHMCS a přejděte na Addons -> Vultr Modulepro konfiguraci možností modulu uvedených v další části tohoto dokumentu

Konfigurace modulu

Tato část dokumentace představí všechny dostupné možnosti konfigurace modulu, vysvětlí, jak fungují, a vysvětlí, jak je nakonfigurovat.

Tvůrce produktu

Tato část vám umožní vytvořit produkt založený na Vultr ve WHMCS. Existují dva režimy Single Product Creatora Multiple Product Creator.

Single Product CreatorRežim vám umožní vytvořit produkt na základě dostupných Vultr balíčků, zvolte skupinu výrobků, a ceny pro daný produkt jste přidáváte. Ceny za konfigurovatelné možnosti, jako jsou snímky, Windows, aplikace cPanel atd., musí být ručně přidány do konfigurovatelných možností produktu.

Ve Multi Product Creatorvašem WHMCS hromadně vytvoří balíčky VPS založené na Vultr, ale budete muset ručně nastavit ceny pro každý balíček a také ceny pro konfigurovatelné možnosti, podobně jako v Single Product Creatorrežimu.

produkty

Tato sekce zobrazí úplný seznam všech vašich produktů založených na Vultr ve WHMCS a umožní vám rychle přejít na stránku Editnebo Configurable Options stránku pro každý z nich. Můžete také smazat produkt z této stránky. Tato část je docela užitečná, když chcete rychle najít produkt Vultr ve vaší oblasti správy WHMCS a upravit jej nebo upravit jeho konfigurovatelné možnosti.

DNS

Modul Vultr WHMCS podporuje Vanity Nameservery (vlastní ns1 a ns2.domain.com). Nastavení Vanity Nameservers vyžaduje první krok, kterým je vytvoření vlastních jmenných serverů u vašeho registrátora domény a nasměrování je na IP adresy ns1.vultr.coma řešení ns2.vultr.com. Hotovo, postupujte podle následujících kroků:

1. Přihlaste se do svého administrátorského panelu WHMCS.
2. Pokračuj Addons -> Vultr Module.
3. Klikněte na DNS.
4. Přidejte hodnoty pro Nameserver 1a Nameserver 2a klikněte na Save Changes.
5. Jsi hotový.

Vezměte prosím na vědomí, že Vanity Nameservers jsou aplikovány na nově přidané DNS zóny/domény. Stávající bude nutné upravit na https://my.vultr.com ručně.

Umístění serveru

Máte možnost povolit a zakázat určitá cloudová umístění, a umožnit tak vašim zákazníkům nasazovat virtuální stroje pouze do umístění, která si vyberete. Mějte prosím na paměti, že výběr umístění cloudu během procesu objednávky není možný, protože umístění se načítají dynamicky v závislosti na tom, kde je vybraný balíček dostupný v době nasazení.

Chcete-li vybrat místa, která chcete zákazníkům povolit, postupujte takto:

1. Přihlaste se do svého administrátorského panelu WHMCS.
2. Pokračuj Addons -> Vultr Module.
3. Klikněte na Server Location.
4. Klepnutím na Enabledtlačítko deaktivujete umístění, která chcete deaktivovat (kliknutím na tlačítko, když se Disabledzobrazí, umístění znovu povolíte).
5. Jsi hotový.

Snímky

Modul Vultr WHMCS vám umožňuje vytvořit jeden nebo více snímků na vašem účtu Public– což znamená, že byste svým zákazníkům umožnili nasadit nové virtuální stroje z těchto snímků, pokud se tak rozhodnou. Všechny snímky na vašem účtu jsou v modulu Disabled standardně nastaveny na výchozí hodnotu a budete je muset povolit.

Chcete-li vybrat, které snímky mají být zveřejněny pro vaše zákazníky, postupujte takto:

1. Přihlaste se do svého administrátorského panelu WHMCS.
2. Pokračuj Addons -> Vultr Module.
3. Klikněte na Snapshots.
4. Kliknutím na Disabledtlačítko povolíte snímky, které chcete zveřejnit (kliknutím na tlačítko, když je uvedeno, Enabledsnímek znovu povolíte).
5. Jsi hotový.

ISO

Podobně jako u funkce Snapshot můžete na svůj účet vytvořit jeden nebo více vlastních nahraných ISO Public– což znamená, že byste svým zákazníkům umožnili nasadit nové virtuální stroje z těchto ISO, pokud se tak rozhodnou. Všechny ISO na vašem účtu jsou v modulu Disabled standardně nastaveny na výchozí hodnotu a budete je muset povolit.

Chcete-li vybrat, které snímky mají být zveřejněny pro vaše zákazníky, postupujte takto:

1. Přihlaste se do svého administrátorského panelu WHMCS.
2. Pokračuj Addons -> Vultr Module.
3. Klikněte na ISO.
4. Klepnutím na Disabledtlačítko povolíte ISO, které chcete zveřejnit (kliknutím na tlačítko, když se říká Enabled, znovu povolíte ISO).
5. Jsi hotový.

Proces objednávání

Objednávání produktů založených na Vultr ve WHMCS se skládá ze tří kroků.

Krok 1

Klientské objednávky v klientské oblasti/košíku WHMCS: Klient zadá objednávku na virtuální stroj. Budou požádáni o zadání:

• Název hostitele
• Heslo uživatele root
• NS1 a NS2

Toto je standardní formulář objednávky WHMCS a Vultr nad ním nemá žádnou kontrolu. Můžete změnit šablonu formuláře objednávky WHMCS a skrýt kteroukoli z těchto možností. Prosím, mějte na paměti, že zvolené heslo roota v příkazu k vám nebude používat, protože Vultr své API vygeneruje náhodné bezpečného hesla pro každou VM. Kromě toho, pokud klient nasadí ze snímku, bude muset předem znát heslo uživatele root pro snímek, jinak se nebude moci přihlásit.

Kromě toho bude klient požádán, aby vybral, zda povolit automatické zálohování, limit snímků a typ OS.

Pokud jde o typ operačního systému, v rozbalovací nabídce v objednávkovém formuláři jsou 4 možnostiOS Type

1. Seznam všech dostupných obrazů OS
2. ISO
3. Momentka
4. aplikace

Výběrem Applicationaktivujete seznam všech dostupných nabídek aplikací Vultr na jedno kliknutí. ISO a Snapshot umožní zákazníkovi vybrat, ze kterého ISO nebo Snapshotu nasadí virtuální počítač.

Krok 2

Administrátor schválí objednávku a poskytne službu ve WHMCS (nebo se můžete rozhodnout, že z toho uděláte automatizovaný proces v možnosti produktu ve WHMCS stejným způsobem jako jakýkoli jiný produkt ve WHMCS.

Krok 3

Zákazník by musel dokončit proces objednávání v klientské oblasti výběrem označení/přezdívky pro svůj server, názvu hostitele a dalších možností, jako je klíč SSH, IPv6, privátní síť nebo spouštěcí skript.

FAQ

Zobrazila se mi chyba o selhání připojení.

Ujistěte se, že váš klíč API nemá předponu ani příponu s žádnými mezerami a že adresy IPv4 a IPv6 vašeho serveru jsou na seznamu povolených pro přístup k rozhraní API. Svá pravidla API můžete ověřit v členské oblasti .

Pokud jsou klíč a pravidla ACL správná, můžete svůj klíč dále otestovat přihlášením k serveru WHMCS a spuštěním přímých volání API pomocí cURL. Příklady cURL jsou uvedeny v části příkladů rozhraní API .

Jak určím standardní spouštěcí skript prostřednictvím systému automatického nastavení?

Jak bylo uvedeno, očekává se, že zákazník dokončí nasazení virtuálního stroje v klientské oblasti poté, co si své možnosti přizpůsobí podle svých představ. Mějte prosím na paměti, že seznam umístění se dynamicky vyplňuje v závislosti na dostupnosti vybraného plánu v cloudových umístěních společnosti Vultr – viz Krok 3 výše. Momentálně neexistuje žádná funkce pro nastavení globálního spouštěcího skriptu.

Jak aktualizuji aplikace v možnostech konfigurace?

Pokud chcete vypsat všechny dostupné aplikace, můžete použít tento příkaz API a přidat požadované aplikace do konfigurovatelných možností. V modulu neexistuje automatická synchronizace.