Ansible - Playbook

Playbook er en fil som inneholder en rekke oppgaver som skal utføres på en eller flere enheter.
Playbook er skrevet i YAML format, så her er det viktig å ha riktig formatering.

Playbook oppsett i YAML

• 1.) Filer starter med --- i starten av filen.


• 2.) Innrykk er veldig viktig. Ikke bruk tab, bruk mellomrom.


• 3.) Kommentarer begynner med #


• 4.) Elemeter på samme nivå må ha samme innrykk.


• 5.) Under elementer må ha et ekstra innrykk i forhold til elementet over.

ansible playbook eksempel

• Begynn med --- i starten av filen. Det fungerer uten også, men dette er sett som best practice.


• Gi playbooken et navn og hvilke hoster som den skal utføres på:


• hoster kan være enkelt host eller en gruppe fra inventory filen.


• Jeg spesifiserer connection selv om jeg allerede har gjort det i group_vars filen.

gather_facts er en annen viktig parameter. Denne samler informasjon om hosten før playbooken kjører.

---
- name: Nettverk versjon switcher
  hosts: switcher
  connection: network_cli
  gather_facts: no

   
  tasks:
    - name: Hent versjon fra switcher
      ios_command:
        commands: show version
      register: output

    - name: Skriv ut versjon
      debug:
        var: output     
                

• Innrykk er veldig viktig. Ikke bruk tab, bruk mellomrom.


• name og task er på samme nivå, så de har samme innrykk.


• ios_command og debug er på samme nivå, så de har samme innrykk.


• ios_command og debug har et ekstra innrykk i forhold til name og tasks.


• ios_command og debug er tasks som skal utføres.


• ansible-playbook --syntaz-check er nyttig å bruke

Eksempel på når alt er i orden

ansible-playbook playbook_nettverk_ios_versjon.yaml --syntax-check

playbook: playbook_nettverk_ios_versjon.yaml     
                            

Eksempel på når noe er galt

ansible-playbook playbook_nettverk_ios_versjon.yaml --syntax-check
ERROR! We were unable to read either as JSON nor YAML, these are the errors we got from each:
JSON: Expecting value: line 1 column 1 (char 0)

Syntax Error while loading YAML.
  did not find expected key

The error appears to be in '/mnt/c/Git_autom8/ansible_lab/playbook_nettverk_ios_versjon.yaml': line 14, column 7, but may
be elsewhere in the file depending on the exact syntax problem.

The offending line appears to be:


      - name: Skriv ut versjon
      ^ here   
                                            

Kjøring av ansible-playbook

• Kjør ansible playbook med å spesifisere ansible-playbook etterfulg av yaml filen


• som inneholder tasken og hostene vi ønsker å kjøre mot.


• Det er ikke spesifisert noe passord for våre hoster.


• Kommer tilbake seinere på hvordan du kan bruke Ansible Vault


• ansible_password: kunne blitt spesfifisert i group_vars men det er endårlig vane


• Legg til -k for å bli spurt om passord når playbook kjører.

ansible-playbook playbook_nettverk_ios_versjon.yaml -k

Hvis du får en feilmelding som dette:

[WARNING]: ansible-pylibssh not installed, falling back to paramiko
[WARNING]: ansible-pylibssh not installed, falling back to paramiko
[WARNING]: ansible-pylibssh not installed, falling back to paramiko
[WARNING]: ansible-pylibssh not installed, falling back to paramiko

Installer ansible-pylibssh med pip install ansible-pylibssh
Les mer om ansible-pylibssh på https://www.ansible.com/blog/new-libssh-connection-plugin-for-ansible-network/

Når playbook kjører så vil du se output som dette:

"Switch Ports Model              SW Version        SW Image              Mode   ",
"------ ----- -----              ----------        ----------            ----   ",
"*    1 8     CAT9K_VIRTUAL Q200                   CAT9K_IOSXE           INSTALL",
"",
"",
"Configuration register is 0x2102"
]
]
}
}

PLAY RECAP ************************************************************************************************************
IOS_XE_switch_3            : ok=2    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0
IOS_XE_switch_4            : ok=2    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0
IOS_switch_1               : ok=2    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0
IOS_switch_2               : ok=2    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0