Módulo Vultr WHMCS

• Informações do módulo
• Introdução
• Requisitos de sistema
• Pré-requisitos
• Limitações
• Escopo
• Recursos do módulo
• Criando uma chave de API
• Instalação
• Primeira instalação
• Configuração do módulo
• Processo de encomenda
• Perguntas frequentes

Nota : Leia este documento na íntegra antes de instalar o Módulo Vultr WHMCS

Informações do módulo

• Versão: 2.0.0 (Atualizado)
• Data de lançamento: 25 de junho de 2019
• Changelog
• Envie quaisquer relatórios de problemas / bug ao repositório oficial do Vultr WHMCS github

Introdução

A plataforma Vultr oferece uma API poderosa e rica em recursos que permite aos usuários controlar todos os aspectos de sua conta. O Módulo Vultr WHMCS fornece aos provedores de hospedagem uma solução totalmente automatizada que lhes permite oferecer Servidores em Nuvem confiáveis ​​na Plataforma Vultr para seus clientes.

Nota: A versão atual do módulo é uma reescrita completa do módulo original, mas é compatível com os produtos baseados em Vultr existentes no WHMCS.

Requisitos de sistema

• WHMCS versão 7.2.x ou mais recente
• PHP versão 7.1.x ou mais recente
• MySQL  5.6 , MariaDB  5.6 , MariaDB  10.0 ou MariaDB  10.1 .
• Carregador ionCube.

Pré-requisitos

• Chave da API Vultr
• Os IPs do servidor WHMCS estão na lista de permissões para acesso à API

Notas

• Você deve colocar na lista branca os endereços IPv4 e IPv6 do servidor WHMCS para acesso à API
  • Se o seu servidor tiver vários endereços IPv4, você poderá colocá-los na lista de permissões individualmente ou na sub-rede inteira.
  • Se o seu servidor tiver um endereço IPv6, é melhor colocar na lista de permissões toda a sub-rede / 64
• O WHMCS Versão 6 não é suportado devido ao fim da vida útil.
• O PHP Versão 7.0.x não é suportado devido ao fim da vida útil.
• Não há planos para suportar a versão mais antiga do WHMCS e PHP.
• Você deve usar as Opções configuráveis ​​geradas pelo módulo para os produtos. Criar o seu próprio provavelmente causará um conflito.

Limitações

Abaixo está a lista de opções que o módulo não inclui por design.

1. Adicione endereços IPv4 adicionais.
2. Habilite a Rede Privada após a implantação de uma máquina virtual.
3. Alternando entre SO e Aplicativos.
4. Alternando entre Linux e Windows.

Escopo

Este documento abordará o processo de instalação e configuração do módulo Vultr WHMCS oficial. Módulos baixados de sites de terceiros não são suportados pelo Vultr.

Recursos do módulo

• Criação com um clique de produtos VPS com base no Vultr
  • Você precisará definir manualmente os preços para cada produto e opção configurável.
• Implantar e atualizar máquinas virtuais
• Recurso de ligar / desligar / ciclo
• Console VNC HTML5
• Controle rDNS
• Rede Privada
• Scripts de inicialização
• Chaves SSH
• Controle de instantâneo
• Implantar VMs de uma lista de ISOs predefinidos
• Implantar VMs de uma lista de instantâneos predefinidos
• Habilitar / desabilitar ISOs e instantâneos específicos para implantações de VM
• Ativar / desativar locais de implantação
• Suporte a Vultr DNS com suporte a Vanity DNS (servidor de nomes personalizado)

Criando uma chave de API

1. Faça login na área do cliente Vultr.
2. Clique em conta.
3. Clique em API.
4. Clique em Ativar API.
5. Lista de permissões os endereços IP do seu servidor WHMCS sob Controle de acesso.

Instalação

O primeiro passo é fazer o download do módulo Vultr WHMCS aqui

Nova instalação

1. Extraia o arquivo ZIP.
2. Faça o upload dos arquivos do módulo para o servidor WHMCS, seguindo a hierarquia de diretórios definida abaixo

Atualização de uma versão mais antiga do módulo

1. Faça backup de seu banco de dados e arquivos
2. Completamente excluir o modules/addons/vultre modules/servers/vultrdiretórios.
3. Extraia e faça o upload do novo módulo.

Hierarquia de diretórios

Arquivo baixado

• Módulos
  • addons
    • vultr
  • servidores
    • vultr

Primeira instalação

1. Carregue o módulo conforme as instruções acima
2. Faça login no painel de administração do WHMCS e navegue até Setup -> Addon Modules.
3. Ao lado de Vultr Module, clique no Configurebotão
4. Marque a caixa de seleção ao lado de Hooks Enabled.
5. Digite sua chave de API no API Keycampo
6. Configuração Access Controlpara Administratore outras funções que você deseja habilitá-lo.
7. Clique Save Changes
8. Entre no painel de administração do WHMCS e navegue para Addons -> Vultr Moduleconfigurar as opções do módulo apresentadas na próxima seção deste documento

Configuração do módulo

Esta seção da documentação mostra todas as opções de configuração disponíveis para o módulo, explica como elas funcionam e como configurá-las.

Criador de produtos

Esta seção permitirá que você crie um produto baseado em Vultr no WHMCS. Existem dois modos, Single Product Creatore Multiple Product Creator.

O Single Product Creatormodo permitirá que você crie um produto com base nos pacotes Vultr disponíveis, selecione um Grupo de produtos e preços para o produto que você está adicionando. Os preços das opções configuráveis, como Snapshots, Windows, cPanel Apps, etc., devem ser adicionados manualmente às Opções configuráveis ​​do produto.

Ele Multi Product Creatorcriará em massa pacotes VPS baseados em Vultr no seu WHMCS, mas você precisará configurar manualmente o preço de cada pacote e o preço das Opções configuráveis, semelhantes ao Single Product Creatormodo.

Produtos

Esta seção mostrará uma lista completa de todos os seus produtos baseados em Vultr no WHMCS e permitirá que você navegue rapidamente para Edita Configurable Options página ou para cada um deles. Você também pode excluir um produto dessa página. Esta seção é bastante útil para quando você deseja encontrar rapidamente um produto Vultr na sua área de administração do WHMCS para modificá-lo ou modificar as opções configuráveis ​​para ele.

DNS

O Módulo Vultr WHMCS suporta Vanity Nameservers (ns1 e ns2.domínio.com personalizados). A configuração dos Vanity Nameservers requer uma primeira etapa, que é criar os servidores de nomes personalizados com o registrador de domínio, apontá-los para os IPs ns1.vultr.come ns2.vultr.comresolver os problemas. Feito isso, siga as etapas abaixo:

1. Entre no seu painel de administração do WHMCS.
2. Continue Addons -> Vultr Module.
3. Clique em DNS.
4. Adicione os valores para Nameserver 1e Nameserver 2e clique em Save Changes.
5. Você Terminou.

Observe que os Vanity Nameservers são aplicados a áreas / domínios DNS recém-adicionados. Os existentes terão que ser modificados em https://my.vultr.com manualmente.

Localização do Servidor

Você tem a opção de ativar e desativar determinados locais na nuvem, permitindo que seus clientes implantem máquinas virtuais apenas nos locais que você escolher. Lembre-se de que não é possível selecionar o local da nuvem durante o processo do pedido, pois os locais são carregados dinamicamente, dependendo de onde o pacote selecionado está disponível no momento da implantação.

Para selecionar quais locais ativar para seus clientes, siga as etapas abaixo:

1. Entre no seu painel de administração do WHMCS.
2. Continue Addons -> Vultr Module.
3. Clique em Server Location.
4. Clique no Enabledbotão para desativar os locais que você deseja desativar (clique no botão quando ele Disabledreativar o local).
5. Você Terminou.

Instantâneos

O Módulo Vultr WHMCS permite que você faça um ou mais instantâneos em sua conta Public- o que significa que você permitiria que seus clientes implantassem novas máquinas virtuais a partir desses instantâneos, se assim o fizessem. Todos os instantâneos da sua conta estão definidos como Disabled padrão no módulo e você precisará ativá-los.

Para selecionar quais instantâneos tornar públicos para seus clientes, siga as etapas abaixo:

1. Entre no seu painel de administração do WHMCS.
2. Continue Addons -> Vultr Module.
3. Clique em Snapshots.
4. Clique no Disabledbotão para ativar os Snapshots que você deseja tornar públicos (clique no botão quando ele disser Enabledque reativará o Snapshot).
5. Você Terminou.

ISO

De maneira semelhante ao recurso Snapshot, você pode criar um ou mais dos ISOs personalizados enviados em sua conta Public- o que significa que permitiria que seus clientes implantassem novas máquinas virtuais desses ISOs, se assim o fizessem. Todos os ISOs da sua conta estão definidos Disabled por padrão no módulo e você precisará ativá-los.

Para selecionar quais instantâneos tornar públicos para seus clientes, siga as etapas abaixo:

1. Entre no seu painel de administração do WHMCS.
2. Continue Addons -> Vultr Module.
3. Clique em ISO.
4. Clique no Disabledbotão para ativar os ISOs que você deseja tornar públicos (clique no botão quando houver Enabledreativação do ISO).
5. Você Terminou.

Processo de encomenda

A compra de produtos baseados em Vultr no WHMCS é um processo de três etapas.

Passo 1

Pedidos do cliente na área / carrinho do cliente WHMCS: O cliente fará um pedido para uma máquina virtual. Eles deverão entrar:

• nome de anfitrião
• Senha Root
• NS1 & NS2

Este é o Formulário de Pedido WHMCS padrão e o Vultr não tem controle. Você pode alterar seu modelo de formulário de pedido do WHMCS para ocultar qualquer uma dessas opções. Lembre-se de que a senha raiz selecionada na ordem de não será usada, pois a API do Vultr gerará uma senha segura aleatória para cada VM. Além disso, se um cliente implantar a partir de um instantâneo, ele precisará saber a senha raiz do instantâneo com antecedência, caso contrário, não poderá efetuar login.

Além disso, o cliente será solicitado a selecionar se deseja ou não ativar os backups automáticos, o limite de instantâneos e o tipo de sistema operacional.

No que diz respeito ao tipo de sistema operacional, existem 4 opções no menu suspenso, exibidas OS Typeem Formulário de pedido

1. Uma lista de todas as Imagens de SO disponíveis
2. ISO
3. Instantâneo
4. Inscrição

A seleção Applicationativará uma lista de todas as ofertas disponíveis do One-Click Apps Vultr. O ISO e o Snapshot permitirão ao cliente selecionar em qual ISO ou Snapshot implantar a Máquina Virtual.

Passo 2

O administrador aprovaria o pedido e forneceria o serviço no WHMCS (ou você pode optar por tornar esse processo automatizado na opção do produto no WHMCS da mesma maneira que qualquer outro produto no WHMCS.

etapa 3

O cliente precisaria finalizar o processo de pedido na área do cliente, escolhendo uma etiqueta / apelido para o servidor, um nome de host e outras opções, como chave SSH, IPv6, rede privada ou script de inicialização.

Perguntas frequentes

Eu recebi um erro sobre falha na conexão.

Verifique se a chave da API não possui prefixo ou sufixo em nenhum espaço em branco e se os endereços IPv4 e IPv6 do servidor estão na lista branca para acesso à API. Você pode verificar suas regras de API na área de membros .

Se as regras de chave e ACL estiverem corretas, você poderá testar sua chave ainda mais, efetuando login no servidor WHMCS e executando chamadas diretas de API utilizando cURL. Exemplos de cURL são fornecidos em nossa seção de exemplos da API .

Como especifico um script de inicialização padrão por meio do sistema de configuração automática?

Conforme declarado, o cliente deverá finalizar a implantação da máquina virtual na área do cliente depois de personalizar suas opções ao seu gosto. Lembre-se de que a lista de locais é preenchida dinamicamente, dependendo da disponibilidade do plano selecionado nos locais de nuvem do Vultr - consulte a Etapa 3 acima. Atualmente, não há função para configurar um script de inicialização global.

Como atualizo os aplicativos nas opções de configuração?

Se você deseja listar todos os aplicativos disponíveis, pode usar este comando da API e adicionar os aplicativos que deseja nas opções configuráveis. A sincronização automática não existe no módulo.