====== Gérer le serveur Matrix ======

Matrix est hébergé sur Cordiale.
Il est géré par le script ansible de spantaleev, disponible sur github : [[https://github.com/spantaleev/matrix-docker-ansible-deploy|matrix-docker-ansible-deploy]].

Nous avons un dépot sur gitlab qui contient un fichier inventory/hosts dédié pour le cas de faimaison. Aussi le fichier de configuration est également inclus dans le dépot de faimaison pour l'adapter à notre context.
Cas spécifique pour la sécurité, les mots de passes ne sont pas enregistré en clair dans le vars.yml. Keyringer est utilisé pour récupérer ces mots de passes

===== Pré-requis =====

  * Keyringer
  * ansible
  * git


==== Keyring : tester  ====

vérifier que les commandes suivante vous retourne bien un mot de passe :


  keyringer fma-machines decrypt matrix/postgresql 2> /dev/null
  keyringer fma-machines decrypt matrix/homeserver_generic 2> /dev/null
  
==== git config : pull/push ====

La particularité ici c'est que le projet vis sa vis sur github, mais nous suivons quelques fichiers de configuration qui nous sont propre et qu'on pousse sur notre gitlab. Il faut donc s'assurer que le fichier **.git/config** soit bien configuré :

<file>
[core]
	repositoryformatversion = 0
	filemode = true
	bare = false
	logallrefupdates = true
[remote "origin"]
	url = https://github.com/spantaleev/matrix-docker-ansible-deploy
	fetch = +refs/heads/*:refs/remotes/origin/*
[branch "master"]
	remote = origin
	merge = refs/heads/master
[remote "gitlab"]
	url = git@git.faimaison.net:faimaison-adminsys/matrix-docker-ansible-deploy.git
	fetch = +refs/heads/*:refs/remotes/gitlab/*
[pull]
	rebase = false''
</file>
De cette façon chaque pull se feront de github et chaque push se feront sur le gitlab. Il y a deux remote : origin et gitlab


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

2 étapes à faire : 

1. faire un git pull
2. vérifier le changelog : CHANGELOG.md, ce point est très important car il peut y avoir des changement structurant pour ce qu'on fait
3. lancer le playbook

Pour la mise à jour la commande à lancer avec les tags qui vont bien :

<code>
ansible-playbook -i inventory/hosts setup.yml --tags=setup-all,ensure-matrix-users-created,start -K -u <username>
</code>

<username> : adapter en fonction de votre nom d'utilisateur