Documentação
Primeiros passos
Seis passos, de uma conta vazia a uma máquina virtual em execução. É preciso um host Linux dentro da rede onde vive o seu cluster Proxmox, e root nesse host.
Antes de começar
- Um nó ou cluster Proxmox VE, acessível por HTTPS a partir do host que vai utilizar
- Um host Linux x86 de 64 bits com systemd, nessa mesma rede, onde tenha root
- Um modelo no Proxmox a partir do qual clonar máquinas
Criar uma conta
Ao registar-se, entra no painel com um período experimental já em curso. Não são pedidos dados de pagamento e é possível ligar um host de imediato.
Criar um agente
No painel, adicione um agente e dê-lhe um nome que indique onde está, por exemplo o local ou o rack. O painel mostra um código de ativação uma única vez e nunca mais, por isso guarde-o em lugar seguro antes de sair da página.
Instalar o agente no seu host
O painel constrói um comando de uma só linha que contém uma ligação de instalação de curta duração. Execute-o como root no host Linux. Verifica a arquitetura, descarrega o binário, confirma a soma de verificação junto da plataforma, cria a conta de serviço e os diretórios, obtém o ficheiro de licença, faz a inscrição e inicia o serviço com o systemd.
shellcurl -fsSL https://app.provibr.com/api/install/<token> | shO comando pede o código de ativação no terminal em vez de o receber na linha de comandos, para que o código nunca vá parar ao histórico da shell nem a uma lista de processos.Confirme que arrancou:
shellsystemctl status provibr-agent journalctl -u provibr-agent -fAo fim de alguns segundos, o agente aparece como online no painel. Se não aparecer, o registo do serviço no host diz porquê.
Obter a impressão digital TLS do seu nó Proxmox
O Provibr fixa o certificado que o seu nó Proxmox apresenta de facto. É o certificado de servidor do próprio nó, não o certificado da autoridade que o emitiu, nem um certificado de um proxy inverso colocado à frente. Execute isto a partir do host do agente, para recolher a impressão digital exatamente daquilo que o agente vai ver:
shellopenssl s_client -connect pve.example.com:8006 </dev/null 2>/dev/null | \ openssl x509 -noout -fingerprint -sha256Copie o valor hexadecimal separado por dois pontos. O prefixo que o openssl imprime à frente pode ficar; o painel aceita das duas formas. Se substituiu o certificado do nó, volte a recolher a impressão digital, porque uma renovação altera-a.O mesmo valor também pode ser lido na interface web do Proxmox, em System e depois Certificates do nó, na entrada do certificado web do próprio nó.
Ligar a integração do Proxmox
No painel, adicione uma integração, escolha Proxmox VE e escolha o agente que acabou de instalar. Preencha o host, o identificador do token de API, o segredo do token e a impressão digital do passo anterior. As credenciais são enviadas uma única vez para esse agente e seladas no seu cofre; a plataforma guarda apenas os nomes dos campos.
Na prática, a impressão digital não é opcional. Sem ela, o agente não consegue decidir se o certificado que lhe é apresentado é o seu, e a ligação é recusada em vez de ser aceite às cegas.Depois de a integração indicar que está ativa, abra as suas definições e defina o nome do nó, o armazenamento e o intervalo de IDs de máquina que o Provibr pode usar. Uma integração sem intervalo não consegue criar nada, e isso é deliberado: é o intervalo que mantém o painel afastado das máquinas que não entregou.
Criar a sua primeira máquina
Adicione um plano com os núcleos, a memória e o disco que pretende, e aponte-o para um pool de endereços. Depois crie um servidor: escolha a integração, o plano e o sistema operativo a clonar. O painel acompanha a tarefa de clonagem enquanto esta é executada e a máquina aparece com um endereço do seu pool já na configuração cloud-init.
Se algo falhar, o registo de atividade do servidor mostra o motivo comunicado pelo agente, no seu próprio idioma, com a mensagem original do Proxmox citada por baixo.