Modulo Vultr WHMCS

• Informazioni sul modulo
• introduzione
• Requisiti di sistema
• Prerequisiti
• limitazioni
• Scopo
• Caratteristiche del modulo
• Creazione di una chiave API
• Installazione
• Prima installazione
• Configurazione del modulo
• Processo di ordinazione
• FAQ

Nota : leggere questo documento per intero prima di installare il modulo Vultr WHMCS

Informazioni sul modulo

• Versione: 2.0.0 (aggiornato)
• Data di uscita: 25 giugno 2019
• changelog
• Invia eventuali segnalazioni di problemi / bug al repository github ufficiale di Vultr WHMCS

introduzione

La piattaforma Vultr offre un'API potente e ricca di funzionalità che consente agli utenti di controllare ogni aspetto del proprio account. Il modulo Vultr WHMCS fornisce ai provider di hosting una soluzione completamente automatizzata che consente loro di offrire ai propri clienti server cloud affidabili sulla piattaforma Vultr.

Nota: la versione corrente del modulo è una riscrittura completa del modulo originale, ma è compatibile con i prodotti basati su Vultr esistenti in WHMCS.

Requisiti di sistema

• WHMCS versione 7.2.xo successiva
• PHP versione 7.1.xo successiva
• MySQL  5.6 , MariaDB  5.6 , MariaDB  10.0 o MariaDB  10.1 .
• Caricatore ionCube.

Prerequisiti

• Chiave API Vultr
• L'IP del tuo server WHMCS è stato autorizzato per l'accesso API

Appunti

• È necessario autorizzare gli indirizzi IPv4 e IPv6 del server WHMCS per l'accesso API
  • Se il tuo server ha più indirizzi IPv4, puoi inserirli nella whitelist singolarmente o nella whitelist dell'intera sottorete.
  • Se il tuo server ha un indirizzo IPv6, è meglio autorizzare l'intera sottorete / 64
• WHMCS versione 6 non è supportata a causa del raggiungimento del termine del ciclo di vita.
• La versione 7.0.x di PHP non è supportata a causa del raggiungimento del termine del ciclo di vita.
• Non ci sono piani per supportare la versione precedente di WHMCS e PHP.
• È necessario utilizzare le Opzioni configurabili generate dal modulo per i prodotti. La creazione della tua probabilmente causerà un conflitto.

limitazioni

Di seguito è riportato l'elenco delle opzioni che il modulo non include in base alla progettazione.

1. Aggiungi altri indirizzi IPv4.
2. Abilitare la rete privata dopo aver distribuito una macchina virtuale.
3. Passare da SO a App.
4. Passare da Linux a Windows.

Scopo

Questo documento coprirà il processo di installazione e configurazione del modulo Vultr WHMCS ufficiale. I moduli scaricati da siti Web di terzi non sono supportati da Vultr.

Caratteristiche del modulo

• Creazione con un clic di prodotti VPS basati su Vultr
  • Sarà necessario impostare manualmente il prezzo per ciascun prodotto e opzione configurabile.
• Distribuire e aggiornare macchine virtuali
• Funzione di accensione / spegnimento / ciclo
• Console VNC HTML5
• Controllo rDNS
• Networking privato
• Script di avvio
• Chiavi SSH
• Controllo snapshot
• Distribuire macchine virtuali da un elenco di ISO predefiniti
• Distribuire macchine virtuali da un elenco di istantanee predefinite
• Abilita / Disabilita ISO e snapshot specifici per le distribuzioni di macchine virtuali
• Abilita / Disabilita posizioni di distribuzione
• Supporto DNS Vultr con supporto Vanity DNS (Custom Nameserver)

Creazione di una chiave API

1. Accedi all'Area client Vultr.
2. Fai clic su Account.
3. Fai clic su API.
4. Fai clic su Abilita API.
5. Autorizza gli indirizzi IP del tuo server WHMCS sotto Controllo accessi.

Installazione

Il primo passo è scaricare qui il modulo Vulm WHMCS

Nuova installazione

1. Estrarre l'archivio ZIP.
2. Caricare i file del modulo sul server WHMCS seguendo la gerarchia di directory definita di seguito

Esegui l'upgrade da una versione precedente del modulo

1. Eseguire il backup del database e dei file
2. Elimina completamente le directory modules/addons/vultre modules/servers/vultr.
3. Estrai e carica il nuovo modulo.

Gerarchia di directory

Archivio scaricato

• moduli
  • addons
    • vultr
  • server
    • vultr

Prima installazione

1. Carica il modulo come indicato sopra
2. Accedi al tuo pannello di amministrazione WHMCS e vai a Setup -> Addon Modules.
3. Accanto a Vultr Module, fai clic sul Configurepulsante.
4. Spuntare la casella accanto a Hooks Enabled.
5. Inserisci la tua chiave API nel API Keycampo.
6. Installazione Access Controlper Administratore altri ruoli per cui si desidera abilitarlo.
7. Clic Save Changes
8. Accedi al tuo pannello di amministrazione WHMCS e vai a Addons -> Vultr Moduleconfigurare le opzioni del tuo modulo presenti nella sezione successiva di questo documento

Configurazione del modulo

Questa sezione della documentazione mostrerà tutte le opzioni di configurazione disponibili per il modulo, spiegherà come funzionano e spiegherà come configurarle.

Creatore del prodotto

Questa sezione ti consentirà di creare un prodotto basato su Vultr in WHMCS. Esistono due modalità Single Product Creatore Multiple Product Creator.

La Single Product Creatormodalità ti permetterà di creare un prodotto basato sui pacchetti Vultr disponibili, selezionare un gruppo di prodotti e prezzi per il prodotto che stai aggiungendo. I prezzi per le opzioni configurabili come istantanee, Windows, app cPanel ecc ... devono essere aggiunti manualmente alle opzioni configurabili del prodotto.

La Multi Product Creatorvolontà bulk-creare Vultr basati VPS pacchetti nel vostro WHMCS, ma si dovrà impostare manualmente il prezzo per ogni pacchetto così come sui prezzi per le opzioni configurabili, in modo simile alla Single Product Creatormodalità.

Prodotti

Questa sezione mostrerà un elenco completo di tutti i tuoi prodotti basati su Vultr in WHMCS e ti permetterà di navigare rapidamente alla pagina Edito Configurable Optionsper ciascuno di essi. Puoi anche eliminare un prodotto da quella pagina. Questa sezione è molto utile per quando si desidera trovare rapidamente un prodotto Vultr nella propria area di amministrazione WHMCS per modificarlo o modificare le opzioni configurabili per esso.

DNS

Il modulo Vultr WHMCS supporta Vanity Nameservers (personalizzati ns1 e ns2.domain.com). L'impostazione di Vanity Nameservers richiede un primo passo, ovvero creare i server dei nomi personalizzati con il registrar del dominio e indirizzarli agli IP ns1.vultr.come ns2.vultr.comrisolverli. Uno fatto, si prega di seguire i passaggi seguenti:

1. Accedi al tuo pannello di amministrazione WHMCS.
2. Vai avanti Addons -> Vultr Module.
3. Clicca su DNS.
4. Aggiungere i valori per Nameserver 1e Nameserver 2quindi fare clic su Save Changes.
5. Hai finito.

Si noti che i Nameserver Vanity vengono applicati alle Zone / domini DNS appena aggiunti. Quelli esistenti dovranno essere modificati manualmente in https://my.vultr.com.

Posizione del server

Hai la possibilità di abilitare e disabilitare determinate posizioni cloud, consentendo così ai tuoi clienti di distribuire macchine virtuali solo nelle posizioni scelte. Tieni presente che non è possibile selezionare la posizione cloud durante il processo di ordine poiché le posizioni vengono caricate in modo dinamico a seconda di dove è disponibile il pacchetto selezionato al momento della distribuzione.

Per selezionare le posizioni da abilitare per i tuoi clienti, procedi nel seguente modo:

1. Accedi al tuo pannello di amministrazione WHMCS.
2. Vai avanti Addons -> Vultr Module.
3. Clicca su Server Location.
4. Fare clic sul Enabledpulsante per disabilitare le posizioni che si desidera disabilitare (facendo clic sul pulsante quando si dice Disabledche riattiverà la posizione).
5. Hai finito.

istantanee

Il modulo Vultr WHMCS ti consente di creare una o più istantanee sul tuo account Public, il che significa che permetteresti ai tuoi clienti di distribuire nuove macchine virtuali da queste istantanee se decidessero di farlo. Tutte le istantanee sul tuo account sono impostate per Disabled impostazione predefinita nel modulo e dovresti abilitarle.

Per selezionare le istantanee da rendere pubbliche per i tuoi clienti, procedi nel seguente modo:

1. Accedi al tuo pannello di amministrazione WHMCS.
2. Vai avanti Addons -> Vultr Module.
3. Clicca su Snapshots.
4. Fare clic sul Disabledpulsante per abilitare le istantanee che si desidera rendere pubbliche (facendo clic sul pulsante quando si dice Enabledche riattiverà l'istantanea).
5. Hai finito.

ISO

Simile alla funzione Snapshot, puoi creare una o più ISO personalizzate caricate sul tuo account Public, il che significa che permetteresti ai tuoi clienti di distribuire nuove macchine virtuali da queste ISO se scelgono di farlo. Tutte le ISO sul tuo account sono impostate di Disabled default nel modulo e dovresti abilitarle.

Per selezionare le istantanee da rendere pubbliche per i tuoi clienti, procedi nel seguente modo:

1. Accedi al tuo pannello di amministrazione WHMCS.
2. Vai avanti Addons -> Vultr Module.
3. Clicca su ISO.
4. Fai clic sul Disabledpulsante per abilitare gli ISO che desideri rendere pubblici (facendo clic sul pulsante quando dice Enabledche riattiverà l'ISO).
5. Hai finito.

Processo di ordinazione

Ordinare prodotti basati su Vultr in WHMCS è un processo in tre fasi.

Passo 1

Ordini dei clienti nell'area clienti / carrello WHMCS: il cliente effettuerà un ordine per una macchina virtuale. Verrà chiesto di inserire:

• Nome host
• Password di root
• NS1 e NS2

Questo è il modulo d'ordine WHMCS standard e Vultr non ha alcun controllo. È possibile modificare il modello del modulo d'ordine WHMCS per nascondere una di queste opzioni. Tieni presente che la password di root selezionata nell'ordine per non verrà utilizzata poiché l'API di Vultr genererà una password sicura casuale per ogni VM. Inoltre, se un client distribuisce da uno Snapshot, dovrà prima conoscere la password di root dello Snapshot, altrimenti non sarà in grado di accedere.

Inoltre, al client verrà chiesto di selezionare se abilitare o meno i backup automatici, il limite dell'istantanea e il tipo di sistema operativo.

Per quanto riguarda il tipo di sistema operativo, ci sono 4 opzioni nel menu a discesa che appare sotto OS Typenel modulo d'ordine

1. Un elenco di tutte le immagini del sistema operativo disponibili
2. ISO
3. istantanea
4. Applicazione

La selezione Applicationconsentirà un elenco di tutte le offerte disponibili di Vultr sulle app con un clic. ISO e Snapshot consentiranno al cliente di selezionare da quale ISO o Snapshot distribuire la macchina virtuale.

Passo 2

L'amministratore approverebbe l'ordine e fornirà il servizio in WHMCS (oppure è possibile scegliere di effettuare un processo automatizzato nell'opzione prodotto in WHMCS allo stesso modo di qualsiasi altro prodotto in WHMCS.

Passaggio 3

Il cliente dovrebbe finalizzare il processo di ordinazione nell'area client scegliendo un Lable / Nickname per il proprio server, un nome host e altre opzioni come chiave SSH, IPv6, rete privata o script di avvio.

FAQ

Ho ricevuto un errore per errore di connessione.

Assicurati che la tua chiave API non abbia il prefisso o il suffisso con nessuno spazio bianco e che gli indirizzi IPv4 e IPv6 del tuo server siano entrambi autorizzati per l'accesso API. Puoi verificare le tue regole API nell'area membri .

Se le regole chiave e ACL sono corrette, è possibile testare ulteriormente la chiave accedendo al server WHMCS ed eseguendo chiamate API dirette utilizzando cURL. esempi cURL sono forniti nella nostra sezione di esempio API .

Come posso specificare uno script di avvio standard tramite il sistema di configurazione automatica?

Come detto, il cliente dovrebbe finalizzare l'implementazione della macchina virtuale nell'area client dopo aver personalizzato le proprie opzioni a proprio piacimento. Tieni presente che l'elenco di posizioni viene popolato dinamicamente in base alla disponibilità del piano selezionato tra le posizioni cloud di Vultr: vedi il passaggio 3 sopra. Al momento non esiste alcuna funzione per impostare uno script di avvio globale.

Come aggiorno le applicazioni nelle opzioni di configurazione?

Se si desidera elencare tutte le applicazioni disponibili, è possibile utilizzare questo comando API e aggiungere le applicazioni desiderate nelle opzioni configurabili. La sincronizzazione automatica non esiste nel modulo.