Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen der Seite angezeigt.

--- wiki:ansible [2024/01/21 22:31] – [System Einrichtung] techguru
+++ wiki:ansible [2025/11/26 23:16] (aktuell) – [System Einrichtung] pulsar
@@ Zeile 1: / Zeile 1: @@
+====== Ansible ======
+===== System Einrichtung =====
+Auf dem Ansible Kommando Rechner ist das Paket ''ansible'' sowie ''sshpass'' zu installieren. Da Ansible default SSH keys verwendet, aber bei der Ersteinrichtung zunächst den Nutzer pi verwendet und hier SSH Passwort Authentifizierung genutzt wird.
+  apt install ansible sshpass
+Zuvor wurde ein Passwort Hash z.B. mit Python erzeugt. Wie das funktioniert, ist auf der [[:systemadmin|systemadmin]] Seite beschrieben. Dieser Hash enthält das verschleierte Passwort
+für den neuen zu erstellenden backup Benutzer. :!: Dieser Hash ist im Start-playbook enthalten, daher muss dieser Schritt i.d.R. nicht mehr ausgeführt werden. :!:
+Mit ''-k'' kann das Passwort für dem im Playbook angegebenen Remote Benutzer eingegeben werden. Diesen Benutzer verwenden wir nur für die erst Einrichtung.
+Konfigurations Ordner aus Sicherung in das neue Ansible Master System rüber kopieren. Im Start-playbook sollten alle Pfade und Dateien(z.B. ssh-key) zum Konfigurations-Ordner verweisen. In der ansible.cfg auf den Pfad mit Nutzername zur hosts Datei achten.
+=== Ansible Ersteinrichtung für ein entferntes System ===
+Folgenden Kommando nur wenn Ansible Ersteinrichtung für ein entferntes System durchgeführt werden soll. Start-playbook auf dem Ansible Master System ausführen für das iglu Remote-System:
+  ansible-playbook -k -i /home/pi/xy/Konfiguration/ --limit iglu Start-playbook.yml
+oder besser die ''-k'' Option ans Ende setzen.
+  ansible-playbook --limit iglu Start_playbook.yml -k
+=== Ansible Ersteinrichtung ===
+Die Angabe des Hostnamen kann weglassen werden wenn im playbook der hostname, z.B. localhost schon bei hosts: drin steht. Da das Playbook aber nicht nur auf dem Ansible Kommando Rechner ausgeführt werden soll sondern für jeden Host eingesetzt wird, steht bei hosts: all. Hier kann man beim Ausführen des Playbooks mit --limit dann angeben auf welchen Host es aktuell ausgeführt werden soll.
+  ansible-playbook -k --limit iglu start_sshlogin.yml
+<code php>
+ ---
+ - hosts: all
+   vars:
+     devops_password: '$6$OfKLYEUGj4tcy$6KJS3UQARnmXqasJaIvWsS1pwUbrpQBvxbxJ55PryPPI604TgsS31lnhKo8'
+   gather_facts: no
+   remote_user: pi
+   become: true
+   tasks:
+   - name: Gruppe backup erstellen
+     group:
+          name: backup
+          gid: 7500
+          state: present
+   - name: Nutzer tux erstellen
+     user:
+          name: tux
+          uid: 2121
+          groups: adm, sudo, audio, video, plugdev, users, input, netdev, backup, pi
+          shell: /bin/bash
+          password: "{{ devops_password }}"
+   - name: Nutzer backup hinzufügen zu sudoers
+     copy:
+          dest: "/etc/sudoers.d/backup"
+          content: "backup  ALL=(ALL)  NOPASSWD: ALL"
+   - name: SSH public Key hinzufügen
+     authorized_key: user=backup
+                     key="{{ lookup('file', '/home/backup/.ssh/id_rsa.pub') }}"
+                     state=present
+</code>
+Nach der Ausführung des ''Start_playbook.yml'' ist der neue Backup Nutzer angelegt. Als diesen kann man sich nun anmelden und der ''/home/pi/xy/Konfiguration/'' sollte zum neuen Ansible Kontroll-Nutzer **verschoben** werden.
+Neu:
+In das Verzeichnis ''/home/tux/Dokumente/Konfiguration/Ansible/'' wechseln. Hier das ''ansible-playbook'' Kommando für das gewünschte Playbook ausführen. Da hier die ansible.cfg liegt und diese automatisch genutzt wird wenn man sich im selben Pfad befindet:
+  ansible-playbook hauptkonfig.yml
+Hier muss auch keine Inventory Datei mit angegeben werden, da diese in der ''ansible.cfg'' so konfiguriert ist, das direkt die hosts-Datei im selben Verzeichnis verwendet wird.
+===== Ansible Einzeiler =====
+Ohne gleich ein Playbook oder eine komplette Role zu erstellen, kann man ansible direkt ausführen und
+die entsprechenden Parameter übergeben.
+==== Updates für Suse ====
+  ansible localhost -m zypper -a "update_cache=yes state=latest name='*'" --become -K
+==== Updates für alle Debian Systeme ====
+Alle Rechner im Netzwerk gleichzeitig mit Updates versorgen. Dafür braucht man kein extra Playbook schreiben, hier reicht auch ein Ad-Hoc Kommando.
+Hier wird das Ansible ''shell'' Modul aufgerufen um die bekannten Kommandos von der Bash zu nutzen:
+  ansible all -m shell -a "sudo apt update && sudo apt autoremove && sudo apt upgrade -y"
+Im nächsten Aufruf wird das Ansible ''apt'' Modul verwendet, dies ist der von Ansible empfohlene Weg:
+  ansible all -m apt -a "update_cache=yes upgrade=yes autoremove=yes cache_valid_time=86400" --become
+Anzeigen der SCSI Harddisk ID und der dazugehörigen Mountpunkte, dann ein grep (Filtern) nach einem bestimmten Mountpunkt.
+  ansible all -i inventories/produktion/ -m shell -a "lsblk --output HCTL,PATH,MOUNTPOINT,PARTLABEL|grep -iC2 oraexp"
+==== Nur auf einer Gruppe ====
+Kommando nur auf den Rechnern in einer bestimmten Inventory-Datei ''testing'' ausführen.
+  ansible all -i inventory-Lager/testing -a "/root/agentinstall.sh --uninstall --clean" --become
+Playbook für eine sub-Gruppe(hier die Gruppe: jboss) innerhalb einer Inventory-Datei ''produktion'' ausführen.
+  ansible-playbook -i produktion -l jboss playbooks/add_icinga-agent.yml --ask-vault-pass
+==== Ohne Inventory und zusätzliche Dateien ====
+Beachte das Komma nach dem Hostnamen. Es ist wichtig, da es Ansible signalisiert, dass dies eine Liste von Hosts ist, auch wenn es nur einer ist. Mit dem Schalter ''-e'' werden extra Variablen mit übergeben.
+  ansible-playbook -i 'servername.example.com,' -e "ansible_user=admin ansible_password=secretpass" playbook.yml
+==== Reboot und Poweroff ====
+Nur den Rechner iglu neu-starten:
+  ansible iglu -a "/sbin/reboot" --become
+Alle Maschinen ausschalten. Achtung! Auch den Host von wo aus der Kommando ausgeführt wird, wenn in all enthalten:
+  ansible all -a "/sbin/poweroff" --become
+===== Ansible Playbooks =====
+<code php>
+---
+# Playbook für die Ersteinrichtung des Systems
+# Es wird ein neuer Haupt-Nutzer angelegt und die benötigte Standard-Software installiert.
+- hosts: all
+  vars:
+    tux_password: '$6$yad.Pht99YEu9zsl$peArU8hOYVo/xzAsyWiF2ANIw5pLmkfOqRXNVospQr661'
+# Um den Abbruch mit "ansible_hostname' is undefined" zu verhindern, muss gather_facts: yes gesetzt sein.
+# Oder man entfernt die Zeile komplett, denn "gather_facts: yes" müsste als Standard eingestellt sein.
+  gather_facts: yes
+# Mit -k kann das Passwort für dem im Playbook angegebenen Remote Benutzer eingegeben werden.
+  remote_user: pi
+  become: true
+  tasks:
+  - name: Nutzer tux - erstellen
+    user:
+         name: tux
+         uid: 1111
+         groups: adm, sudo, audio, video, plugdev, users, input, netdev, gpio, i2c, spi, pi
+         shell: /bin/bash
+         password: "{{ tux_password }}"
+  - name: NFS-Freigabe mount Verzeichnis - erstelle Mount-Punkt
+    file:
+      path: /home/pi/NFSFreigabe
+      state: directory
+      owner: pi
+      group: users
+      mode: '0775'
+  - name: Installation - Desktop Standard Pakete
+    apt:
+      name: "{{ item }}"
+      update_cache: yes
+      cache_valid_time: 86400 #Cache nur Updaten wenn älter als 1 Tag
+    when: 'iglu' in inventory_hostname
+    loop:
+      - marble
+      - pidgin
+      - wesnoth
+  - name: De-Installation - Nicht benötigte Pakete werden entfernt
+    apt:
+      name: "{{ item }}"
+      state: absent
+    loop:
+      - scratch*
+      - minecraft-pi
+      - cups-client
+      - realvnc-vnc-server
+      - samba-common
+      - cifs-utils*
+</code>
+<code php>
+---
+# Playbook für Icinga2 - Installation aller Monitoring Plugins
+# Einrichten des icinga Benutzers
+# Einfügen des SSH-Keys
+- hosts: monitoring
+  become: yes
+  tasks:
+  - name: installiere benötigte Pakete
+    zypper:
+      name: ['bind','bind-utils']
+      state: latest
+      disable_recommends: no
+    notify: enable named
+    when: (ansible_hostname != 'zcm' and ansible_hostname != 'pdx2')
+  - name: Sicher stellen das group "icinga" existiert
+    group:
+      name: icinga
+      gid: 600
+      state: present
+  - name: Erstelle Icinga Benutzer
+    block:
+      - user:
+          name: icinga
+          state: present
+          home: /usr/local/icinga
+          comment: System Monitoring
+          shell: /bin/bash
+          uid: 900
+          group: icinga
+    when: ansible_hostname == 'zcm'
+  - name: Set authorized key taken from file
+    authorized_key:
+      user: icinga
+      state: present
+      key: "{{ 'ssh-rsa AAAAB3NzaC1yc2EAAAADNAHXGAQAQDixsxXlraHdDJq91k/0XOiXMhKVrx+dkFrjKyO+gulxXc+OA+PiDw3BzFG347c1aO5eM+8lwVOlrrNeSw1evryWVef9J4NOReMbgNUSUHU637263x/V+J++NNYBmWR9 icinga@moni2' }}"
+</code>
+===== Module =====
+Mit copy Modul eine leer Datei erstellen, wenn noch nicht existent.
+<code>
+  - name: sicherstellen das Log-Dateien existieren
+    copy:
+      content: ""
+      dest: /var/adm/log/dhcpdns_sync.lg
+      force: no
+      group: hw
+      owner: ansible
+      mode: 0664
+</code>