ajout modules

HowtoAnsible/Cisco.md

@@ -3,7 +3,7 @@ title: Howto Ansible/Cisco : automatisation d'infrastructure
 categories automation
 ---
 
-* Documentation : <http://docs.ansible.com/ansible/latest/list_of_network_modules.html#ios>
+* Documentation des modules : <http://docs.ansible.com/ansible/latest/list_of_network_modules.html#ios>
 
 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.
 
@@ -25,9 +25,6 @@ Le mode de récupération des facts par défaut d'Ansible ne fonctionne égaleme
       host: "{{ inventory_hostname }}"
       username: "{{ ansible_user }}"
       password: "{{ ansible_ssh_pass }}"
-
-  roles:
-    - role-name
 ~~~
 
 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 :
@@ -49,4 +46,86 @@ Et cette variable doit être utilisée dans le playbook :
 
 Ainsi, on peut choisir sur quelle machine lancer le playbook avec le nom défini dans l'inventory.
 
-# Modules
+# 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.
+* `interfaces` renvoie la description détaillée de chaque interfaces : adresse, description, status, adresse mac, …
+* `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
+~~~
+
+Cette tâche sera exécutée uniquement si la configuration actuelle ne contenait pas exactement ces valeurs (`match: exact`) et est l'équivalent de :
+
+~~~
+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
+~~~