Guia 07 / 3
Glossário de Ansible
Decifrar o funcionamento do Ansible e ler um playbook sem confundir anfitrião, tarefa, módulo e papel (role).
Distinguir o nó de controlo dos anfitriões geridos, explicar a idempotência e ler a organização de um playbook.
01 · Compreender a automatização
O Ansible automatiza operações técnicas descrevendo o estado esperado: privilegia tarefas reproduzíveis em vez de manipulações manuais.
Ansible
Ferramenta de automatização e de configuração de sistemas, aplicações e infraestruturas. Executa tarefas em alvos descritos num inventário.
Exemplo
Exemple métier : préparer 12 serveurs web de la même manière.
O Ansible não é um orquestrador de contentores: complementa o Docker e o Kubernetes.
Nó de controlo (control node)
Máquina a partir da qual se lançam os comandos e os playbooks. Possui o Ansible e os ficheiros do projeto.
Exemplo
Ordinateur du formateur ou VM Linux de gestion.
Os servidores Linux geridos não necessitam geralmente do programa Ansible instalado.
Nó gerido (managed node)
Servidor ou equipamento no qual o Ansible intervém, muitas vezes por SSH. É descrito no inventário.
Exemplo
vm-web-01 est configurée depuis le poste de contrôle.
Para os módulos Python, deve estar disponível uma versão compatível do Python no alvo.
Sem agente (agentless)
Modelo em que nenhum serviço Ansible permanente é necessário nos anfitriões Linux alvo; as tarefas utilizam nomeadamente o SSH.
Exemplo
Une connexion SSH suffit dans un cas Linux habituel.
Uma rede acessível, credenciais válidas e direitos suficientes continuam indispensáveis.
Infraestrutura como código (IaC)
Abordagem que consiste em exprimir a infraestrutura sob a forma de ficheiros versionados e reproduzíveis.
Exemplo
Le dépôt Git contient inventory.ini et playbooks/web.yml.
Rever e validar as alterações como código aplicacional.
Estado desejado
Resultado a obter no alvo: pacote instalado, ficheiro presente, serviço iniciado.
Exemplo
state: present demande qu’un paquet soit installé.
Declarar o resultado é muitas vezes mais fiável do que executar uma sequência de comandos shell.
Idempotência
Propriedade de uma operação repetida que já não modifica o sistema quando o estado pedido já foi atingido.
Exemplo
Relancer « nginx installé » ne réinstalle pas nginx sans raison.
Um módulo é idempotente consoante a sua função e os parâmetros utilizados; «shell» não o é automaticamente.
Gestão de configuração
Manutenção de um conjunto de equipamentos numa configuração definida, apesar das intervenções e alterações.
Exemplo
S’assurer que chrony est installé sur tous les serveurs.
02 · Inventário e ligação
Antes de automatizar, é preciso saber que máquinas são visadas e como o Ansible lhes acede.
Inventário (inventory)
Ficheiro ou fonte dinâmica que referencia as máquinas e os seus grupos, eventualmente com parâmetros de ligação.
Exemplo
[web]
web1 ansible_host=192.0.2.11
web2 ansible_host=192.0.2.12
192.0.2.0/24 é um intervalo de exemplo; substituir pelos IP do TP.
Anfitrião (host)
Entrada do inventário que designa uma máquina e serve de identificador nos comandos Ansible.
Exemplo
web1 peut pointer vers 192.0.2.11 via ansible_host.
Grupo (group)
Conjunto nomeado de máquinas para lançar tarefas num perímetro funcional.
Exemplo
[web], [db], [prod] et [lab].
Padrão de anfitriões (host pattern)
Expressão que seleciona os alvos de um play ou de um comando.
Exemplo
hosts: web ; ansible web -i inventory.ini -m ping
all visa todos os alvos declarados; evitar all para as operações de risco.
ansible_host
Variável que fixa o nome DNS ou o IP utilizado para alcançar um anfitrião.
Exemplo
web1 ansible_host=192.0.2.11
ansible_user
Variável que precisa a conta utilizada para a ligação remota.
Exemplo
ansible_user=deployer
Os direitos desta conta condicionam as operações possíveis.
ansible_connection
Modo de transporte para o alvo (ssh, local, winrm consoante o ambiente).
Exemplo
ansible_connection=local pour un laboratoire local.
Chave SSH
Par de chaves que permite autenticar-se sem transmitir uma palavra-passe em cada ligação.
Exemplo
ssh -i ~/.ssh/id_ed25519 deployer@192.0.2.11
Não armazenar nenhuma chave privada no repositório Git.
group_vars / host_vars
Pastas convencionais de variáveis, respetivamente partilhadas por um grupo ou próprias de um anfitrião.
Exemplo
group_vars/web.yml : http_port: 8080
Um valor definido em vários locais segue regras de precedência.
Inventário dinâmico
Plugin ou fonte que produz automaticamente uma lista de máquinas a partir de uma cloud ou de um sistema de gestão.
Exemplo
Découvrir les VM d’un projet cloud sans modifier un fichier INI.
03 · Construir um playbook
Um playbook é um cenário YAML: associa alvos, tarefas e parâmetros. Lê-se de cima para baixo.
Playbook
Ficheiro YAML que contém uma lista de plays; constitui o procedimento de automatização.
Exemplo
ansible-playbook -i inventory.ini site.yml
Play
Bloco que associa uma seleção de anfitriões, uma política de execução e tarefas.
Exemplo
- name: Serveurs web
hosts: web
become: true
tasks: ...
Tarefa (task)
Etapa com nome que pede ao Ansible para executar um módulo com os seus argumentos no alvo.
Exemplo
- name: Installer nginx
ansible.builtin.apt:
name: nginx
state: present
Módulo
Unidade funcional do Ansible que realiza uma operação: pacote, ficheiro, serviço, utilizador ou pedido a uma API.
Exemplo
ansible.builtin.copy copie un fichier sur une cible.
Privilegiar um módulo dedicado em vez de um comando shell sempre que possível.
FQCN
Nome completo de um módulo com o seu espaço de nomes e a sua coleção, para evitar ambiguidades.
Exemplo
ansible.builtin.service plutôt que service.
Coleção
Pacote que distribui módulos, plugins e por vezes papéis para uma tecnologia particular.
Exemplo
community.docker ou kubernetes.core
Algumas coleções devem ser instaladas separadamente do ansible-core.
Papel (role)
Estrutura de pastas reutilizável que agrupa tarefas, handlers, variáveis, modelos e ficheiros.
Exemplo
roles/nginx/tasks/main.yml
Útil para partilhar um procedimento entre vários projetos.
Handler
Tarefa diferida, desencadeada por notify quando uma tarefa assinalou uma alteração.
Exemplo
Recharger nginx seulement si sa configuration a changé.
Os handlers executam-se normalmente no fim do play ou num flush.
notify
Palavra-chave que permite avisar um handler na sequência de uma alteração real.
Exemplo
notify: Recharger nginx
become
Elevação de privilégios no alvo, por exemplo através de sudo, para instalar um pacote ou escrever em /etc.
Exemplo
become: true
Não significa «ligar-se diretamente como root».
gather_facts
Etapa de recolha de informações do sistema, ativada por omissão em muitos plays.
Exemplo
gather_facts: true ; ansible_facts["os_family"]
04 · Variáveis, lógica e reutilização
As variáveis tornam um mesmo playbook reutilizável em vários grupos ou ambientes.
Variável
Nome que dá acesso a um dado de configuração sem duplicar o playbook.
Exemplo
http_port: 8080 ; {{ http_port }}
Jinja2
Motor de modelos utilizado para injetar variáveis, expressões e condições em ficheiros ou parâmetros.
Exemplo
server_name {{ site_hostname }};
Manter as expressões simples; rever os valores renderizados.
Modelo (template .j2)
Modelo de ficheiro transformado com as variáveis antes de ser instalado no anfitrião.
Exemplo
templates/site.conf.j2 → /etc/nginx/sites-available/site
Condição when
Condição que decide se uma tarefa deve executar-se em função de um valor ou de factos.
Exemplo
when: ansible_facts["os_family"] == "Debian"
Ciclo (loop)
Repete uma mesma tarefa sobre uma lista, sem copiar o YAML.
Exemplo
loop: ["curl", "git", "htop"]
register
Armazena o resultado de uma tarefa para o analisar nas tarefas seguintes.
Exemplo
register: resultat_nginx
changed / ok / failed / skipped
Estados devolvidos para cada tarefa: modificação efetuada, já conforme, falha ou tarefa ignorada.
Exemplo
changed=0 lors d’une seconde exécution idempotente.
Um resumo sem erros não prova, por si só, que o serviço responde corretamente.
Precedência das variáveis
Regras que determinam qual o valor que prevalece quando uma variável existe em vários locais.
Exemplo
Une variable -e peut écraser une variable group_vars.
Evitar definir o mesmo parâmetro em vários locais.
05 · Controlo, segurança e exploração
Uma automatização útil deve ser verificável, limitada a um perímetro e nunca expor os seus segredos.
Modo de verificação (check mode)
Simulação que estima as alterações sem as aplicar, quando os módulos o permitem.
Exemplo
ansible-playbook site.yml --check
Alguns módulos não preveem todas as alterações: a simulação não é uma prova absoluta.
Modo de diferenças (diff mode)
Apresenta as diferenças antes/depois para os módulos compatíveis, nomeadamente os modelos.
Exemplo
ansible-playbook site.yml --check --diff
A saída pode conter dados sensíveis; protegê-la.
Ansible Vault
Mecanismo de cifragem de variáveis ou ficheiros em repouso dentro de um projeto Ansible.
Exemplo
ansible-vault encrypt group_vars/prod/vault.yml
O Vault não protege automaticamente os segredos depois de decifrados nem nos registos.
no_log
Opção que oculta o resultado habitual de uma tarefa, útil quando esta manipula segredos.
Exemplo
no_log: true
Não substitui nem a cifragem nem uma gestão correta das permissões.
Privilégio mínimo
Princípio que consiste em conceder apenas os direitos necessários às contas e às automatizações.
Exemplo
sudo uniquement pour installer les paquets requis.
Serial / rolling update
Executa o play em lotes limitados de máquinas em vez de em simultâneo.
Exemplo
serial: 1 pour mettre à jour un serveur à la fois.
Prever a disponibilidade e a capacidade restante antes de retirar um nó de serviço.
ansible.cfg
Ficheiro de configuração do projeto Ansible: inventário por omissão, comportamentos, caminhos, etc.
Exemplo
[defaults]
inventory = inventory.ini
Verificar o ficheiro de configuração efetivamente carregado com ansible --version.
Ansible Galaxy
Comando e repositório para obter, instalar e organizar coleções ou papéis.
Exemplo
ansible-galaxy collection install community.docker