LU10b - Provisioning mit Ansible (idempotent konfigurieren)

Ohne Provisioning passiert das hier:

• Jede:r installiert manuell Pakete
• Jede:r vergisst etwas
• Jede:r hat andere Versionen/Einstellungen
• Debugging wird unfair („bei mir geht’s“)

Mit Provisioning:

• Einmal definieren → immer reproduzierbar
• Gleiche Ausgangslage für alle
• Ideal für Multi-Node Labs

Welche Maschinen gibt es und wie heissen sie?

Beispiel (klassisch):

[db]
192.168.56.11
 
[api]
192.168.56.12
 
[proxy]
192.168.56.13

Ein YAML-Dokument, das beschreibt, was auf welchen Hosts passieren soll.

Ein einzelner Schritt, z.B. „nginx installieren“.

„Bausteine“ für typische Dinge: `apt`, `copy`, `template`, `service`, `user`, `lineinfile`…

Wird nur ausgelöst, wenn sich etwas ändert (z.B. Config geändert → nginx reload).

Es gibt zwei gängige Wege:

• Ansible läuft auf deinem Host
• Vagrant übergibt die VM-Infos an Ansible
• Vorteil: schnell, simpel (wenn Host Ansible hat)
• Nachteil: Host muss Ansible installiert haben (Windows teils mühsam)

• Ansible wird in der VM installiert und dort ausgeführt
• Vorteil: host-unabhängiger, oft „klassen-tauglicher“
• Nachteil: Playbook-Lauf ist minimal langsamer

projekt/
├─ Vagrantfile
└─ provision/
   ├─ playbook.yml
   ├─ group_vars/
   │  ├─ all.yml
   └─ templates/
      └─ nginx.conf.j2

Vagrant.configure("2") do |config|
  config.vm.box = "ubuntu/jammy64"
 
  nodes = {
    "db"    => "192.168.56.11",
    "api"   => "192.168.56.12",
    "proxy" => "192.168.56.13"
  }
 
  nodes.each do |name, ip|
    config.vm.define name do |node|
      node.vm.hostname = name
      node.vm.network "private_network", ip: ip
    end
  end
 
  # Ansible läuft in der VM (ansible_local)
  config.vm.provision "ansible_local" do |ansible|
    ansible.playbook = "provision/playbook.yml"
    ansible.install = true
  end
end

Dieses Playbook zeigt typische Patterns:

• Pakete installieren
• /etc/hosts pflegen (damit Namen auflösbar sind)
• nginx als Proxy konfigurieren
• Services starten/aktivieren

# provision/playbook.yml
- name: Multi-Node Setup fuer verteilte Systeme
  hosts: all
  become: true

  vars:
    cluster_hosts:
      - { name: "db",    ip: "192.168.56.11" }
      - { name: "api",   ip: "192.168.56.12" }
      - { name: "proxy", ip: "192.168.56.13" }

  tasks:
    - name: Pakete installieren (Basis)
      ansible.builtin.apt:
        name:
          - curl
          - ca-certificates
          - net-tools
          - python3
          - python3-pip
        update_cache: true
        state: present

    - name: /etc/hosts fuer Cluster-Namen pflegen
      ansible.builtin.lineinfile:
        path: /etc/hosts
        line: "{{ item.ip }} {{ item.name }}"
        state: present
      loop: "{{ cluster_hosts }}"

- name: Proxy Node konfigurieren
  hosts: proxy
  become: true

  tasks:
    - name: nginx installieren
      ansible.builtin.apt:
        name: nginx
        update_cache: true
        state: present

    - name: nginx config deployen
      ansible.builtin.template:
        src: templates/nginx.conf.j2
        dest: /etc/nginx/sites-available/default
      notify: reload nginx

    - name: nginx aktivieren und starten
      ansible.builtin.service:
        name: nginx
        state: started
        enabled: true

  handlers:
    - name: reload nginx
      ansible.builtin.service:
        name: nginx
        state: reloaded

# provision/templates/nginx.conf.j2
server {
  listen 80;
 
  location / {
    proxy_pass http://api:8000;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
  }
}

# in der VM (ansible_local) typischerweise:
sudo ansible-playbook /vagrant/provision/playbook.yml
 
# mehr Details:
sudo ansible-playbook /vagrant/provision/playbook.yml -vv

• falscher Pfad zu Templates
• Service heisst anders (z.B. nginx vs apache2)
• Ports stimmen nicht (Proxy zeigt auf falschen Port)
• Rechte fehlen → `become: true` vergessen

• check mode (trocken laufen lassen): `–check`
• syntax check: `–syntax-check`
• Variablen pro Umgebung (`group_vars`, `host_vars`)
• Rollen (`roles/`) für saubere Wiederverwendung

Kevin Maurizi