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