22
0
Fork 0
wiki/HowtoAnsible/Cisco.md

133 lines
4.7 KiB
Markdown
Raw Normal View History

2017-09-13 19:18:20 +02:00
---
title: Howto Ansible/Cisco : automatisation d'infrastructure
2018-03-23 14:06:20 +01:00
categories: automation
...
2017-09-13 19:18:20 +02:00
2018-03-23 14:06:20 +01:00
* Howto Ansible : <https://wiki.evolix.org/HowtoAnsible>
2017-09-14 10:53:25 +02:00
* Documentation des modules : <http://docs.ansible.com/ansible/latest/list_of_network_modules.html#ios>
2017-09-13 19:18:20 +02:00
Cette documentation est basée sur la version 2.2 d'Ansible que nous utilisons actuellement, et est susceptible de différer dès la version 2.3.
2018-03-23 14:06:20 +01:00
## Connexion aux switchs
2017-09-13 19:18:20 +02:00
2018-03-23 14:06:20 +01:00
Ansible utilise Python, mais ce dernier n'étant pas disponible sur les switchs, le mode de connexion n'est pas le même. Au lieu d'utiliser une connexion SSH, on doit utiliser une connexion locale : Ansible exécute le code sur la machine locale, ce qui génère les commandes qui sont ensuite envoyées par SSH sur le switch distant. Cela pose cependant un problème : le switch sur lequel on veut lancer un playbook doit être directement accessible par la machine locale, puisque le fichier `~/.ssh/config` n'est pas utilisé.
2017-09-13 19:18:20 +02:00
On doit donc indiquer dans notre playbook comment la machine locale doit se connecter sur le switch distant dans une variable qui sera ensuite passée à chaque utilisation d'un module.
Le mode de récupération des facts par défaut d'Ansible ne fonctionne également pas, il faut le désactiver. Un module spécifique lui est dédié.
~~~{.yaml}
- hosts: switchs
gather_facts: no
connection: local
vars:
provider:
host: "{{ inventory_hostname }}"
username: "{{ ansible_user }}"
password: "{{ ansible_ssh_pass }}"
~~~
Le nom dans l'inventory doit alors correspondre au nom utilisé pour se connecter au switch. Si aucun hostname ne lui est associé, son IP doit être utilisée. Si l'on veut quand même utiliser un nom d'hôte sous forme d'alias, une variable doit être définie dans le fichier d'inventory :
~~~
[switchs]
SW01 SWITCH_IP=192.0.2.1
~~~
Et cette variable doit être utilisée dans le playbook :
~~~{.yaml}
vars:
provider:
host: "{{ SWITCH_IP }}"
username: "{{ ansible_user }}"
password: "{{ ansible_ssh_pass }}"
~~~
Ainsi, on peut choisir sur quelle machine lancer le playbook avec le nom défini dans l'inventory.
2017-09-14 10:53:25 +02:00
# Modules
Chaque module doit contenir la variable `provider` précédemment définie pour se connecter aux switchs :
~~~{.yaml}
- ios_XXX:
provider: "{{ provider }}"
~~~
## ios_facts
Le module [ios_facts](http://docs.ansible.com/ansible/latest/ios_facts_module.html) permet de récupérer les facts d'un switch.
~~~{.yaml}
- ios_facts:
provider: "{{ provider }}"
gather_subset:
- "all"
~~~
Trois type de facts peuvent être récupérés et définis avec `gather_subset` :
* `config` renvoie le contenu de la running-config.
2017-09-14 15:25:45 +02:00
* `interfaces` renvoie la description détaillée de chaque interface : adresse IP, description, status, adresse mac, …
2017-09-14 10:53:25 +02:00
* `hardware` renvoie le détail du hardware : mémoire, filesystem.
On peut ensuite vérifier que la configuration soit conforme en se servant de debug :
~~~{.yaml}
- debug:
msg: "Management interface down"
when: ansible_net_interfaces.FastEthernet0.operstatus == "administratively down"
- debug:
msg: "Domain-name not or badly configured"
when: "not 'ip domain-name example.com' in ansible_net_config"
~~~
## ios_command
Le module [ios_command](http://docs.ansible.com/ansible/latest/ios_command_module.html) permet de lancer des commandes basiques (pas en mode configuration) sur le switch.
Cela peut être utile pour récupérer des valeurs non renvoyées par les facts :
~~~{.yaml}
- ios_command:
provider: "{{ provider }}"
commands:
- show clock
register: clock
~~~
## ios_config
Le module [ios_config](http://docs.ansible.com/ansible/latest/ios_config_module.html) permet de configurer le switch en spécifiant les commandes que l'on veut appliquer :
~~~{.yaml}
- name: load new acl into device
ios_config:
provider: "{{ provider }}"
lines:
- 10 permit ip host 1.1.1.1 any log
- 20 permit ip host 2.2.2.2 any log
- 30 permit ip host 3.3.3.3 any log
- 40 permit ip host 4.4.4.4 any log
- 50 permit ip host 5.5.5.5 any log
parents: ip access-list extended test
before: no ip access-list extended test
match: exact
~~~
2017-09-14 10:56:58 +02:00
Cette tâche sera exécutée uniquement si la configuration actuelle ne contient pas exactement ces valeurs (`match: exact`) et est l'équivalent de :
2017-09-14 10:53:25 +02:00
~~~
2018-03-23 14:06:20 +01:00
Switch(config)# no ip access-list extended test
Switch(config)# ip access-list extended test
Switch(config-ext-nacl)# 10 permit ip host 1.1.1.1 any log
Switch(config-ext-nacl)# 20 permit ip host 2.2.2.2 any log
Switch(config-ext-nacl)# 30 permit ip host 3.3.3.3 any log
Switch(config-ext-nacl)# 40 permit ip host 4.4.4.4 any log
Switch(config-ext-nacl)# 50 permit ip host 5.5.5.5 any log
2017-09-14 15:25:45 +02:00
~~~