Para que o coletor de métricas da plataforma Kmind funcione corretamente na sua VM (máquina virtual), é necessário instalar e configurar o Puppet Agent, que será responsável por instalar automaticamente os componentes necessários.

Siga o passo a passo abaixo com atenção:

✅ 1. Instalar o Puppet #

Antes de mais nada, instale o Puppet Agent na sua máquina. A forma de instalação pode variar conforme o sistema operacional da sua VM (Linux, Windows, etc.).

Para fazer a instalação manualmente caso esteja usando Linux com distribuição Debian ou Ubuntu, siga as instruções abaixo:

1 – Baixe o pacote .deb

wget https://apt.puppet.com/puppet7-release-focal.deb

2 – Descompacte o pacote

sudo dpkg -i puppet7-release-focal.deb

3 – Atualize a lista de repositórios

sudo apt update

4 – Faça a instalação

sudo apt install puppet-agent

Ou acesse a documentação oficial do Puppet para instruções completas:
👉 Installing and Configuring Puppet Agents

Caso tenha dúvidas durante a instalação, entre em contato com nosso suporte.

⚙️ 2. Configurar o Puppet #

Após instalar o Puppet, será necessário apontá-lo para o nosso servidor.

Passo 1: Editar o arquivo de configuração

Abra o terminal da sua VM e execute o seguinte comando para editar o arquivo de configuração:

sudo vi /etc/puppetlabs/puppet/puppet.confou
sudo vi /etc/puppet/puppet.conf

Adicione a seguinte linha dentro da seção [main] do arquivo:

[main]
server = vmi2496138.contaboserver.net

Salve e feche o arquivo (pressione ESC, digite :wq e pressione Enter no vi).

Passo 2: Reiniciar o serviço Puppet

Agora, reinicie o serviço para aplicar as alterações:

sudo systemctl start puppet

Passo 3: Executar o agente Puppet

Com o serviço iniciado, execute o agente Puppet para que ele instale automaticamente os componentes necessários:

puppet agent -t

Caso o comando acima não funcione (por exemplo, se o puppet não estiver disponível no PATH), use o caminho completo:

/opt/puppetlabs/puppet/bin/ruby /opt/puppetlabs/puppet/bin/puppet agent -t

⚠️ Observações importantes #

• Erro de certificado:
  Se ao rodar o comando puppet agent -t aparecer uma mensagem de erro relacionada a certificados, isso pode indicar que o nome da sua máquina (hostname) ainda não foi autorizado no nosso servidor Puppet. Nesse caso:
  • Acesse a nossa página de suporte
  • Abra um chamado solicitando a validação do certificado
  • Nosso SLA para a primeira resposta em dias úteis é de até 30 minutos

Caso precise de ajuda durante qualquer etapa, nosso time está à disposição para auxiliar!