creation de la documentation
[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.
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 la commande suivante::
15
16   apt-get install python-virtualenv python-pip python-sqlite
17
18
19 Installation
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
31 Vous devez ensuite modifier le fichier `maj.yml` selon vos besoins.
32
33 Utilisation
34 -----------
35
36 Pour 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
44 Pour utiliser l'interface web vous devez d'abord vous autentifier:
45
46   http://localhost:8000/sandbox/login
47
48 puis visiter la page suivante:
49
50   http://localhost:8000/maj/machine/
51
52 Ligne de commande
53 ^^^^^^^^^^^^^^^^^
54
55 Il est aussi possible d'utiliser la ligne de commande pour certaines tâches comme:
56
57 Collecter le nombre de paquets à mettre à jour sur l'ensemble des machines::
58
59   bin/python manage.py get
60
61 Aides et supports
62 -----------------
63
64   patrick.hetu (a) auf.org
65
66 Amé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
79 Licence
80 -------
81
82 Le code source et la documentation sous Copyright ©2014 AUF.
83 Le code est sous Licence AGPL3. Voir le fichier LICENCE
84