Ansible na VPS: automatize a configuração do servidor
Automação sem agente por SSH: Ansible no seu computador, inventário dos servidores, playbook de pacotes, usuário e serviço, simulação antes de aplicar e segredos cifrados.
Por Redação Eleven Host · @robson.direitodigital · 22 de novembro de 2026 · 9 min de leitura

Capa da Redação Eleven Host para o guia: Ansible na VPS: automatize a configuração do servidor Arte: Eleven Host
Ansible na VPS é descrever num arquivo como cada servidor deve ficar (pacotes, usuários, serviços) e aplicar essa receita por SSH, a partir do seu computador, em uma ou várias máquinas de uma vez.
Atualizado em 22/11/2026. Nada aqui foi testado por nós: confira cada comando antes de usar e teste primeiro numa máquina só.
Em 22/11/2026, a versão mais recente do ansible-core era a 2.22.0, de 02/11/2026, e o pacote ansible no PyPI estava na 15.0.0, de 17/11/2026, ambos sob licença GPLv3. O repositório oficial estava ativo e sem alertas de segurança publicados. Pela tabela de suporte, o ansible-core 2.22 pede Python 3.13 a 3.15 no computador de controle.
O que é o Ansible
O Ansible é uma ferramenta de automação de TI de código aberto, mantida no repositório ansible/ansible do GitHub. A documentação oficial destaca três características:
- sem agente: nenhum software adicional precisa ser instalado nos servidores gerenciados;
- usa SSH: entra nas máquinas com as credenciais que o sistema já tem;
- idempotente: se o servidor já está no estado descrito, rodar o playbook de novo não muda nada.
Quatro termos aparecem o tempo todo. O nó de controle é a máquina onde o Ansible está instalado, normalmente o seu computador. Os nós gerenciados são os servidores que ele controla. O inventário é a lista desses servidores. O playbook é um arquivo YAML com uma lista de tarefas, executadas de cima para baixo; cada tarefa chama um módulo, como o que instala pacotes ou o que cria usuários.
Para quem o Ansible faz sentido
O Ansible faz sentido para uma pequena empresa ou um desenvolvedor com 1 a 5 servidores que repete sempre os mesmos passos: atualizar o sistema, criar o usuário da equipe, instalar o servidor web, ajustar um arquivo de configuração. Com o playbook, esses passos ficam escritos, versionados junto do projeto e reaplicáveis numa máquina nova.
Uma VPS é um servidor virtual privado; o que é e como escolher uma está em O que é servidor VPS: guia simples para iniciantes. Mesmo com um servidor só, o playbook serve de registro do que foi feito e de roteiro para reconstruir a máquina.
Uma máquina para receber o playbook
O Ansible precisa de pelo menos um servidor do outro lado da conexão.
Servidores virtuais privados, as VPS, também estão no catálogo da Eleven Host. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Conhecer VPS
Requisitos dos dois lados
Pela página de instalação da documentação, o nó de controle pode ser quase qualquer máquina do tipo UNIX com Python: Red Hat, Debian, Ubuntu, macOS e BSDs. No Windows, só dentro de uma distribuição do WSL; o Windows sem WSL não serve como nó de controle.
No servidor gerenciado, o Ansible não precisa estar instalado. A documentação pede:
- Python, para rodar o código que o Ansible envia; pela tabela de suporte, o ansible-core 2.22 aceita Python 3.9 a 3.15 nos nós gerenciados;
- uma conta que entre por SSH num shell POSIX interativo.
Confira a versão do Python nos dois lados antes de começar:
python3 --version
Os exemplos de pacotes abaixo usam o módulo apt, que vale para servidores Debian e Ubuntu. Pela documentação do módulo, ele precisa do pacote python3-apt no servidor. Confira se ele está instalado antes do passo 5, porque a primeira tarefa do playbook usa o módulo apt.
Passo 1: instalar o Ansible no nó de controle
A documentação indica o pipx. Para o pacote completo, que traz o ansible-core e um conjunto de coleções da comunidade:
pipx install --include-deps ansible
Quem quer só o núcleo pode usar pipx install ansible-core. Sem pipx, a alternativa da documentação é o pip do usuário:
python3 -m pip install --user ansible
Para conferir, ansible --version mostra a versão do ansible-core e ansible-community --version a do pacote ansible. Para atualizar depois, pipx upgrade --include-injected ansible.
Passo 2: entrar no servidor com chave SSH
Pela documentação de conexão, o Ansible assume chaves SSH por padrão e incentiva o uso delas; senha só com a opção --ask-pass. Como a conexão SSH padrão do Ansible não aceita digitar a frase da chave, a documentação recomenda o ssh-agent:
ssh-agent bash
ssh-add ~/.ssh/id_rsa
Troque o caminho pelo da sua chave; este passo supõe que a chave pública já esteja autorizada no servidor. Teste antes um ssh comum até o servidor: a primeira conexão grava a impressão digital da máquina. A verificação dessa impressão vem ligada e protege contra servidor falso; recomendamos não desligá-la.
Sobre acesso privado e bloqueio de ataques ao servidor, há os artigos Tailscale na VPS: acesso privado ao servidor e painéis e CrowdSec na VPS: como bloquear ataques ao servidor.
Passo 3: montar o inventário
Crie uma pasta para o projeto e, dentro dela, o arquivo inventory.ini. Um exemplo nosso, não testado, com dois servidores num grupo, trocando os endereços de documentação pelos seus:
[vps]
web1 ansible_host=192.0.2.50
web2 ansible_host=192.0.2.51
[vps:vars]
ansible_user=seu-usuario
O mesmo inventário pode ser escrito em YAML, com o grupo, a chave hosts e um ansible_host por máquina. Pela documentação, nomes de grupo diferenciam maiúsculas e não devem ter espaço, hífen nem começar por número. Para conferir o que o Ansible leu:
ansible-inventory -i inventory.ini --list
Mesmo sem grupos definidos, o Ansible cria o grupo all, com todas as máquinas, e o ungrouped.
Passo 4: o primeiro teste
O módulo ping testa se o Ansible consegue se comunicar com cada servidor:
ansible all -m ping -i inventory.ini
Pela documentação, cada máquina deve responder SUCCESS com "ping": "pong". Se der erro de conexão, volte ao passo 2; se a queixa for de Python, volte aos requisitos.
Passo 5: um playbook simples
O exemplo abaixo, montado por nós e não testado, atualiza os pacotes, cria um usuário para a equipe (no grupo sudo, que existe em Debian e Ubuntu), instala o Nginx e deixa o serviço ligado. Salve como servidor.yml. Ao copiar, mantenha 2 espaços por nível: o recuo faz parte do YAML e pode se perder na página.
- name: Configuracao basica da VPS
hosts: vps
become: true
tasks:
- name: Atualizar o cache e os pacotes
ansible.builtin.apt:
update_cache: true
upgrade: safe
- name: Criar o usuario deploy
ansible.builtin.user:
name: deploy
shell: /bin/bash
groups: sudo
append: true
state: present
- name: Instalar o Nginx
ansible.builtin.apt:
name: nginx
state: present
- name: Ligar o Nginx agora e no boot
ansible.builtin.service:
name: nginx
state: started
enabled: true
O que cada parte faz, pela documentação dos módulos:
become: trueativa a elevação de privilégio, por padrão com sudo; se o sudo pedir senha, rode com-K;- no módulo apt,
update_cacheequivale ao apt-get update eupgradeaceita dist, full, safe ou no; - no módulo user,
append: truemantém os grupos que o usuário já tem; desde o Ansible 2.21 ele é obrigatório quando hágroups; - no módulo service,
startedsó inicia se o serviço estiver parado eenabledliga o início automático.
O usuário foi criado sem senha de propósito. O campo password do módulo user recebe um hash, gravado direto no sistema sem validação, e um hash errado pode travar o login. Para dar acesso por chave, a coleção ansible.posix tem o módulo ansible.posix.authorized_key; ela não vem no ansible-core, mas pode já estar no pacote ansible (confira com ansible-galaxy collection list).
Passo 6: simular com --check e --diff
Antes de aplicar, rode a simulação. A documentação recomenda limitar a simulação a uma máquina:
ansible-playbook -i inventory.ini servidor.yml --check --diff --limit web1
O --check não muda nada e o --diff mostra o antes e o depois. É uma simulação: módulos sem suporte ao modo de teste não informam nem fazem nada. O diff também pode exibir conteúdo sensível; diff: false na tarefa esconde essa parte.
Antes de aplicar num servidor em uso, recomendamos uma cópia de segurança, como em Duplicati na VPS: backup do servidor com painel web. Com a simulação conferida, aplique:
ansible-playbook -i inventory.ini servidor.yml
Rode o mesmo comando outra vez. Pela idempotência, as tarefas já cumpridas não devem mudar nada; o que aparecer como alterado de novo merece revisão.
Passo 7: guardar segredos com ansible-vault
Senha de banco, token de API e afins não devem ficar em texto no playbook. O ansible-vault cifra arquivos inteiros ou variáveis soltas; o arquivo cifrado começa com $ANSIBLE_VAULT;1.1;AES256. Comandos da documentação:
ansible-vault create segredos.yml
ansible-vault edit segredos.yml
ansible-vault view segredos.yml
Para rodar um playbook que carrega o arquivo cifrado (o do passo 5 não o usa), o Ansible pede a senha do vault:
ansible-playbook -i inventory.ini servidor.yml --ask-vault-pass
Uma senha forte para o vault pode ser gerada com openssl rand -hex 32. Se usar --vault-password-file, lembre que esse arquivo guarda a senha em texto puro: recomendamos mantê-lo fora do repositório, com permissão só do dono.
Checklist do Ansible na VPS
- Python na faixa da tabela de suporte nos dois lados;
- Ansible instalado no nó de controle com pipx ou pip;
- acesso por chave SSH, com a verificação da impressão digital ligada;
- inventário conferido com ansible-inventory --list e ping com SUCCESS;
- playbook simulado com --check --diff numa máquina antes de aplicar em todas;
- segredos cifrados com ansible-vault, senha do vault fora do repositório.
Um nome para cada máquina do inventário
Recomendamos dar a cada servidor um apelido fácil de reconhecer, como web1 ou banco1.
Apelidos como web1.suaempresa.com.br saem de um domínio, e o registro pode ser feito na Eleven Host. Pesquisar domínio
Perguntas frequentes
Preciso instalar o Ansible na VPS?
Não. O Ansible fica no nó de controle, normalmente o seu computador. Na VPS, a documentação pede Python e uma conta com acesso por SSH.
Dá para usar o Ansible no Windows?
Como nó de controle, só dentro do WSL. O Windows sem WSL não é aceito pela documentação.
Qual a diferença entre o pacote ansible e o ansible-core?
O ansible-core traz o motor e os comandos, como ansible e ansible-playbook. O pacote ansible inclui o ansible-core e um conjunto de coleções da comunidade com mais módulos.
O --check mostra exatamente o que vai acontecer?
Não sempre. É uma simulação, e módulos sem suporte ao modo de teste não informam nada. Por isso, recomendamos testar também numa máquina de teste.