Inhaltsverzeichnis

Begriffe

Begriff Erklärung
FactsEigenschaften eines Systems.

Können über das „setup“-Modul aufgelistet werden.

Gegen diese kann gematcht werden um Befehle zum Beispiel nur auf Maschinen mit bestimmten Eigenschaften auszuführen.
InventoryListe aller Hosts, ggf. gruppiert um sie als Gruppe anzusprechen
TasksAufruf eines Moduls um eine bestimmte Aufgabe durchzuführen
PlaybookSammlung von Tasks die als ein Satz ausgeführt werden
RolesRoles erlaubt es mehrere Playbooks zu einer Rolle zusammenzufassen.

Dadurch lassen sich Playbooks thematisch aufteilen, gleichzeitig aber zusammenfassen.0
Die Roles können wiederum in anderen Playbooks genutz werden.
Sinnvoll zum Beispiel um Systeme aufzusetzen → ein System kann dabei mehrere Rollen haben z.B. Basissystem + Webserver + Datenbankserver die jeweils in eigenen Rollen definiert werden können

Ad-Hoc-Kommandos

Syntax:

ansible <Host-Gruppe> -i Hostdatei -u <Login-User> -m <Modul> -a "<Optional Argumente>" -b 

Play-Book

ansible-playbook <Play-Book> -i <Pfad zur Host-Datei> -u <Einloogen als>

Aufbau

- name: <Beschreibung des Plays>
  hosts: <Liste der Hosts für die das Play ausgeführt werden soll>
  vars:
       <variable1>:<wert1>
       <variable2>:<wert2>
  remote_user: <username>
  
  tasks:
     - name: <taskname>
       <modulename>:
           <Moduleparameter>:value

Einige Keywords auf dieser Ebene:

Keyword Bedeutung
remote-userAls welcher Benutzer sich auf dem Remote-System eingeloggt wird
becomeWerde root nach dem Login.

Wert: yes

Tasks

tasks:
    - name: <somename>
      <modulename>:
          <parameter1>: <value1>
          <parameter2>: <value2>
    - name: <somename>
      <modulname>:
          <parameter1>: <value1>
          <parameter2>: <value2>
      notify: <handler-Name der Benachrichtigt werden soll>

Auch wenn Tasks mit Name beginnt, so ist der ganze Abschnitt ein gemeinsamer Listeneintrag, bestehend aus einem Dictionary mit mehreren Keys, „name“ ist nur ein Key in diesem Dictionary und könnte auch an einer beliebigen anderen Stelle im Dictionary stehen.

Handlers

Dienen dazu nach dem alle Tasks durch sind notwendige Dinge zu tun: wie Neustarts von Services usw.

tasks:
    - name: <somename>
      <modulename>:
          <parameter1>: <value1>
          <parameter2>: <value2>
    - name: <somename>
      <modulname>:
          <parameter1>: <value1>
          <parameter2>: <value2>
          notify: <somename>
handlers:
    - name: <somename>
      <modulname>:
         <parameter1>: <value1>
         <parameter2>: <value2>

Der Handler wird oben im zweiten Task aufgerufen (die notify-Zeile).
In der Handler-Konfiguration existiert dann ein Handler mit dem entsprechenden Namen.
Die Handler-Konfiguration entspricht ansonstem der eines Tasks.

Module

setup

Sammelt alle bekannten Facts über die entsprechende Maschine.
Das kann später benutzt werden um nur bestimmte Maschinen (auf die bestimmte Facts zutreffen) anzusprechen.

ping

Ping die Maschinen die angegeben wurden

Inventory

Gruppen:

[Gruppenname]
Einträge

Variablen-Sektionen:

[Gruppenname:vars]
Variable=Wert

Roles

Roles erlaubt es mehrere Playbooks zu einer Rolle zusammenzufassen.

Dadurch lassen sich Playbooks thematisch aufteilen, gleichzeitig aber zusammenfassen.0
Die Roles können wiederum in anderen Playbooks genutz werden.
Sinnvoll zum Beispiel um Systeme aufzusetzen → ein System kann dabei mehrere Rollen haben z.B. Basissystem + Webserver + Datenbankserver die jeweils in eigenen Rollen definiert werden können.

Optionen der Werkzeuge

Option Beschreibung
-k / –ask-passNormalerweise erwartet ansible das ssh-Login per Key funktioniert.
Die Option sorgt dafür das dass Passwort abgefragt wird
-b / –becomeNach dem Login via ssh, führe die Befehle mit sudo aus
-K / –ask-become-passIm Zusmmenhang mit sudo (Option -b) - Frage interaktiv nach dem sudo-Passwort

Dateien

ansible.cfg