correction de la documentation et de bugs mineurs
[ansible.git] / montreal / gestionmateriel / docs / index.rst
CommitLineData
977660bd
PH
1Gestion Matériel
2================
3
4Ce site web permet l'exécution de commandes Ansible depuis Django.
e7218ccc 5Notez que ce site est en version Beta et est sujet à changement.
977660bd
PH
6
7.. image:: machines.png
8
9.. contents:: Table des matières
10
11Dépendances
12-----------
13
ea65dcfa 14Veuillez installer les dépendances avec les commandes suivantes::
977660bd 15
ea65dcfa 16Sur Ubuntu:
977660bd 17
ea65dcfa
PH
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
25Sur Debian::
26
27 sudo apt-get install python-virtualenv python-pip python-sqlite redis-server python-mysqldb python-crypto
28 sudo pip install ansible
977660bd
PH
29
30Installation
31------------
32
33::
34
ea65dcfa 35 virtualenv --system-site-packages .
977660bd
PH
36 source bin/activate
37 pip install -r requirements.txt
38 ./manage.py syncdb
39 ./manage.py migrate
ea65dcfa
PH
40
41Si vous n'avez pas encore créé un utilisateur vous pouvez le faire avec la commande::
42
977660bd
PH
43 ./manage.py createsuperuser
44
45Vous devez ensuite modifier le fichier `maj.yml` selon vos besoins.
46
47Utilisation
48-----------
49
50Pour démarrer le service Django utilisé la commande::
51
52 bin/python manage.py runserver
53
e7218ccc
PH
54Ensuite, vous devez démarrer l'engin RQ::
55
56 bin/python manage.py rqworker
57
977660bd
PH
58Pour utiliser l'interface web vous devez d'abord vous autentifier:
59
e7218ccc 60 http://localhost:8000/
977660bd
PH
61
62puis visiter la page suivante:
63
ea65dcfa 64 http://localhost:8000/admin/materiel/machine/
977660bd
PH
65
66Ligne de commande
67^^^^^^^^^^^^^^^^^
68
69Il est aussi possible d'utiliser la ligne de commande pour certaines tâches comme:
70
71Collecter le nombre de paquets à mettre à jour sur l'ensemble des machines::
72
fa5244e6
PH
73 bin/python manage.py update
74
75Rouler un module Ansible sur toutes les machines d'une catégorie::
76
e7218ccc 77 bin/ansible -i inventory.py -m ping categorie
977660bd 78
ea65dcfa
PH
79Tâches planifiées
80-----------------
81
82Pour utiliser les tâches planifiées vous devez rouler la commande suivante::
83
84 bin/python manage.py rqscheduler
85
86FAQ
87---
88
89Problème:
90
91 Mes commandes n'exécute pas
92
93Solution:
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
977660bd
PH
102Aides et supports
103-----------------
104
105 patrick.hetu (a) auf.org
106
107Améliorations possibles
108-----------------------
109
977660bd
PH
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)
977660bd 113* Tests unitaires et d'intégration
fa5244e6
PH
114* Intégration avec GLPI: https://github.com/mcphargus/python-glpi
115
116Versions
117--------
118
e7218ccc 1190.1
fa5244e6
PH
120^^^
121
122* Fusion avec le site: http://git.auf.org/?p=progfou.git;a=tree;f=gestionmateriel
e7218ccc
PH
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
977660bd
PH
127
128Licence
129-------
130
131Le code source et la documentation sous Copyright ©2014 AUF.
132Le code est sous Licence AGPL3. Voir le fichier LICENCE
133