ports:web:diaspora [Diablotins]

Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
<jumbotron>
====== Papoter sur Diaspora ======

[[https://diasporafoundation.org/|Diaspora]]  est un service de réseau social décentralisé.

Cet article va vous décrire l'installation d'un [[https://diaspora.lapinbilly.eu/stream|serveur Diaspora]], dans une [[jails:zfs|jail]].
</jumbotron>

Vous devez vous préparer à fournir les [[https://www.freebsd.org/doc/handbook/ports.html|ports]] suivants:

  - un serveur web, ici [[ports:nginx|nginx]];
  - un mécanisme pour fournir des clefs pour https, ici [[https://www.freshports.org/security/py-certbot-nginx|py-certbot-nginx]];
  - Ainsi qu'un serveur de base de données [[https://www.postgresql.org/|PostgreSQL]], installée dans une [[ports:db:postgresql|jail]] en <label>192.168.0.10</label>, pour cet exemple.

===== La jail =====

Préparez une [[jails:zfs|jail]] nommée ''diaspora'', dans le répertoire ''/jails/diaspora'' avec les paramètres suivants:

<file javascript /etc/jail.conf>
matrix {
	ip4.addr = "lo1|192.168.0.13";          # IP address of the jail
        mount.devfs;  				# /dev/random pour SSL
	path ="/jails/diaspora";                  # Path to the jail
	exec.start = "/bin/sh /etc/rc";         # Start command
	exec.stop = "/bin/sh /etc/rc.shutdown"; # Stop command
	depend=pg; # depend on postgresql jail
}
</file>

Adaptez la configuration de la //jail// ''diapora'':

<file ini matrix/etc/rc.conf.local>
hostname="diaspora.lapinbilly.eu"
</file>

<callout type="warning" icon="true">
Un serveur diaspora va vouloir [[https://diablotins.lapinbilly.eu/doku.php?id=jails:zfs#mail|envoyer des mails]]. Un hostname(1) en FQDN est obligatoire.
</callout>

On assure le démarrage au reboot:
<code bash>
root@popeye:# sysrc jail_enable="YES"
root@popeye:# sysrc jail_list+="diaspora"
</code>

===== La base de données =====

Préparez votre base de donnée pour Diaspora.
Dans cet exemple, le serveur est confiné dans une //jail// nommée ''pg''.

Créer un utilisateur, <label>diaspora</label>, qui a le droits de créer des bases:
<code bash>
root@pg:/ # su - postgres
$ createuser -P -d diaspora
Enter password for new role: 
Enter it again: 
</code>

Restreindre l'accès au serveur de base de données à cet utilisateur, pour les demandes venant de la //jail// ''diaspora'' en <label>192.168.0.13</label>.
<file bash /jails/pg/var/db/postgres/data11/pg_hba.conf>
host    all				diaspora        192.168.0.13/32            password
</file>

===== Le serveur web =====

Créez une entrée DNS, ici ''diaspora.lapinbilly.eu'', pour votre serveur et rediriger le tout vers la //jail// ''diaspora''.

Obtenez un certificat **SSL**.
<code bash>
root@popeye:/jails# certbot certonly --nginx -d diaspora.lapinbilly.eu
</code>

Rediriger les requêtes vers votre //jail//, pour cela, on va définir un fichier dédié pour //nginx//.

<file javascript /usr/local/etc/nginx/diaspora.conf>
server {
    root  /jails/diaspora/usr/home/diaspora/diaspora/public/;
    # Configure maximum picture size
    # Note that Diaspora has a client side check set at 4M
    client_max_body_size 5M;
    client_body_buffer_size 256K;
    ssl_certificate /usr/local/etc/letsencrypt/live/diaspora.lapinbilly.eu/fullchain.pem;
    ssl_certificate_key /usr/local/etc/letsencrypt/live/diaspora.lapinbilly.eu/privkey.pem;

    # Proxy if requested file not found
    try_files $uri @diaspora;

    location /assets/ {
      expires max;
      add_header Cache-Control public;
    }

    # Camo support
    #location /camo/ {
    #  proxy_redirect off;
    #  proxy_pass http://camo/;
    #  break;
    #}

    location @diaspora {
      proxy_set_header X-Real-IP $remote_addr;
      proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
      proxy_set_header X-Forwarded-Proto https;
      proxy_set_header Host $http_host;
      proxy_redirect off;
      proxy_pass http://diaspora_server;
    }
  }
  upstream diaspora_server {
    server unix:/jails/diaspora/usr/home/diaspora/diaspora/tmp/diaspora.sock;
  }
</file>

Et l'utiliser dans nos [[:ports:nginx#serveur|serveurs nginx]]

<file javascript /usr/local/etc/nginx/nginx.conf>
   server {
            listen 443 ssl http2 ;
            listen [::]:443 ssl http2 ;
            server_name diaspora.lapinbilly.eu;
            include diaspora.conf;
    }
</file>

===== Installer =====

Installez les ports suivants dans la //jail// ''diaspora'':
<code bash>
root@popeye:# pkg -j diaspora graphics/ImageMagick7-nox11 databases/redis lang/ruby27 sysutils/rubygem-bundler www/node databases/rubygem-pg devel/git textproc/libsass devel/gmake
root@popeye:# sysrc -j  diaspora redis_enable="YES"
</code>

Attention à préciser la version de ruby à utiliser dans votre ''Make.conf'' ou dans vos [[::ports:poudriere]]s.
<code=bash>
DEFAULT_VERSIONS+=ruby=2.7
</code>

Construisez le  serveur:
<code bash>
root@popeye:# jail -c diaspora
root@popeye:# service -j diaspora service redis start
root@popeye:# jexec disapora
</code>

Préparer l'environnement 'gem/ruby':
<code bash>
root@diaspora:# gem install certified
root@diaspora:# certified-update
root@diaspora:# gem install bundler
root@diaspora:# gem install rake -v '12.3.3'
</code>

Ajoutez un utilisateur ''diaspora'':
<code bash>
root@diaspora:# pw useradd diaspora -c "Diaspora user"
root@diaspora:# echo "setenv RAILS_ENV production" >> ~diaspora/.cshrc
root@diaspora:# echo "setenv DB postgresql" >> ~diaspora/.cshrc
root@diaspora:# su - diaspora
</code>

Les deux dernières vont vous éviter bien des ennuis, elles précisent deux paramètres de base utilisé par tous les scripts:
  * l'environnement du serveur, ici production par opposition à développement;
  * la base de donnée utilisée.

<callout type="warning" icon="true">
Attention, ceux sont des instructions pour un //shell// ''csh/tcsh''. Utilisez celles qui conviennent à votre //shell//.
</callout>

Et allons-y pour l'installation du produit proprement dit, à partir des sources:
<code bash>
diaspora@diaspora:~ % git clone -b master https://github.com/diaspora/diaspora.git
diaspora@diaspora:~ % cd diaspora/
diaspora@diaspora:~/diaspora % cp config/diaspora.yml.example config/diaspora.yml
diaspora@diaspora:~/diaspora % cp config/database.yml.example config/database.yml
diaspora@diaspora:~/diaspora % script/configure_bundler
diaspora@diaspora:~/diaspora % bundle install --without test development --path vendor/bundle
diaspora@diaspora:~/diaspora % bundle update --bundler
diaspora@diaspora:~/diaspora % bundle exec rake db:create db:migrate
diaspora@diaspora:~/diaspora % bin/rake assets:precompile

</code>

==== Configurer ====

Adaptez le serveur à la //jail// et au serveur de base de données, 
c'est à dire permettre au serveur **diaspora** d'écouter les requêtes venant de l'hôte et lui indiquer le chemin vers le serveur **PostgreSQL**.

Deux fichiers de configuration sont importants à copier depuis les exemples du répertoire ''config'':

  - ''database.yml'', pour définir les accès à la base de donnée ;
  - ''diapora.yml'', pour tout le reste.

Dirigez la connexion vers votre base de données:
<file diff config/database.yml>
--- config/database.yml.example 2020-05-02 21:28:46.158354000 +0200
+++ config/database.yml 2020-05-02 21:34:04.844275000 +0200
@@ -1,9 +1,9 @@
 postgresql: &postgresql
   adapter: postgresql
-  host: "localhost"
+  host: "192.168.0.10"
   port: 5432
-  username: "postgres"
-  password: ""
+  username: "diaspora"
+  password: "pwd"
   encoding: unicode
 
 mysql: &mysql

</file>

Dans le fichier ''diaspora'', effectuez les réglages suivants:

  - Adresser les certificats 
  - Réglez le serveur d'envoi de mail,  ici le ''sendmail'' de la base.
  - Donnez un nom de serveur .

<file diff config/diaspora.yml>
--- config/diaspora.yml.example 2020-05-02 21:28:46.158783000 +0200
+++ config/diaspora.yml 2020-05-04 00:00:32.367677000 +0200
@@ -36,7 +36,7 @@
     ## However changing http to https is okay and has no consequences.
     ## If you do change the URL, you will have to start again as the URL
     ## will be hardcoded into the database.
-    #url: "https://example.org/"
+    url: "https://diaspora.lapinbilly.eu/"
 
     ## Set the bundle of certificate authorities (CA) certificates.
     ## This is specific to your operating system.
@@ -44,7 +44,7 @@
     ## For Debian, Ubuntu, Archlinux, Gentoo (package ca-certificates):
     #certificate_authorities: '/etc/ssl/certs/ca-certificates.crt'
     ## For CentOS, Fedora:
-    #certificate_authorities: '/etc/pki/tls/certs/ca-bundle.crt'
+    certificate_authorities: '/usr/local/share/certs/ca-root-nss.crt'
 
     ## URL for a remote Redis (default=localhost).
     ## Don't forget to restrict IP access if you uncomment these!
@@ -175,7 +175,7 @@
     ## Where the appserver should listen to (default=unix:tmp/diaspora.sock)
     #listen: 'unix:tmp/diaspora.sock'
     #listen: 'unix:/run/diaspora/diaspora.sock'
-    #listen: '127.0.0.1:3000'
+    #listen: '192.168.0.15:3000'
 
     ## Set the path for the PID file of the unicorn master process (default=tmp/pids/web.pid)
     #pid: 'tmp/pids/web.pid'
@@ -609,14 +609,14 @@
   mail: ## Section
 
     ## First you need to enable it.
-    #enable: true
+    enable: true
 
     ## Sender address used in mail sent by Diaspora.
-    #sender_address: 'no-reply@example.org'
+    sender_address: 'no-reply@lapinbilly.eu'
 
     ## This selects which mailer should be used. Use 'smtp' for a smtp
     ## connection or 'sendmail' to use the sendmail binary.
-    #method: 'smtp'
+    method: 'sendmail'
 
     ## Ignore if method isn't 'smtp'.
     smtp: ## Section
@@ -653,7 +653,7 @@
     sendmail: ## Section
 
       ## The path to the sendmail binary (default='/usr/sbin/sendmail')
-      #location: '/usr/sbin/sendmail'
+      location: '/usr/sbin/sendmail'
 
       ## Use exim and sendmail (default=false)
       #exim_fix: false
@@ -665,10 +665,10 @@
     ## This doesn't make the user an admin but is used when a generic
     ## admin contact is needed, much like the postmaster role in mail
     ## systems. Set only the username, NOT the full ID.
-    #account: "podmaster"
+    account: "podmaster"
 
     ## E-mail address to contact the administrator.
-    #podmin_email: 'podmin@example.org'
+    podmin_email: 'david@lapinbilly.eu'
 
   ## Settings related to relays
   relay: ## Section
</file>

=== Journaux ===

Pour éviter de surcharger vos disques de logs, configurez newsyslog(8)

<file shell /etc/newsyslog.conf.d/diaspora.conf>
/usr/home/diaspora/diaspora/log/eye_process*.log                  640 7     1000 *     NJ
</file>

Et, si vous utilisez ''redis'':
<file shell /etc/newsyslog.conf.d/redis.conf>
/var/log/redis/*.log                  600 7     1000 *     J /var/run/redis/redis.pid
</file>


===== Démarrer =====

Lancez simplement:

<code bash>
diaspora@diaspora:~/diaspora % ./script/server
</code>

Redémarrez votre serveur web avec la nouvelle configuration:
<code bash>
root@popeye:# service nginx restart
</code>

Connectez vous sur le site et ajoutez un utilisateur. Déclarez le ensuite comme un administrateur à l'aide de son //adresse mail//.

<code bash>
root@popeye:# jexec diaspora
root@diaspora:# su - diaspora
diaspora@diaspora:~ cd diaspora
diaspora@diaspora:~ bundle exec rails console
Role.add_admin User.where(email: "the_email").first.person
</code>

===== Mettre à jour =====

Pour évitez une interruption du service trop longue, préparez la mise à jour dans une autre [[https://wiki.fug-fr.org/doku.php?id=jails:zfs#multiplier |jail]].
Cloner votre //jail// courante et mettez à jour tout le système.


Suivez les [[https://wiki.diasporafoundation.org/Updating#Updating_a_production_install_to_a_new_minor_version|instructions]], sans tenir compte des variables d'environnement ''RAILS_ENV'' qui sont déjà activées dans ce système.


Lancez les opérations jusqu'à la migration de la base de données.Les appels à ''gem'' doivent se faire sous ''root''.

Coupez le service de la //jail// de production et dupliquez la base de donnée du [[ports:db:postgresql#tests|serveur SQL]]:

<code plsql>
CREATE DATABASE diaspora_prodold
WITH TEMPLATE diaspora_production
OWNER diaspora;
</code>

Modifiez le nom base de données de production du fichier ''config/database.yml'' en ''diaspora_prodold'' et relancez le service.

Dans la nouvelle //jail//, terminez la mise à jour.
Si tout s'est bien passé, routez la configuration [[ports:nginx]] vers la nouvelle //jail//.

Stoppez l'ancien service, démarrez le nouveau et relancer le serveur web.