Cette page concerne :le service Mobilizon

copiée depuis la doc de joinmobilizon.org https://docs.joinmobilizon.org/administration/

Mobilizon est installée sur la VM biliz.cluster.chapril.org

L'installation de production de Docker est maintenant en statut alpha. Voir Docker. Pré-requis

  Une machine Linux avec accès à la racine
  Un nom de domaine (ou sous-domaine) pour le serveur Mobilizon, par exemple votre-domaine-mobilizon.com
  Un serveur SMTP pour l'envoi de courriers électroniques

Mobilizon nécessite entre autres Elixir, NodeJS et PostgreSQL. Préférez installer Elixir et NodeJS à partir de leurs dépôts officiels plutôt que les paquets de votre distribution.

Versions recommandées :

  Elixir 1.8 et plus
  NodeJS 12+
  PostgreSQL 11+

Configuration

Nous allons utiliser un utilisateur de mobilizon dédié avec /home/mobilizon home :

  sudo adduser --disabled-login mobilizon

Conseil

  sudo pw useradd -n mobilizon -d /home/mobilizon -s /usr/local/bin/bash -m 
  sudo passwd mobilizon

Alors connectons-nous en tant qu'utilisateur :

  sudo -i -u mobilizon

Commençons par cloner le dépôt dans un répertoire nommé live :

  git clone https://framagit.org/framasoft/mobilizon live && cd live

Installer les dépendances de l'Elixir

  mix deps.get

= Note =

Lorsqu'on vous demande “Dois-je installer Hex ? ou Dois-je installer Rebar3 ?”, appuyez sur la touche entrée pour confirmer.

Compiler ensuite ces dépendances et Mobilizon (cela peut prendre quelques minutes et peut produire toutes sortes d'avertissements, tels que des problèmes de dépréciation)

  MIX_ENV=prod mix compile

Allez dans le répertoire js/

  cd js

et installer les dépendances Javascript

  yarn install

Enfin, nous pouvons construire le frontal (cela peut prendre quelques secondes).

  NODE_BUILD_MEMORY=1024

  NODE_BUILD_MEMORY=1024 yarn build

Revenons au répertoire principal

  cd ../

Mobilizon fournit un outil en ligne de commande pour générer la configuration

  MIX_ENV=prod mix mobilizon.instance gen

Vous devrez alors répondre à des questions sur votre configuration et votre instance pour générer un fichier prod.secret.exs dans le dossier config/, et un fichier setup_db.psql pour configurer la base de données. Configuration de la base de données

Le fichier setup_db.psql contient des instructions SQL pour créer un utilisateur et une base de données PostgreSQL avec les informations d'identification choisies et ajouter les extensions requises à la base de données Mobilizon.

Quittez l'exécution en tant qu'utilisateur mobilizon (car il ne devrait pas avoir les droits root/sudo) et exécutez dans le répertoire /home/mobilizon/live :

  sudo -u postgres psql -f setup_db.psql

Il devrait produire quelque chose du genre :

CRÉER UN RÔLE CRÉER UNE BASE DE DONNÉES Vous êtes maintenant connecté à la base de données “mobilizon_prod” en tant qu'utilisateur “postgres”. CRÉER L'EXTENSION CRÉER UNE EXTENSION CRÉER UNE EXTENSION

Revenons à notre utilisateur de mobilizon :

  sudo -i -u mobilizon
  cd en direct

Effectuer des migrations de bases de données :

  MIX_ENV=prod mix ecto.migrate

Note

Notez le préfixe de la variable d'environnement MIX_ENV=prod devant la commande. Vous devrez l'utiliser pour chaque commande de mixage à partir de maintenant.

Vous devrez le refaire après la plupart des mises à jour.

Conseil

Si certaines migrations échouent, cela signifie probablement que vous n'utilisez pas une version suffisamment récente de PostgreSQL, ou que vous n'avez pas installé les extensions requises. Services

Nous pouvons arrêter d'utiliser l'utilisateur de mobilizon à nouveau. Systemd

Copiez le fichier support/systemd/mobilizon.service dans /etc/systemd/system.

sudo cp support/systemd/mobilizon.service /etc/systemd/system/

Rechargez Systemd pour détecter votre nouveau dossier

sudo systemctl daemon-reload

Et permettre au service

sudo systemctl enable –now mobilizon.service

Il fera fonctionner Mobilizon et permettra le démarrage au démarrage. Vous pouvez suivre les logs avec

sudo journalctl -fu mobilizon.service

Vous devriez voir quelque chose comme ça :

Exécution de Mobilizon.Web.Endpoint avec cowboy 2.8.0 à :::4000 (http) Accédez à Mobilizon.Web.Endpoint à l'adresse https://your-mobilizon-domain.com

Le serveur Mobilizon fonctionne sur le port 4000 sur l'interface locale uniquement, vous devez donc ajouter un reverse-proxy. Reverse proxy Nginx

Copiez le fichier de support/nginx/mobilizon.conf vers /etc/nginx/sites-available.

sudo cp support/nginx/mobilizon.conf /etc/nginx/sites-available

Ensuite, établissez un lien symbolique avec le fichier dans le répertoire /etc/nginx/sites-enabled.

sudo ln -s /etc/nginx/sites-available/mobilizon.conf /etc/nginx/sites-enabled/

Editez le fichier /etc/nginx/sites-available/mobilizon.conf et adaptez-le à votre propre configuration.

Tester la configuration avec sudo nginx -t et recharger nginx avec sudo systemctl reload nginx. Cryptons

Le modèle de configuration nginx gère le défi HTTP-01 avec le plugin webroot :

sudo mkdir /var/www/certbot

Exécutez certbot avec (n'oubliez pas d'adapter la commande)

sudo certbot certonly –rsa-key-size 4096 –webroot -w /var/www/certbot/ –email your@email.com –agree-tos –text –renew-hook “/usr/sbin/nginx -s reload” -d your-mobilizon-domain.com

Adaptez ensuite la configuration nginx /etc/nginx/sites-available/mobilizon.conf en décommentant les chemins des certificats et en supprimant les blocs obsolètes.

Terminez en testant la configuration avec sudo nginx -t et en rechargeant nginx avec sudo systemctl reload nginx.

Vous devriez maintenant être en mesure de charger https://your-mobilizon-domain.com dans votre navigateur. Création de votre premier utilisateur

Connectez-vous à nouveau en tant qu'utilisateur du système de mobilisation :

sudo -i -u mobilizon cd en direct

Créer un nouvel utilisateur :

MIX_ENV=prod mix mobilizon.users.new “your@email.com” –admin –password “Y0urP4ssw0rd”

Danger

N'oubliez pas de préfixer la commande par un espace vide afin que le mot de passe choisi ne soit pas conservé dans l'historique de votre shell.

Conseil

Vous pouvez ignorer l'option –password et Mobilizon en générera un pour vous.

Voir la documentation complète pour cette commande.

Vous pouvez maintenant vous connecter avec vos identifiants et découvrir Mobilizon. N'hésitez pas à consulter également la documentation de configuration. Tâches suggérées Configurer les courriels

La configuration par défaut de Mobilizon suppose qu'un serveur SMTP local est disponible sur le même serveur. Pour adapter cette configuration à votre propre configuration, consultez cette page. Configurer l'authentification tierce

Mobilizon peut utiliser les fournisseurs de connexion basés sur LDAP ou OAuth (Facebook, Google, etc.) pour aider à l'enregistrement ou à la connexion des utilisateurs. La configuration peut être trouvée ici. Configurer les géocodeurs

Cela permettra au champ de saisie automatique des adresses de fournir des adresses lors de la modification d'un événement. La valeur par défaut utilise le fournisseur Nominatim d'OpenStreetMap mais vous pouvez la changer pour le fournisseur de votre choix.

Note :

Lorsque vous utilisez le fournisseur Nominatim par défaut d'OpenStreetMap, l'autocomplétion est désactivée et l'utilisation du service implique que vous acceptez leur politique d'utilisation. Bases de données de géolocalisation

Mobilizon peut utiliser la géolocalisation à partir de données au format MMDB provenant de sources telles que les bases de données MaxMind GeoIP ou db-ip.com. Cela permet de montrer les événements se déroulant à proximité de l'endroit où se trouve l'utilisateur.

Vous devrez télécharger la base de données City et la placer dans priv/data/GeoLite2-City.mmdb. Terminez en redémarrant le service de mobilisation.

Mobilizon n'affichera un avertissement au démarrage que si la base de données est manquante, mais ce n'est pas obligatoire.

(fin de la section installation)