Commit 5ba9dd33 authored by chris's avatar chris

Add basic documentation

parent 2c54bb8f
dpconfig
========
* [Apperçu](#user-content-apperçu)
* [Fonctionnement](#user-content-fonctionnement)
* [Développement](#user-content-développement)
* [Tests](#user-content-tests)
* [Versions](#user-content-versions)
<h2 id="ap">Apperçu</h2>
Ce dépot contient le site web de Domaine Public.
<h2 id="fo">Fonctionnement</h2>
Le site utilise la dernière version de Spip avec des squelettes propre.
<h2 id="de">Développement</h2>
Nous fournissions un fichier *vagrant*. La commande `vagrant up` lance une
machine virtuelle avec apache, mysql et spip, et essaie d'importer la base de
donnée. Note: vous pouvez copier un *dump* de la base-de-donnée via:
scp ginger.domainepublic.net:/srv/domainepublic.sql .
Vous pouvez ensuite travailler en local. Le port HTTP de la machine virtuelle est redirigé vers:
http://localhost:8000
Pour tester ou modifier le site, vous pouvez cloner le projet:
git clone git@gitlab.domainepublic.net:domainepublic/www.domainepublic.net.git
Afin de pousserr vos modifications, demande au dépot via gitlab.
<h3 id="te">Tests</h3>
Nous recommandons l'utilisation de *vagrant* pour tester les changements.
(Par défaut *Vagrant* travaille avec *virtualbox*, pour si utiliser *KVM* ou
*Xen*, il suffit d'installer le paquet *vagrant-libvirt*)
Avant de pousser une modification en production veuillez la tester dans une
machine virtuelle. Pour démarrer une machine virtuelle et y appliquer la
configuration du dossier courrant, exécuter:
vagrant up
(note: la première fois que cette commande est invoquée, une image de debian de
300Mo est téléchargée)
Pour appliquer des modifications de configuration avec une machine déjà *up*:
vagrant provision
Pour se connecter à la machine:
vagrant ssh
De là on peut renommer le serveur de test pour tester des configurations
particulières, par exemple:
hostname alternz.domainepublic.net
dpconfig run
Plus d'info sur la documentation officielle de [vagrant](https://www.vagrantup.com/docs/)
<h2 id="ve">Versions</h2>
07/03/2017:
* installation de git, etckeeper et puppet (via les backports dans le cas de wheezy)
* configuration des utilisateurs, de leurs clés, des groupes *adm* et *sudo*
* configuration des services apt, cron, motd, ssh, sudo
* envoi des erreurs système à la liste maintenance@
* plusieurs tâches cron particulières
* vérification des droits d'écriture sur /tmp
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment