correction de la documentation et de bugs mineurs
[ansible.git] / montreal / gestionmateriel / docs / index.rst
1 Gestion Matériel
2 ================
3
4 Ce site web permet l'exécution de commandes Ansible depuis Django.
5 Notez que ce site est en version Beta et est sujet à changement.
6
7 .. image:: machines.png
8
9 .. contents::  Table des matières
10
11 Dépendances
12 -----------
13
14 Veuillez installer les dépendances avec les commandes suivantes::
15
16 Sur Ubuntu:
17
18   sudo apt-get install software-properties-common
19   sudo apt-add-repository ppa:ansible/ansible
20   sudo apt-get update
21   sudo apt-get install ansible
22   sudo apt-get install python-virtualenv python-pip python-sqlite redis-server python-mysqldb python-crypto
23
24
25 Sur Debian::
26
27   sudo apt-get install python-virtualenv python-pip python-sqlite redis-server python-mysqldb python-crypto
28   sudo pip install ansible
29
30 Installation
31 ------------
32
33 ::
34
35   virtualenv --system-site-packages .
36   source bin/activate
37   pip install -r requirements.txt
38   ./manage.py syncdb
39   ./manage.py migrate
40
41 Si vous n'avez pas encore créé un utilisateur vous pouvez le faire avec la commande::
42
43   ./manage.py createsuperuser
44
45 Vous devez ensuite modifier le fichier `maj.yml` selon vos besoins.
46
47 Utilisation
48 -----------
49
50 Pour démarrer le service Django utilisé la commande::
51
52   bin/python manage.py runserver
53
54 Ensuite, vous devez démarrer l'engin RQ::
55
56   bin/python manage.py rqworker
57
58 Pour utiliser l'interface web vous devez d'abord vous autentifier:
59
60   http://localhost:8000/
61
62 puis visiter la page suivante:
63
64   http://localhost:8000/admin/materiel/machine/
65
66 Ligne de commande
67 ^^^^^^^^^^^^^^^^^
68
69 Il est aussi possible d'utiliser la ligne de commande pour certaines tâches comme:
70
71 Collecter le nombre de paquets à mettre à jour sur l'ensemble des machines::
72
73   bin/python manage.py update
74
75 Rouler un module Ansible sur toutes les machines d'une catégorie::
76
77   bin/ansible -i inventory.py -m ping categorie
78
79 Tâches planifiées
80 -----------------
81
82 Pour utiliser les tâches planifiées vous devez rouler la commande suivante::
83
84   bin/python manage.py rqscheduler
85
86 FAQ
87 ---
88
89 Problème:
90
91   Mes commandes n'exécute pas
92
93 Solution:
94
95   * Vérifier que vous avez bien démarrer la commande `bin/python manage.py qworker`
96   * Vérifier que votre commande ssh ne demande pas d'ajouter un fingerprint.
97   * Vérifier que votre commande ssh ne demande pas de phrase secrète.
98   * Vérifier que le port de connexion est bien 22.
99   * Vérifier que l'utilisateur distant est bien root.
100
101
102 Aides et supports
103 -----------------
104
105   patrick.hetu (a) auf.org
106
107 Améliorations possibles
108 -----------------------
109
110 * Sauvegarde des traces de l'exécution (logs)
111 * Sommaire de la mise-à-jour par courriel
112 * Gestion de la configuration de SSH (clés, config, etc)
113 * Tests unitaires et d'intégration
114 * Intégration avec GLPI: https://github.com/mcphargus/python-glpi
115
116 Versions
117 --------
118
119 0.1
120 ^^^
121
122 * Fusion avec le site: http://git.auf.org/?p=progfou.git;a=tree;f=gestionmateriel
123 * Démarrage des machines à l'aide de la commande `wakeonlan`
124 * Interface utilisateur améliorée (temps réel)
125 * Tâches planifiées (cron)
126 * Migration à python-rq
127
128 Licence
129 -------
130
131 Le code source et la documentation sous Copyright ©2014 AUF.
132 Le code est sous Licence AGPL3. Voir le fichier LICENCE
133