Merge pull request #3 from alexAubin/master

Update/improve documentation
This commit is contained in:
Laurent Peuch 2016-11-29 00:57:32 +01:00 committed by GitHub
commit 5b233105b9

View file

@ -11,21 +11,54 @@ git clone https://github.com/YunoHost/dynette
Web subscribe server deployment Web subscribe server deployment
------------------------------- -------------------------------
Install required stuff
``` ```
apt-get install postgresql ruby thin libpq-dev bundler apache2 $ apt-get install postgresql postgresql-server-dev-9.4 ruby thin libpq-dev bundler apache2 bind9 python
``` ```
In dynette repository: Prepare user dynette
``` ```
bundle install $ useradd dynette
$ passwd dynette
$ mkdir /home/dynette
$ chown -R dynette:dynette /home/dynette
``` ```
Thin configuration: Prepare PostgreSQL database
``` ```
thin config -C /etc/thin1.9.1/dynette.yml -c /path/to/dynette/ --servers 3 -p 5000 -e production $ su - postgres
$ psql template1
template1=# CREATE USER dynette WITH PASSWORD 'verySecurePassword';
template1=# CREATE DATABASE dynette;
template1=# GRANT ALL PRIVILEGES ON DATABASE dynette to dynette;
template1=# \q
``` ```
Apache configuration: Install dynette
```
$ cd /home/dynette
$ git clone https://github.com/YunoHost/dynette
$ cd dynette
$ bundle install
```
Edit dynette.rb, change PostgreSQL password and domains handled, line 11-12:
```
DataMapper.setup(:default, ENV['DATABASE_URL'] || "postgres://dynette:myPassword@localhost/dynette")
DOMAINS = ["nohost.me", "noho.st"]
```
Configure and launch thin
```
thin config -C /etc/thin2.1/dynette.yml -c /home/dynette/dynette/ --servers 3 -p 5000 -e production
service thin restart
```
Apache configuration
--------------------
``` ```
vim /etc/apache2/sites-available/dynette vim /etc/apache2/sites-available/dynette
``` ```
@ -63,43 +96,21 @@ Paste & change server name in below configuration:
</VirtualHost> </VirtualHost>
``` ```
PostgreSQL configuration:
```
# adduser dynette
# passwd dynette
# su - postgres
$ psql template1
template1=# CREATE USER dynette WITH PASSWORD 'myPassword';
template1=# CREATE DATABASE dynette;
template1=# GRANT ALL PRIVILEGES ON DATABASE dynette to dynette;
template1=# \q
```
Edit dynette.rb, change PostgreSQL password and domains handled, line 11-12:
```
DataMapper.setup(:default, ENV['DATABASE_URL'] || "postgres://dynette:myPassword@localhost/dynette")
DOMAINS = ["nohost.me", "noho.st"]
```
Enable apache2 sites & modules: Enable apache2 sites & modules:
``` ```
a2enmod proxy a2enmod proxy
a2enmod rewrite a2enmod rewrite
a2ensite dynette a2ensite dynette
service thin start
service apache2 restart service apache2 restart
``` ```
DNS configuration Cron job configuration
----------------- ----------------------
```
apt-get install bind9 python
```
Edit dynette.cron.py and change settings: Edit dynette.cron.py and change settings:
``` ```
# If you want to simply do test in local, use "http://127.0.0.1:5000/"
subs_urls = ['https://dyndns.yunohost.org'] subs_urls = ['https://dyndns.yunohost.org']
ns0 = 'ns0.yunohost.org' ns0 = 'ns0.yunohost.org'
ns1 = 'ns1.yunohost.org' ns1 = 'ns1.yunohost.org'
@ -119,7 +130,10 @@ Enable cronjob for dynette (crontab -e)
``` ```
* * * * * /path/to/dynette/dynette.cron.py >> /var/log/dynette.log 2>&1 * * * * * /path/to/dynette/dynette.cron.py >> /var/log/dynette.log 2>&1
``` ```
Test it's working
-----------------
`wget -q -O - http://127.0.0.1:5000/test/someDomain.nohost.me`
Troobleshooting Troobleshooting
--------------- ---------------