Documentação

VMware vSphere

O Provibr liga-se a um vCenter Server e gere as máquinas virtuais do seu inventário: encomendar, clonar, arrancar, parar, suspender, remover e ler o consumo, através do mesmo agente, dos mesmos planos e do mesmo registo de auditoria de qualquer outra integração.

A que se liga

A integração fala com o vCenter Server pela sua API de Web Services. Tudo o que o painel faz (colocação, clonagem, configuração do convidado) passa pelo vCenter, pelo que um cluster com DRS continua a decidir por si em que anfitrião uma máquina acaba.

Um anfitrião ESXi autónomo não é suportado. Responde na mesma API e o início de sessão até funciona, mas não tem clusters, nem DRS, nem um conjunto de recursos para onde clonar. O agente verifica com o que está a falar e recusa um anfitrião autónomo, em vez de falhar na sua primeira encomenda.

Em que difere do Proxmox

O modelo é o mesmo: um agente, uma integração, planos e modelos. Quatro coisas comportam-se de outra forma, e são precisamente as que se notam.

Uma máquina é identificada pelo seu UUID de instância e não por um número que o Provibr distribua. Tudo o que escolhe nas definições (centro de dados, conjunto de recursos, rede) é uma referência a um objecto do vSphere e não um nome, porque aí os nomes só são únicos dentro da respectiva pasta. E o «nó» que vê no painel é o centro de dados, não o anfitrião ESXi: esse muda a cada vMotion, e uma máquina que parecesse mudar de sítio de hora a hora seria impossível de acompanhar.

O que preenche

Quatro campos. Crie um utilizador próprio em vez de reutilizar um administrador: o vCenter não tem um token de API revogável, por isso a função atribuída à conta é o limite.

O endereço https do vCenter, tal como o abre no navegador.
O nome de utilizador com o respectivo domínio, por exemplo provibr@vsphere.local.
A palavra-passe. Viaja uma única vez até ao seu agente e nunca é guardada pelo Provibr.
A impressão digital SHA-256 do certificado que o vCenter apresenta.

Dê à conta uma função sobre o centro de dados que deve gerir. O início de sessão funciona com qualquer conta que o vCenter conheça, por isso uma conta sem função liga-se sem erro e depois não vê absolutamente nada: nenhuma mensagem, apenas um inventário vazio. É por isso que o teste de ligação indica quantos centros de dados consegue ver: zero significa que as credenciais estão certas e falta a função.

A impressão digital TLS

Leia-a a partir de qualquer máquina que alcance o vCenter:

shell

openssl s_client -connect <host>:443 </dev/null 2>/dev/null | \
  openssl x509 -noout -fingerprint -sha256

Os comandos e a saída do terminal estão em inglês em todo o lado, no painel e nestas páginas. Um só texto, uma só verdade: o que aqui se lê é literalmente o que o seu host vai devolver.

Este campo é obrigatório. O vCenter apresenta sempre um certificado da sua própria CA interna, pelo que não há uma cadeia publicamente fiável a que recorrer nem um caminho sem cifra. Com uma impressão digital, o agente confia nesse certificado em concreto em vez de desligar a verificação.

Use a impressão digital do certificado da máquina, não a da CA interna. O vSphere Client mostra ambas e são parecidas. Fixar a da CA dá uma integração que funciona de imediato e pára meses depois, na rotação seguinte do certificado.

Definições

Onde ficam as máquinas novas. Escolhe-as a partir do que o vCenter comunica; não há nada para escrever.

O centro de dados onde são criadas as máquinas novas.
O conjunto de recursos. Num cluster com DRS é o conjunto de raiz e o anfitrião é escolhido pelo vSphere.
O grupo de portas a que se liga a placa de rede.
Opcionalmente um anfitrião fixo: deixe vazio onde o DRS está activo.

Não existe definição de datastore. Um clone herda o armazenamento do seu modelo, que já está num sítio permitido; escolher outro deixaria apontar para um datastore que o anfitrião de destino talvez nem veja.

Modelos

No vSphere, um modelo é uma máquina virtual comum marcada como tal, no mesmo inventário. Ligue-o a um sistema operativo do seu catálogo e as encomendas desse sistema passam a ser clonadas a partir dele.

A lista mostra o centro de dados ao lado do nome, porque dois modelos podem ter o mesmo nome em pastas diferentes. Dê ao modelo o VMware Tools e o cloud-init; o Provibr entrega a configuração do convidado pelo canal guestinfo, que funciona em qualquer imagem de nuvem sem requisitos adicionais.

O que pode fazer com uma máquina

Criá-la a partir de um modelo, arrancar, parar, reiniciar a frio, desligar e reiniciar de forma ordenada pelo VMware Tools, suspender e retomar, ler o estado e remover.

Ainda não: adicionar ou remover discos e placas de rede, e reinstalar. Reinstalar no vSphere é clonar de novo, e não há nenhum comando que reconstrua a mesma máquina no lugar. Uma firewall por máquina não existe de todo no vSphere: isso é o NSX, um produto à parte.

Rede

Uma máquina nova recebe uma placa no grupo de portas indicado nas definições e o seu endereço a partir do seu IPAM, se o plano tiver um conjunto associado.

Os grupos de portas distribuídos são suportados e são o caso normal. Ligam-se de forma diferente das redes clássicas (pelo UUID do respectivo comutador mais a sua própria chave) e o agente deduz isso do próprio objecto, por isso não há nada a configurar.

Importar o que já existe

As máquinas que existem no vCenter à margem do Provibr podem ser importadas a partir da página da integração: assinale as que quiser e aparecem como servidores, com o centro de dados, o estado e as características.

AnteriorProxmox VE SeguinteoVirt