creation de la documentation
[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.
5Notez que ce site est en version Beta.
6
7.. image:: machines.png
8
9.. contents:: Table des matières
10
11Dépendances
12-----------
13
14Veuillez installer les dépendances avec la commande suivante::
15
16 apt-get install python-virtualenv python-pip python-sqlite
17
18
19Installation
20------------
21
22::
23
24 virtualenv .
25 source bin/activate
26 pip install -r requirements.txt
27 ./manage.py syncdb
28 ./manage.py migrate
29 ./manage.py createsuperuser
30
31Vous devez ensuite modifier le fichier `maj.yml` selon vos besoins.
32
33Utilisation
34-----------
35
36Pour démarrer le service Django utilisé la commande::
37
38 bin/python manage.py runserver
39
40.. Pour démarrer le service Celery utilisé la commande suivante::
41..
42.. bin/python -O manage.py celery worker
43
44Pour utiliser l'interface web vous devez d'abord vous autentifier:
45
46 http://localhost:8000/sandbox/login
47
48puis visiter la page suivante:
49
50 http://localhost:8000/maj/machine/
51
52Ligne de commande
53^^^^^^^^^^^^^^^^^
54
55Il est aussi possible d'utiliser la ligne de commande pour certaines tâches comme:
56
57Collecter le nombre de paquets à mettre à jour sur l'ensemble des machines::
58
59 bin/python manage.py get
60
61Aides et supports
62-----------------
63
64 patrick.hetu (a) auf.org
65
66Améliorations possibles
67-----------------------
68
69* Fusion avec le site: http://git.auf.org/?p=progfou.git;a=tree;f=gestionmateriel
70* Serveur API REST: http://docs.celeryproject.org/en/latest/userguide/remote-tasks.html
71* Démarrage des machines à l'aide de la commande `wakeonlan`
72* Sauvegarde des traces de l'exécution (logs)
73* Sommaire de la mise-à-jour par courriel
74* Gestion de la configuration de SSH (clés, config, etc)
75* Interface utilisateur améliorée
76* Tâches planifiées (cron)
77* Tests unitaires et d'intégration
78
79Licence
80-------
81
82Le code source et la documentation sous Copyright ©2014 AUF.
83Le code est sous Licence AGPL3. Voir le fichier LICENCE
84