Haute disponiblité¶
Ce chapitre présente des moyens permettant d’ajouter de la redondance en vue de garantir la disponibilité d’une installation de Publik. La charge des opérations est dès lors répartie sur plusieurs machines; et le service est maintenu en cas de panne d’un des composants.
Pré-requis¶
Se référer aux pré-requis généraux, avec les différences suivantes:
- 2 machines hôtes identiques (ici nommées web1 et web2) disposant des
ressources suivantes:
- CPU 8 cœurs
- 32Go de mémoire vive
- 100Go d’espace disque
- Debian 11 (« bullseye ») installé en architecture amd64 (installation minimale)
- un service frontal HAProxy (géré par le client)
- un service de base de données PostgreSQL disposant de 200Go d’espace (cluster géré par le client)
- un service de partage de fichiers NFS disposant de 200Go d’espace (cluster géré par le client)
Installation des composants¶
Création des utilisateurs avec UID identiques sur web1 et web2¶
Lors de partage de fichiers sur un réseau (NFS par exemple), il faut que les UID des utilisateurs Unix concernés soient les mêmes sur les deux machines web1 et web2.
Nous fournissons un script pour faire cela :
publik-create-users
Alternativement vous pouvez utiliser :
#!/bin/sh
uid=2102
for user in hobo authentic-multitenant wcs passerelle combo fargo chrono bijoe
do
echo "create group $user ($uid)"
addgroup --system --gid $uid $user
echo "create user $user ($uid)"
adduser --disabled-password --system --uid $uid --gecos "$user daemon" --ingroup $user --no-create-home --home /var/lib/$user $user
uid=$(($uid+1))
done
Résultat dans /etc/passwd:
hobo:x:2102:2102:hobo daemon,,,:/var/lib/hobo:/bin/false
authentic-multitenant:x:2103:2103:authentic2-multitenant daemon,,,:/var/lib/authentic2-multitenant:/bin/false
wcs:x:2104:2104:wcs daemon,,,:/var/lib/wcs:/bin/false
passerelle:x:2105:2105:passerelle daemon,,,:/var/lib/passerelle:/bin/false
combo:x:2106:2106:combo daemon,,,:/var/lib/combo:/bin/false
fargo:x:2107:2107:fargo daemon,,,:/var/lib/fargo:/bin/false
chrono:x:2109:2109:chrono daemon,,,:/var/lib/chrono:/bin/false
bijoe:x:2110:2110:bijoe daemon,,,:/var/lib/bijoe:/bin/false
Vue générale¶
Avant l’installation des modules, il faut pour chacun d’eux (sauf w.c.s.) configurer l’accès au PostgreSQL; par exemple, dans /etc/combo/settings.d/macollectivite.py :
DATABASES['default']['NAME'] = 'combo'
DATABASES['default']['USER'] = 'combo'
DATABASES['default']['PASSWORD'] = 'indiquer-ici-le-mot-de-passe-pour-combo'
DATABASES['default']['HOST'] = 'sql-prod'
DATABASES['default']['PORT'] = '5432'
Suivre ensuite les instructions pour une installation mono-machine. Ensuite déplacer les éléments de configuration vers le partage de fichiers :
- les répertoires de configuration
/etc/xxx
des composants Publik, copiés vers/srv/nfs/publik/etc/xxx,
- les données
/var/lib/xxx
de ces mêmes composants, copiés vers/srv/nfs/publik/var/lib/xxx,
- la configuration nginx ; copiés vers
/srv/nfs/publik/etc/nginx/xxx
et/srv/nfs/publik/var/www/html
.
Sur web1 et web2 nous pointons les fichiers partagés à l’aide de liens symboliques :
- Configuration :
/etc/xxx
→/srv/nfs/publik/etc/xxx,
- Données :
/var/lib/xxx
→/srv/nfs/publik/var/lib/xxx,
- Configuration nginx.
Détail des opérations¶
Création des répertoires partagés :
- Configuration:
/srv/nfs/publik/etc
, - Données des tenants:
/srv/nfs/publik/var/lib/
- Données statiques:
/srv/nfs/publik/var/www/
Déplacement des configurations et données des services Publik:
Service wcs
service wcs stop mv /etc/wcs /srv/nfs/publik/etc/ ln -sf /srv/nfs/publik/etc/wcs /etc/wcs mv /var/lib/wcs /srv/nfs/publik/var/lib/ ln -sf /srv/nfs/publik/var/lib/wcs /var/lib/wcs service wcs start
Service combo
service combo stop mv /etc/combo /srv/nfs/publik/etc/ ln -sf /srv/nfs/publik/etc/combo /etc/combo mv /var/lib/combo /srv/nfs/publik/var/lib/ ln -sf /srv/nfs/publik/var/lib/combo /var/lib/combo service combo start
Même procédure avec fargo
Même procédure avec passerelle
Même procédure avec hobo
Même procédure avec authentic2-multitenant
Configuration hobo-agent
service supervisor stop mv /etc/hobo-agent /srv/nfs/publik/etc/ ln -sf /srv/nfs/publik/etc/hobo-agent /etc service supervisor start
Autres partages via NFS :
Configurations nginx
service nginx stop mkdir /srv/nfs/publik/etc/nginx cd /etc/nginx mv conf.d includes sites-available sites-enabled /srv/nfs/publik/etc/nginx/ ln -sf /srv/nfs/publik/etc/nginx/* . service nginx start
Éléments web statiques
cd /var/www mv html /srv/nfs/publik/var/www/ ln -sf /srv/nfs/publik/var/www/html .
APT : dépôts et préférences backports
mkdir /srv/nfs/publik/etc/apt cd /etc/apt mv sources.list.d preferences.d /srv/nfs/publik/etc/apt/ ln -sf /srv/nfs/publik/etc/apt/* .
Opérations sur web2¶
Attention : l’UID et le GUID de l’utilisateur www-data doit être identique.
Préparer les répertoires de configuration et de données des composants Publik avant leur installation :
Service wcs
ln -sf /srv/nfs/publik/etc/wcs /etc/wcs ln -sf /srv/nfs/publik/var/lib/wcs /var/lib/wcs
Service combo
ln -sf /srv/nfs/publik/etc/combo /etc/combo ln -sf /srv/nfs/publik/var/lib/combo /var/lib/combo
Même procédure avec fargo
Même procédure avec passerelle
Même procédure avec hobo
Même procédure avec authentic2-multitenant
Configuration hobo-agent
ln -sf /srv/nfs/publik/etc/hobo-agent /etc/hobo-agent
Préparer la configuration des autres composants:
Configurations nginx
service nginx stop cd /etc/nginx rm -rf conf.d includes sites-available sites-enabled ln -sf /srv/nfs/publik/etc/nginx/* . service nginx start
Éléments web statiques
cd /var/www rm -rf html ln -sf /srv/nfs/publik/var/www/html .
APT : dépôts et préférences backports
cd /etc/apt rm -rf sources.list.d preferences.d ln -sf /srv/nfs/publik/etc/apt/* .
Lancer l’installation des composants packagés. Attention, lors de cette étape, toujours refuser les éventuelles demandes de modification des fichiers de configuration (on utilise ceux partagés par NFS) :
apt install wcs wcs-au-quotidien
apt install combo
apt install fargo
apt install passerelle
apt install hobo
apt install authentic2-multitenant
apt install hobo-agent
Nous comparons la liste des paquets installés entre web1 et web2 (obtenue avec dpkg -l), et installons les paquets suivants :
- python-combo-plugin-macollectivite,
- publik-base-theme,
- gettext
Désactivation des crons Publik sur web2¶
Il est très important de désactiver les crons de Publik sur web2, pour ne pas avoir de compétition/conflit avec ceux déjà en place sur web1, puisqu’ils agissent sur les mêmes données.
Il faut donc poser des # devant les lignes des crons suivants :
- /etc/cron.d/wcs,
- /etc/cron.d/authentic2-multitenant,
- /etc/cron.d/passerelle,
- /etc/cron.hourly/python-combo,
- /etc/cron.hourly/fargo.
Paramétrage du partage de fichiers¶
Démarrer les services uniquement après le montage de /srv/nfs
Ajouter pour les services liés à Publik un supplément RequiresMountsFor= à la description du service
Exemple pour Combo :
cat /etc/systemd/system/combo.service.d/wait-for-mnt-data.conf
[Unit]
RequiresMountsFor=/srv/nfs
Faire de même avec les services qui ont besoin de /srv/nfs : Combo, Fargo, Passerelle, authentic2-multitenant, hobo, hobo-agent, wcs.