Como usar Ansible ou scripts de provisionamento para configurar um VPS novo automaticamente

Como usar Ansible ou scripts de provisionamento para configurar um VPS novo automaticamente

Olá, querido(a) cliente da GeHost! Seja bem-vindo(a) ao seu novo mundo de automação e produtividade. Aqui, você, mesmo sendo iniciante, pode aprender a configurar um servidor de forma inteligente, rápida e sem precisar digitar comandos um por um. Vamos juntos nessa jornada de transformar um VPS novo em um ambiente pronto para o seu projeto — com apenas alguns cliques e um pouco de magia (bem técnica, é claro).

Antes de começar, um lembrete importante: os planos da GeHost são hospedagem com cPanel, não VPS dedicado com acesso root. Isso significa que você não tem controle total sobre o sistema operacional como em um servidor físico ou VPS puro. Porém, se você está usando um serviço de hospedagem que inclui acesso SSH (como o plano Plus ou superior), é possível usar ferramentas como Ansible para automatizar tarefas dentro do seu ambiente — como instalar softwares, configurar regras de firewall ou gerenciar arquivos.

Seu objetivo é automatizar a configuração de um servidor novo? Ótimo! Vamos seguir passo a passo, com calma, como se eu fosse seu Sensei de DevOps, com paciência e um sorriso.

Passo 1: Prepare seu ambiente local

Para usar Ansible, você precisa ter o Ansible instalado no seu computador (seu “lado de casa”). Ele funciona como um “mestre” que envia comandos para o servidor remoto (seu VPS).

• Instale o Python (versão 3.6 ou superior).
• Instale o Ansible via pip: pip install ansible.
• Verifique a instalação com: ansible --version.

💡 Dica: Se você não tem experiência com linha de comando, não se preocupe. O Ansible é feito para ser simples. Use o terminal do seu computador (Terminal no Mac, PowerShell ou CMD no Windows).

Passo 2: Acesse seu servidor via SSH

Antes de automatizar, você precisa se conectar ao seu servidor. A GeHost fornece acesso SSH para planos que incluem essa funcionalidade.

Para se conectar, use o terminal e digite:

ssh usuario@seu-dominio.com.br

Substitua usuario pelo nome de usuário fornecido no painel da GeHost (geralmente é o nome do domínio ou um nome customizado) e seu-dominio.com.br pelo domínio do seu site.

Se a conexão funcionar, você está dentro do servidor. Pronto para começar a automatizar.

Passo 3: Crie um arquivo de inventário (hosts)

O Ansible precisa saber onde está o servidor que você quer configurar. Crie um arquivo chamado hosts no seu computador com o seguinte conteúdo:

[vps]
seu-dominio.com.br ansible_user=usuario ansible_ssh_private_key_file=~/.ssh/id_rsa

Substitua:

• seu-dominio.com.br pelo domínio do seu site.
• usuario pelo nome de usuário SSH.
• ~/.ssh/id_rsa pelo caminho da sua chave SSH (se você usou SSH key).

Se não tiver uma chave SSH, o Ansible pode usar senha — mas é mais seguro usar chaves.

Passo 4: Crie um script de provisionamento (playbook)

Crie um arquivo chamado provision.yml com o seguinte conteúdo:

---
- name: Configurar servidor novo
  hosts: vps
  become: yes
  tasks:
    - name: Atualizar pacotes
      apt:
        update_cache: yes
        upgrade: yes
      when: ansible_distribution == "Ubuntu"

    - name: Instalar Nginx
      apt:
        name: nginx
        state: present

    - name: Iniciar e habilitar Nginx
      systemd:
        name: nginx
        state: started
        enabled: yes

Esse script faz três coisas:

1. Atualiza o sistema (só se for Ubuntu).
2. Instala o Nginx (servidor web).
3. Inicia o Nginx e o deixa ativo ao reiniciar o servidor.

Esse é um exemplo simples. Você pode expandir esse playbook com instalação de PHP, MySQL, configuração de firewall, criação de usuários, etc.

Passo 5: Execute o Ansible

No terminal, no mesmo diretório onde estão os arquivos hosts e provision.yml, execute:

ansible-playbook -i hosts provision.yml

Se tudo estiver certo, o Ansible se conectará ao seu servidor, verificará as tarefas e as executará automaticamente.

💡 Dica: Se aparecer erro de permissão ou conexão, verifique no painel da GeHost se o acesso SSH está habilitado e se a chave SSH foi corretamente configurada.

Passo 6: Automatize com scripts personalizados

Depois que você entender o básico, pode criar scripts mais complexos. Por exemplo:

• Instalar o PHP e o Composer.
• Criar um banco de dados MySQL.
• Configurar um site com arquivo index.html.
• Proteger o servidor com um firewall simples.

Com o tempo, você terá um “kit de boas-vindas” para qualquer novo servidor — basta rodar um comando.

Importante: Sempre confira no painel da GeHost

Se precisar de ajuda com:

• Configuração de SSH
• Gerenciamento de domínios
• Contas de e-mail
• Backup e segurança

Use o painel do cliente: painel.gehost.com.br. Lá você encontra todos os recursos da sua hospedagem.

Conclusão: Você está no caminho certo!

Automatizar é como ensinar um robô a fazer tarefas repetitivas — assim, você ganha tempo, evita erros e pode focar no que realmente importa: criar, inovar e crescer.

Se tiver dúvidas, lembre-se: o suporte da GeHost está disponível por 30 dias após a entrega. É só entrar em contato pelo painel ou pelo e-mail de atendimento.

Com carinho, seu Sensei da GeHost 🙏