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
1 changed files with 26 additions and 4 deletions

View File

@ -15,6 +15,7 @@ Il existe aussi des projets équivalents
https://git.framasoft.org/agenda-libre/agenda-libre-php https://git.framasoft.org/agenda-libre/agenda-libre-php
https://bitbucket.org/mlhamel/agendadulibre https://bitbucket.org/mlhamel/agendadulibre
=== Prérequis === Prérequis
Exemple d'installation pour Debian: Exemple d'installation pour Debian:
@ -23,11 +24,19 @@ Exemple d'installation pour Debian:
~ $ apt-get install ruby ruby-dev bundler ~ $ 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 === Code source
Pour installer l'Agenda du libre, vous devrez récupérer le code source à l'aide 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é 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). récente de préférence).
Par exemple: Par exemple:
@ -37,21 +46,24 @@ Par exemple:
~ $ bundle install --path vendor/bundle --without production ~ $ 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 === Base de données
La base de données peut être "sqlite3", "postgresql" ou "mysql". Par défaut 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 sqlite3 est configurée, mais vous pouvez la modifier dans le fichier
`config/database.yml`. `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: Mettez en place le schéma comme ceci:
{{{ {{{
~ $ bundle exec rake db:setup ~ $ bundle exec rake db:setup
}}} }}}
=== Lancement === Lancement
==== En développement
Puis lancez rails (avec tests et vérifications de sécurité): 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 Votre premier modérateur admin est identifié par "admin@example.com", son mot de
passe étant "password". passe étant "password".
==== En production
/!\ section en travaux, ça commence par :
{{{
~ # apt install libapache2-mod-passenger
}}}
=== Aide mémoire === Aide mémoire
Commande à utiliser en console rails pour créer plusieurs événements: Commande à utiliser en console rails pour créer plusieurs événements: