Zum Inhalt

ansible-pull

Dreht die Richtung um: Der Server holt sich ein Playbook aus einem Git-Repository und wendet es auf sich selbst an.

ansible-pull output

Syntax

ansible-pull -U REPO_URL [OPTIONEN] [PLAYBOOK.yml]

Optionen

Option Beschreibung
-U URL Git-Repository mit den Playbooks
PLAYBOOK.yml Auszuführendes Playbook; ohne Angabe <hostname>.yml oder local.yml
-C BRANCH Auszucheckender Branch oder Tag
-d VERZEICHNIS Wohin das Repository ausgecheckt wird (Standard ~/.ansible/pull/<hostname>)
-o, --only-if-changed Nur ausführen, wenn das Repository neue Commits hat
-s SEKUNDEN Vorher eine zufällige Zeit bis zu so vielen Sekunden warten, damit nicht alle Server gleichzeitig starten
--vault-password-file DATEI Passwort für verschlüsselte Dateien

Beispiele

Die Konfiguration holen und anwenden:

ansible-pull -U https://git.example.com/ops/config.git local.yml
Starting Ansible Pull at 2026-10-26 10:42:17
/usr/bin/ansible-pull -U https://git.example.com/ops/config.git local.yml
localhost | CHANGED => {
    "after": "5c9bef1c4897f55aaf5a87f316a508f096778417",
    "before": null,
    "changed": true
}

PLAY [Base configuration] ******************************************************

TASK [Gathering Facts] *********************************************************
ok: [localhost]

TASK [Message of the day] ******************************************************
changed: [localhost]

PLAY RECAP *********************************************************************
localhost                  : ok=2    changed=1   unreachable=0    failed=0    skipped=0    rescued=0    ignored=0

Der erste Block ist der git-Checkout, danach läuft das Playbook wie gewohnt. Je nach Playbook gibt Ansible zusätzlich Warnungen zum Host-Muster aus; die sind harmlos.

Nur laufen, wenn sich etwas geändert hat:

ansible-pull -U https://git.example.com/ops/config.git -o local.yml
Starting Ansible Pull at 2026-10-26 11:12:17
/usr/bin/ansible-pull -U https://git.example.com/ops/config.git -o local.yml
localhost | SUCCESS => {
    "after": "5c9bef1c4897f55aaf5a87f316a508f096778417",
    "before": "5c9bef1c4897f55aaf5a87f316a508f096778417",
    "changed": false,
    "remote_url_changed": false
}
Repository has not changed, quitting: ...

Das Playbook im Repository:

cat ~/.ansible/pull/tuxdex-srv/local.yml
- name: Base configuration
  hosts: localhost
  connection: local
  tasks:
    - name: Message of the day
      ansible.builtin.copy:
        content: "Managed by Ansible. Changes will be overwritten.\n"
        dest: ~/motd.txt
        mode: "0644"

Wann brauche ich das?

  • Für viele Server, die sich selbst konfigurieren sollen, etwa per Cronjob
  • Für Server, die der Steuerrechner nicht erreicht, etwa Rechner hinter NAT
  • Um einen neuen Server am Ende seiner Installation mit einem einzigen Befehl einzurichten

Als Cronjob oder Timer

*/30 * * * * ansible-pull -U https://git.example.com/ops/config.git -o -s 300 prüft alle 30 Minuten, wendet nur Änderungen an und verteilt die Last. Siehe crontab.

Das Repository hat Macht über den Server

Wer in das Repository pushen darf, kann auf jedem Server, der davon holt, beliebige Befehle ausführen. Schütze das Repository wie einen Root-Zugang.

Verwandte Befehle

ansible-playbook · ansible-vault · git clone · crontab