Cursos online

Cursos, TP e MOOC gratuitos, com o seu progresso.

Terraform e Ansible — O curso

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).

Resultado esperado :

Distinguir o nó de controlo dos anfitriões geridos, explicar a idempotência e ler a organização de um playbook.

Leitura
0%

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.

Exemple métier : préparer 12 serveurs web de la même manière.
A reter :

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.

Ordinateur du formateur ou VM Linux de gestion.
A reter :

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.

vm-web-01 est configurée depuis le poste de contrôle.
A reter :

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.

Une connexion SSH suffit dans un cas Linux habituel.
A reter :

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.

Le dépôt Git contient inventory.ini et playbooks/web.yml.
A reter :

Rever e validar as alterações como código aplicacional.

Estado desejado

Resultado a obter no alvo: pacote instalado, ficheiro presente, serviço iniciado.

state: present demande qu’un paquet soit installé.
A reter :

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.

Relancer « nginx installé » ne réinstalle pas nginx sans raison.
A reter :

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.

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.

[web]
web1 ansible_host=192.0.2.11
web2 ansible_host=192.0.2.12
A reter :

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.

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.

[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.

hosts: web ; ansible web -i inventory.ini -m ping
A reter :

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.

web1 ansible_host=192.0.2.11

ansible_user

Variável que precisa a conta utilizada para a ligação remota.

ansible_user=deployer
A reter :

Os direitos desta conta condicionam as operações possíveis.

ansible_connection

Modo de transporte para o alvo (ssh, local, winrm consoante o ambiente).

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.

ssh -i ~/.ssh/id_ed25519 deployer@192.0.2.11
A reter :

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.

group_vars/web.yml : http_port: 8080
A reter :

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.

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.

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.

- 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.

- 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.

ansible.builtin.copy copie un fichier sur une cible.
A reter :

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.

ansible.builtin.service plutôt que service.

Coleção

Pacote que distribui módulos, plugins e por vezes papéis para uma tecnologia particular.

community.docker ou kubernetes.core
A reter :

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.

roles/nginx/tasks/main.yml
A reter :

Útil para partilhar um procedimento entre vários projetos.

Handler

Tarefa diferida, desencadeada por notify quando uma tarefa assinalou uma alteração.

Recharger nginx seulement si sa configuration a changé.
A reter :

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.

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.

become: true
A reter :

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.

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.

http_port: 8080 ; {{ http_port }}

Jinja2

Motor de modelos utilizado para injetar variáveis, expressões e condições em ficheiros ou parâmetros.

server_name {{ site_hostname }};
A reter :

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.

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.

when: ansible_facts["os_family"] == "Debian"

Ciclo (loop)

Repete uma mesma tarefa sobre uma lista, sem copiar o YAML.

loop: ["curl", "git", "htop"]

register

Armazena o resultado de uma tarefa para o analisar nas tarefas seguintes.

register: resultat_nginx

changed / ok / failed / skipped

Estados devolvidos para cada tarefa: modificação efetuada, já conforme, falha ou tarefa ignorada.

changed=0 lors d’une seconde exécution idempotente.
A reter :

Um resumo sem erros não prova, por si só, que o serviço responde corretamente.

Tags

Etiquetas para executar apenas uma parte de um playbook.

tags: [configuration] ; --tags configuration

Precedência das variáveis

Regras que determinam qual o valor que prevalece quando uma variável existe em vários locais.

Une variable -e peut écraser une variable group_vars.
A reter :

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.

ansible-playbook site.yml --check
A reter :

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.

ansible-playbook site.yml --check --diff
A reter :

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.

ansible-vault encrypt group_vars/prod/vault.yml
A reter :

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.

no_log: true
A reter :

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.

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.

serial: 1 pour mettre à jour un serveur à la fois.
A reter :

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.

[defaults]
inventory = inventory.ini
A reter :

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.

ansible-galaxy collection install community.docker