Base de Conhecimento

Ansible na VPS: automatize a configuração do servidor

  • ansible, vps, automação, ssh, linux
  • Usuários acharam útil: 0

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

Arte da Eleven Host: janela de terminal com o título: Ansible na VPS: automatize a configuração do servidor

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: true ativa a elevação de privilégio, por padrão com sudo; se o sudo pedir senha, rode com -K;
  • no módulo apt, update_cache equivale ao apt-get update e upgrade aceita dist, full, safe ou no;
  • no módulo user, append: true mantém os grupos que o usuário já tem; desde o Ansible 2.21 ele é obrigatório quando há groups;
  • no módulo service, started só inicia se o serviço estiver parado e enabled liga 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.

Esta resposta lhe foi útil?

Artigos Relacionados