Silumine (debug) ja selektiivne käivitamine¶

Ansible sisse on ehitatud ka terve hulk abivahendeid, et vähendada käivituse ohtu ja aidata süsteemide täpsema juhtimisega.

Praktiline osa 5 - silumine¶

Enne kui liigume keerukamate loogikate juurde, õpime kuidas Ansiblega muudatusi "kuivalt" (dry-run) läbi mängida ja kuidas jooksutada vaid osa playbookist.

See on kriitiline oskus, et vältida "oops" momente toodangus, eriti tundmatute moodulite ja rollidega.

Ansiblel on kolm väga võimsat lippu:

• --syntax-check: Teeb algelise süntaktilise kontrolli ilma playbooki käivitamata.

• --check (või -C) - "Dry-run": Teeb kõik arvutused läbi, aga ei rakenda muudatusi sihtmasinas.

• --diff (või -D): Näitab täpselt, rida-realt, mis failides muutuks.

Syntax check¶

Hea meetod, näiteks peale muudatuste tegemist, kas playbookiga kõik korras:

ansible-playbook --syntax-check <playbook>

Pigem vajalik automaatsetes olukordades (enne CVS commiti/pushi, CI/CD sammu osana), aga tänapäeval veel võimsamaid variante olemas.

Check mode¶

Check mode'i primaarne kasutus on enne päriselt Ansible playbooki käima panemist kontrollida, kas miski muutub. Selleks pannakse Ansible playbook käima koos --check lipuga, ja Ansible näitab iga taski mis muutus.

ansible-playbook <playbook> -i hosts --check

Check mode ei ole perfektne - näiteks ei saa ta hakkama olukorraga kus üks task jookseb vastavalt teise taski väljundile. Sellisel juhul jäetakse taskid lihtsalt vahele.

Check mode'iga seoses on ka erinevad juhtimise konstruktsioone:

• Kui tahad sundida taski alati jooksma päriselt, isegi check mode'is, või vastupidi - ainult check mode'is, isegi kui playbooki jooksutatakse päriselt: Ansible docs
• Kui tahad jätta taskid check mode'is vahele, või peita errorid: Ansible docs

Diff mode¶

Diff mode (--diff) on teistsugune, seda kasutades jookseb playbook normaalselt, aga käivitusel prinditakse välja rohkem infot, mis täpselt failides muutus (kus saab, enamasti copy/template jms moodulid).

See võib suuremate playbookide puhul tekitada väga palju läbu.

ansible-playbook <playbook> -i hosts --diff

Diff mode'il on viga, kus see võib konsoolis nähtavaks teha ka sensitiivset infot. Taskile saab diff mode'i keelata: Ansible docs

Diff + check¶

Kui check mode'i jooksutada, siis muudatusi ei toimu.

Kui diff mode'i jooksutada, siis muudatused toimuvad, aga näidatakse mis juhtus.

Tegelikult võib ka neid koos jooksutada:

ansible-playbook <playbook> -i hosts --diff --check

Sellisel juhul muudatused ei toimu, aga näidatakse mis juhtuks.

Praktiline osa 6 - selektiivne käivitamine¶

Playbookidega võib suhteliselt kiiresti jõuda olukorda, kus ei taha neid kogu aeg jooksutada terve inventory peale korraga, või tahaks jooksutada ainult ühte osa playbookist.

Kuigi saab teha tried-and-tested välja/sisse kommenteerimist, siis on Ansiblel selleks palju meeldivamad varjandid.

Sildid (tags)¶

Kui playbookid lähevad pikaks (sajad taskid), on tüütu oodata terve playbooki läbimist, et muuta vaid ühte konfiguratsioonifaili. Selleks on tags.

tasks:
  - name: Debug message
    debug:
      msg: "Say a debug message"
    tags: debug

- name: Copy HTML file
  template:
    src: index.html
    dest: /usr/share/nginx/html/index.html
    force: true
  when: ansible_distribution == "CentOS"
  tags: html

- name: Copy HTML file
  template:
    src: index.html
    dest: /var/www/html/index.html
    force: true
  when: ansible_distribution == "Debian"
  tags: html

ansible-playbook <playbook> -i hosts --tags debug

Eksisteerib ka eriline tag always, mis käivitatakse alati - isegi siis kui käivitada tagiga muu. See on variant näiteks info kogumise või eeldustaskide käivitamiseks.

Kui soovida panna tag tervele rollile (teeb lihtsamaks konkreetse rolli kasutuse), siis saab seda teha nii:

roles:
  - name: nginx
    tags: nginx

Piiramine (limit)¶

Kui --tags filtreerib mida tehakse, siis --limit filtreerib kellele tehakse.

Playbooki hosts osa piirab, mis seadmete pihta playbook jooksutatakse, aga vahel on vaja piirata veelgi.

Limit töötab kas defineeritud nime või grupinime alusel.

ansible-playbook <playbook> -i hosts --limit centos

ansible-playbook <playbook> -i hosts --limit <masina_ip>

Limiidid töötavad ka inversiooniga, näiteks --limit !centos jookseb kõigi seadmete vastu, mis pole grupis centos.

Praktilise osa lõpp¶

Kui lõpetasite praktilise osa, siis võib kasutada ülejäänud aega sirutuspausina! Tubli töö!