Referência rápida

Folha de dicas do guia de início rápido do Ansible para iniciantes

Guia passo a passo para iniciantes no Ansible: instalação, estrutura do projeto, configuração de inventário, criação de playbooks e execução de automação.

· Publicado

Um guia prático do zero para instalar o Ansible, organizar arquivos de inventário, escrever seu primeiro playbook YAML e orquestrar tarefas de servidor.

🔗 Related: Folha de dicas básica do Ansible · Folha de dicas de papéis do Ansible · Exemplos de Ansible Playbooks

Instalação

# macOS (Homebrew)
brew install ansible

# Ubuntu / Debian
sudo apt update && sudo apt install -y ansible

# Python Pip (Universal)
pip install ansible

Consulte: Documentação oficial de instalação do Ansible: Ansible Installation Docs


Configuração do projeto

mkdir -p ~/ansible-setup
cd ~/ansible-setup

Crie um diretório de trabalho dedicado para seu inventário, playbooks e definições de variáveis.


Arquivos de configuração

Arquivo de inventário (Inventory)

hosts

[webservers]
192.168.0.10
192.168.0.11

[databases]
192.168.0.20

[local]
localhost ansible_connection=local

Os inventários definem nós de destino agrupados logicamente. Você pode apontar para localhost usando ansible_connection=local para testar a automação localmente sem SSH.

Consulte: Como criar seu inventário no Ansible: Ansible How to build your inventory


Definição do Playbook

playbook.yml

---
- name: Basic Server Provisioning
  hosts: webservers
  become: true
  tasks:
    - name: Update apt package cache
      apt:
        update_cache: yes
        cache_valid_time: 3600

    - name: Ensure Nginx is installed
      apt:
        name: nginx
        state: present

    - name: Start Nginx and enable on boot
      service:
        name: nginx
        state: started
        enabled: yes

    - name: Create hello world banner
      shell: echo "Managed by Ansible" > /tmp/motd.txt

Execução

Validação e execução

Verifique a conectividade usando ping ad-hoc:

ansible -i hosts all -m ping

Execute o playbook completo no inventário especificado:

ansible-playbook -i hosts playbook.yml

Execução de teste (Modo Check)

Pré-visualize alterações potenciais sem aplicá-las aos nós remotos:

ansible-playbook -i hosts playbook.yml --check --diff

Referências

Temas relacionados