Projet

Général

Profil

Mastodon » Historique » Version 58

sacha, 04/04/2024 10:34

1 46
# Mastodon
2
3
## Présentation
4
5
Mastodon est un réseau social libre et décentralisé, développé par Eugen Rochko, qui a connu une croissance exponentielle en début avril 2017. Aquilenet a donc mis en place son instance afin de participer et de soutenir la montée en force du projet.
6
7
L'instance Mastodon Aquilenet est installée sur la VM Alcyon qui lui est dédiée et accessible à l'adresse toot.aquilenet.fr
8
9
## Mise à jour
10
11
La mise à jour de Mastodon est assez simple, et se base principalement sur le github officiel =\> https://github.com/tootsuite/mastodon
12
13
Si une nouvelle version stable est disponible (cf https://github.com/tootsuite/mastodon/releases), des mises à jour sont disponible, pusher un toot sur le compte `Aquilenet`toot.aquilenet.fr, pour annoncer une brève coupure des services. Si possible, prévoir de l'avance pour donner une heure de coupure. La mise à jour ne prend généralement que quelques minutes.
14
15 57 sacha
### Activer le mode maintenance
16
17 58 sacha
    cd /etc/nginx/sites-enabled && rm mastodon.conf && ln -s ../sites-available/maintenance.conf maintenance.conf && systemctl reload nginx
18 57 sacha
19
### mise à jour
20
21 46
Ensuite, repasser en root
22
23
    su - monutilisateur
24
    sudo su
25
26
Et stopper les services Mastodon :
27
28 54 loris.hilaire
    systemctl stop mastodon-*.service
29
    NB : mastodon-sidekiq.service n'est plus utilisé, nous utilisons à la place un autre service qui gère mieux Sidekiq & les queues
30 46
31
Repasser sur l'utilisateur mastodon (jongler avec deux terminaux peut faciliter la tâche et éviter ces allers-retours) :
32
33
    su - mastodon
34
    cd live
35
    git fetch
36
    git checkout v[numero-de-version]
37
    bundle install
38
    yarn install
39
    RAILS_ENV=production bundle exec rails db:migrate
40
    RAILS_ENV=production bundle exec rails assets:precompile
41
    exit
42
43
Une version plus complète, qui vérifie les besoins en termes de dépendances, est celle-ci (conseillée) :
44
45
    su - mastodon
46
    cd live
47
    git fetch
48
    git checkout v[numero-de-version]
49
    export RAILS_ENV=production
50
    export NODE_ENV=production
51 56 loris.hilaire
    bundle install
52
    (npm upgrade --global yarn #Peut avoir des problèmes d'accès. Auquel cas le faire en root après un cd /home/mastodon/live.)
53
    yarn install
54 46
    RAILS_ENV=production bundle exec rake assets:clobber
55
    RAILS_ENV=production bundle exec rake assets:precompile
56
    RAILS_ENV=production bundle exec rake db:migrate
57
    exit
58
59
Il peut aussi y avoir besoin de mettre à jour Ruby (ici 2.4.1) :
60
61
    su - mastodon
62
    cd ~/.rbenv/plugins/ruby-build
63
    git pull
64
    rbenv install 2.4.1
65 56 loris.hilaire
    rbenv global 2.4.1
66 46
    (rbenv rehash)
67 56 loris.hilaire
    gem install bundler --no-document
68 46
    cd ~/live
69
    git fetch
70
    git checkout v[numero-de-version]
71 56 loris.hilaire
    bundle install
72 46
    yarn install
73 56 loris.hilaire
    RAILS_ENV=production bundle exec rake assets:clobber
74 46
    RAILS_ENV=production bundle exec rails db:migrate
75
    RAILS_ENV=production bundle exec rails assets:precompile
76
    exit
77
78 51 mathias.bert-barbedienne
    Vérifier la présence et éventuellement supprimer les versions obsolètes de ruby dans /home/mastodon/live/vendor/bundle/ruby
79
    Vérifier la présence et éventuellement supprimer les versions obsolètes de node dans /usr/local/n/versions/node/
80
81 46
Enfin, il peut être nécessaire d'upgrader npm ; dans ce cas, avant de fetch Mastodon, faire :
82
83
    npm cache clean -f
84
    npm install -g n
85
    n stable
86
87
Si tout s'est bien passé, on relance les services :
88
89 55 loris.hilaire
    systemctl start mastodon-*.service --all
90 46
91
Et on checke que tout est au vert :
92
93 54 loris.hilaire
    systemctl status mastodon-*.service
94 46
95
On peut ensuite informer les utilisateurs du retour à la normale et que la mise à jour a bien été effectuée \!
96 57 sacha
97
98
### désactiver le mode maintenance
99
100 58 sacha
    cd /etc/nginx/sites-enabled && rm maintenance.conf && ln -s ../sites-available/mastodon.conf mastodon.conf && systemctl reload nginx
101 46
102
## Certificat Let's Encrypt
103
104
toot.aquilenet.fr utilise un certificat Let's Encrypt pour proposer du SSL/TLS de qualité. Malheureusement, Let's Encrypt demande encore et toujours un renouvellement tous les 3 mois.
105
106
Le renouvellement est automatisé par un cron daily qui teste tous les jours si l'expiration du certificat est \< 30 jours et lance le script renewCerts.sh disponible dans /srv/letsencrypt. Si jamais cela ne fonctionne pas, pour renouveler le certificat :
107
108
    sudo certbot renew
109
    sudo service nginx reload
110
111
Si cela ne semble pas fonctionner, rallonger comme suit :
112
113
    certbot certonly -n --cert-name toot.aquilenet.fr --webroot -w /srv/letsencrypt/ -d toot.aquilenet.fr
114
    sudo service nginx reload
115
116
Si cela ne fonctionne toujours pas, passer en root et carrément créer un nouveau certificat en écrasant l'ancien :
117
118
    service nginx stop
119
    letsencrypt certonly -d toot.aquilenet.fr --agree-tos -m admin@aquilenet.fr --rsa-key-size 4096 --standalone
120
    service nginx start
121
122
### Backups
123
124
Actuellement, une backup du nécessaire (Postgres + Ruby) est faire par BackupNinja.
125
126 47 loris.hilaire
## Stockage et maintenance
127 46
128
Mastodon stocke localement tous les médias distants affichés par les utilisateurs de l'instance. Un NFS a été monté sur Saya afin de permettre de tenir la charge qui monte exponentiellement.
129 47 loris.hilaire
De plus, la base de données peut se remplir plus que de raison avec des données qui n'ont plus aucun intérêt.
130 46
131 47 loris.hilaire
### Supprimer les vieux médias distants
132
133 49 loris.hilaire
Une task a été créée pour Mastodon et ajoutée dans le cron de l'utilisateur mastodon (lancé quotidiennement). Elle permet de supprimer tous les médias distants supérieurs à 7 jours du cache de l'instance. Les liens restent trouvables dans les toots associés, donc l'impact est mineur pour l'utilisateur, et bénéfique pour nous.
134 46
135 47 loris.hilaire
    cd /home/mastodon/live && RAILS_ENV=production /home/mastodon/.rbenv/shims/bundle exec /home/mastodon/live/bin/tootctl media remove
136 46
137 47 loris.hilaire
### Supprimer les médias orphelins
138
139 49 loris.hilaire
La commande ci-après cherche les fichiers qui ne semblent pas êtres des médias attachés à quoi que ce soit, et les supprime. L'opération va tester chaque fichier individuellement, donc c'est lent.
140 47 loris.hilaire
141 46
    cd /home/mastodon/live && RAILS_ENV=production /home/mastodon/.rbenv/shims/bundle exec /home/mastodon/live/bin/tootctl media remove-orphans
142 47 loris.hilaire
143
### Supprimer de la BDD les comptes n'existant plus
144
145 49 loris.hilaire
Certains comptes présents dans la BDD ainsi que des données liées à ceux-ci prennent de la place alors qu'ils n'existent plus. Pour faire le ménage, la commande ci-dessous va vérifier pour chaque compte présent dans la base de données s'il existe encore sur le serveur d'origine, et si ce n'est pas le cas, le supprimer de la base de données. Les comptes ayant confirmé être actif dans la dernière semaine ne sont pas testés, au cas où le serveur les hébergeant serait juste down.
146 47 loris.hilaire
147 48 loris.hilaire
    cd /home/mastodon/live && RAILS_ENV=production /home/mastodon/.rbenv/shims/bundle exec /home/mastodon/live/bin/tootctl accounts cull
148 47 loris.hilaire
149
### Supprimer de la BDD les pouets distants et sans engagement
150
151
Cette commande va supprimer tous les pouets datés de plus de 90 jours (par défaut) qui n'ont pas été fav, boostés, ou sauvegardés par des utilisateurs de l'instance locale, et n'ont reçu aucune réponse (cette condition est un peu étrange et peut entraîner la suppression de différents pouets si on la lance plusieurs fois d'affilé). Par défaut, ça ne supprime pas les statuts de comptes suivis, mais on peut modifier cette option.
152
153
    cd /home/mastodon/live && RAILS_ENV=production /home/mastodon/.rbenv/shims/bundle exec /home/mastodon/live/bin/tootctl status remove
154 50 loris.hilaire
155
### Récupérer les médias perdus
156
157
Cette commande force Mastodon à chercher à récupérer **tous** les médias perdus (par exemple, des avatars). Cependant, elle semble imparfaite, et ne corrige donc que partiellement le problème. Néanmoins, ça peut aider :
158
159
    cd /home/mastodon/live && RAILS_ENV=production /home/mastodon/.rbenv/shims/bundle exec /home/mastodon/live/bin/tootctl accounts refresh --all
160
161
Une solution alternative est de passer par la console de ruby, à la main, et de cibler spécifiquement l'utilisateur-ice dont on veut récupérer l'avatar :
162
163
    cd /home/mastodon/live
164
    RAILS_ENV=production bundle exec rails c
165
    a = Account.find_remote('USERNAME', 'REMOTE.DOMAIN')
166
    a.reset_avatar!
167
    a.save
168
    exit
169 53 mathias.bert-barbedienne
170
### Re créer un compte supprimé.
171
172
Après s'être assuré de la légitimité de la demande !
173
`sudo su mastodon`
174
`cd /home/mastodon/live && RAILS_ENV=production /home/mastodon/.rbenv/shims/bundle exec /home/mastodon/live/bin/tootctl accounts create $USERNAME --reattach --force --email $EMAIL`
175
cf https://github.com/mastodon/mastodon/issues/4614#issuecomment-1307822170
176
177
Puis via l'interface d'admin `https://toot.aquilenet.fr/admin/accounts?origin=local`
178
chercher le login utilisé puis renvoyer un mail de confirmation.