Ir para o conteúdo

Documentação

CloudPanel

O CloudPanel corre NGINX, PHP e uma base de dados num único servidor na nuvem. A Provibr gere-o a partir de um agente dentro da sua própria rede, por SSH. O CloudPanel não tem API HTTP, por isso o agente executa a sua própria linha de comandos clpctl como um administrador o faria. Nada é instalado no painel e nenhuma porta tem de ser aberta para a internet.

Credenciais

Como o CloudPanel é conduzido por SSH, a credencial é uma chave SSH privada em vez de um token de API. O agente usa-a para executar o clpctl como root no host.

  • O host e a porta SSH do servidor CloudPanel, porta 22 por predefinição
  • Uma chave SSH privada com a qual o agente inicia sessão, cuja metade pública está no authorized_keys desse utilizador
  • A impressão digital da chave de host SSH do servidor, obrigatória porque por SSH não há uma cadeia de certificados de recurso
Esta chave SSH é uma shell de root no seu servidor web. Restrinja-a a uma chave que exista apenas para a Provibr e revogue-a aqui assim que deixar de usar a integração. Revogar apaga a cópia no agente.

Fixar a chave de host

Leia a impressão digital no host e cole-a na integração. O agente recusa qualquer host cuja chave não corresponda, por isso um servidor reinstalado ou uma ligação intercetada é apanhado antes de correr um único comando.

shell
ssh-keyscan -t ed25519 <host> 2>/dev/null | ssh-keygen -lf -
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.

O exemplo acima usa a porta 22. Se o seu host escutar noutra porta SSH, adicione-a ao comando ssh-keyscan.

Modelos e versões de PHP

Um plano CloudPanel é um modelo de vhost mais uma versão de PHP. Ao encomendar um site escolhem-se ambos, e o modelo define a configuração NGINX com que o site é criado.

O modelo de vhost fica fixo assim que o site existe, por isso não há mudança de pacote: mover um site para outro modelo ou versão de PHP significa recriá-lo. A Provibr di-lo, em vez de fingir uma mudança que não aconteceu.

Contado como um servidor web

Cada site é um servidor web na sua capacidade, com o mesmo preço de qualquer outro painel de controlo desta página. Um site suspenso não conta para o seu limite.

Suspender um site

Suspender insere uma regra NGINX que devolve 403, por isso o site fica inacessível enquanto tudo o resto no servidor continua a funcionar. Retomar remove a regra e o site volta byte a byte.

O que não existe

Não há consola nem gráfico de utilização. O CloudPanel não mede nenhum dos dois, e um gráfico que fica a zero parece uma medição. DNS, correio e bases de dados ficam no CloudPanel.

A Provibr gere o site e o seu ciclo de vida: criar, suspender, retomar e remover. Tudo o resto sobre o servidor continua a ser a sua escolha e a do seu cliente.