Skip to content

Ansible-Module Spickzettel

Ansible ist ein leistungsstarkes Automatisierungstool. In diesem Artikel wird die Verwendung der gängigsten Module vorgestellt.

Format

Grundlegende Dateistruktur 

---
- hosts: production
  remote_user: root
  tasks:
  - ···

Bitte platzieren Sie Ihre Module unter tasks.

Aufgabenformat (Task Format)

Einzeiliges Format 

- apt: pkg=vim state=present

Mapping-Format 

- apt:
    pkg: vim
    state: present

Faltbares Skalarformat 

- apt: >
    pkg=vim
    state=present

Sie können jedes der oben genannten Formate verwenden, um Aufgaben zu definieren. Das einzeilige Format wird für kurze Deklarationen empfohlen, das Mapping-Format für längere.

Module

Aptitude

Paketverwaltung 

- apt:
    pkg: nodejs
    state: present # absent | latest
    update_cache: yes
    force: no

Deb-Paketdatei 

- apt:
    deb: "https://packages.erlang-solutions.com/erlang-solutions_1.0_all.deb"

Repository-Management 

- apt_repository:
    repo: "deb https://··· raring main"
    state: present

Repository-Schlüssel 

- apt_key:
    id: AC40B2F7
    url: "http://···"
    state: present

Git-bezogen 

- git:
    repo: git://github.com/
    dest: /srv/checkout
    version: master
    depth: 10
    bare: yes

Referenz: git Modul

Git-Konfiguration 

- git_config:
    name: user.email
    scope: global # local | system
    value: [email protected]

Referenz: git_config Modul

Benutzerverwaltung 

- user:
    state: present    # Status: vorhanden
    name: git        # Benutzername
    system: yes      # Systembenutzer
    shell: /bin/sh   # Login-Shell
    groups: admin    # Zugehörige Gruppen
    comment: "Git Version Control"  # Kommentar

Referenz: user Modul

Dienstverwaltung 

- service:
    name: nginx      # Dienstname
    state: started   # Status: gestartet
    enabled: yes     # Autostart aktiviert

Referenz: service Modul

Shell-bezogen

shell-Befehl 

- shell: apt-get install nginx -y

Zusätzliche Optionen 

- shell: echo hello
  args:
    creates: /path/file  # Überspringen, wenn Datei existiert
    removes: /path/file  # Überspringen, wenn Datei nicht existiert
    chdir: /path        # Vor der Ausführung in dieses Verzeichnis wechseln

Beispiel für mehrzeilige Befehle 

- shell: |
    echo "hello there"
    echo "multiple lines"

Referenz: shell Modul

Skriptausführung 

- script: /x/y/script.sh
  args:
    creates: /path/file  # Überspringen, wenn Datei existiert
    removes: /path/file  # Überspringen, wenn Datei nicht existiert  
    chdir: /path        # Vor der Ausführung in dieses Verzeichnis wechseln

Referenz: script Modul

Dateioperationen

Dateiverwaltung 

- file:
    path: /etc/dir
    state: directory # Typ: directory|file|link|hard|touch|absent

    # Optionale Parameter:
    owner: bin      # Eigentümer
    group: wheel    # Gruppe
    mode: 0644      # Berechtigungen
    recurse: yes    # Rekursiv erstellen
    force: yes      # Erstellung des Softlinks erzwingen

Referenz: file Modul

Dateikopie 

- copy:
    src: /app/config/nginx.conf   # Quelldatei
    dest: /etc/nginx/nginx.conf   # Zielort

    # Optionale Parameter:
    owner: user     # Eigentümer
    group: user     # Gruppe
    mode: 0644      # Berechtigungen
    backup: yes     # Backup erstellen, falls existiert

Referenz: copy Modul

Template (Vorlagen) 

- template:
    src: config/redis.j2       # Vorlagen-Quelldatei
    dest: /etc/redis.conf      # Zielort

    # Optionale Parameter:
    owner: user     # Eigentümer
    group: user     # Gruppe
    mode: 0644      # Berechtigungen
    backup: yes     # Backup erstellen, falls existiert

Referenz: template Modul

Lokale Aktionen

Lokale Ausführung 

- name: Aktionen lokal ausführen
  local_action: shell echo hello

Debug-Ausgabe 

- debug:
    msg: "Hello {{ var }}"

Referenz: debug Modul