Merge branch 'master' into 'master'

Màj doc pour installation en production (première partie) (Master)

See merge request !14
This commit is contained in:
echarp 2017-03-28 10:33:04 +02:00
commit ba2f0eaf9f

View File

@ -15,6 +15,7 @@ Il existe aussi des projets équivalents
https://git.framasoft.org/agenda-libre/agenda-libre-php
https://bitbucket.org/mlhamel/agendadulibre
=== Prérequis
Exemple d'installation pour Debian:
@ -23,11 +24,19 @@ Exemple d'installation pour Debian:
~ $ apt-get install ruby ruby-dev bundler
}}}
Dans le cas d'une installation en mode production, dans un environnement comme
Debian stable Jessie, il faut ajouter les dépôt {{{jessie-updates}}} et
{{{jessie-backports}}} pour obtenir une version récente de {{{bundler}}}.
Il faut de plus installer les paquets {{{zlib1g-dev}}} et {{{libsqlite3-dev}}}
ou {{{libmysqlclient-dev}}}.
=== Code source
Pour installer l'Agenda du libre, vous devrez récupérer le code source à l'aide
de "git", puis installer les dépendances avec "bundler" (bundler est packagé
sous debian, mais peut aussi s'installer depuis http://bundler.io, une version
dans Debian, mais peut aussi s'installer depuis http://bundler.io, une version
récente de préférence).
Par exemple:
@ -37,21 +46,24 @@ Par exemple:
~ $ bundle install --path vendor/bundle --without production
}}}
Dans le cas d'une installation en mode production, on utilisera plutôt
`--without test`.
=== Base de données
La base de données peut être "sqlite3", "postgresql" ou "mysql". Par défaut
sqlite3 est configurée, mais vous pouvez la modifier dans le fichier
`config/database.yml`.
Sous un environnement comme debian, il faut aussi les paquets "build-essential"
et "libsqlite3-dev" (ou "libmysqlclient-dev").
Mettez en place le schéma comme ceci:
{{{
~ $ bundle exec rake db:setup
}}}
=== Lancement
==== En développement
Puis lancez rails (avec tests et vérifications de sécurité):
{{{
@ -64,6 +76,16 @@ http://localhost:3000
Votre premier modérateur admin est identifié par "admin@example.com", son mot de
passe étant "password".
==== En production
/!\ section en travaux, ça commence par :
{{{
~ # apt install libapache2-mod-passenger
}}}
=== Aide mémoire
Commande à utiliser en console rails pour créer plusieurs événements: