Projet

Général

Profil

Mastodon » Historique » Version 51

mathias.bert-barbedienne, 05/12/2022 06:23

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
Ensuite, repasser en root
16
17
    su - monutilisateur
18
    sudo su
19
20
Et stopper les services Mastodon :
21
22
    systemctl stop mastodon-web.service mastodon-sidekiq.service mastodon-streaming.service
23
24
Repasser sur l'utilisateur mastodon (jongler avec deux terminaux peut faciliter la tâche et éviter ces allers-retours) :
25
26
    su - mastodon
27
    cd live
28
    git fetch
29
    git checkout v[numero-de-version]
30
    bundle install
31
    yarn install
32
    RAILS_ENV=production bundle exec rails db:migrate
33
    RAILS_ENV=production bundle exec rails assets:precompile
34
    exit
35
36
Une version plus complète, qui vérifie les besoins en termes de dépendances, est celle-ci (conseillée) :
37
38
    su - mastodon
39
    cd live
40
    git fetch
41
    git checkout v[numero-de-version]
42
    export RAILS_ENV=production
43
    export NODE_ENV=production
44
    bundle install --deployment --without test development
45
    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.
46
    yarn
47
    RAILS_ENV=production bundle exec rake assets:clobber
48
    RAILS_ENV=production bundle exec rake assets:precompile
49
    RAILS_ENV=production bundle exec rake db:migrate
50
    exit
51
52
Il peut aussi y avoir besoin de mettre à jour Ruby (ici 2.4.1) :
53
54
    su - mastodon
55
    cd ~/.rbenv/plugins/ruby-build
56
    git pull
57
    rbenv install 2.4.1
58
    (rbenv rehash)
59
    cd ~/live
60
    git fetch
61
    git checkout v[numero-de-version]
62
    gem install bundler
63
    bundle install --deployment --without development test
64
    yarn install
65
    RAILS_ENV=production bundle exec rails db:migrate
66
    RAILS_ENV=production bundle exec rails assets:precompile
67
    exit
68
69 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
70
    Vérifier la présence et éventuellement supprimer les versions obsolètes de node dans /usr/local/n/versions/node/
71
72 46
Enfin, il peut être nécessaire d'upgrader npm ; dans ce cas, avant de fetch Mastodon, faire :
73
74
    npm cache clean -f
75
    npm install -g n
76
    n stable
77
78
Si tout s'est bien passé, on relance les services :
79
80
    systemctl start mastodon-web.service mastodon-sidekiq.service mastodon-streaming.service
81
82
Et on checke que tout est au vert :
83
84
    systemctl status mastodon-web.service mastodon-sidekiq.service mastodon-streaming.service
85
86
On peut ensuite informer les utilisateurs du retour à la normale et que la mise à jour a bien été effectuée \!
87
88
## Certificat Let's Encrypt
89
90
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.
91
92
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 :
93
94
    sudo certbot renew
95
    sudo service nginx reload
96
97
Si cela ne semble pas fonctionner, rallonger comme suit :
98
99
    certbot certonly -n --cert-name toot.aquilenet.fr --webroot -w /srv/letsencrypt/ -d toot.aquilenet.fr
100
    sudo service nginx reload
101
102
Si cela ne fonctionne toujours pas, passer en root et carrément créer un nouveau certificat en écrasant l'ancien :
103
104
    service nginx stop
105
    letsencrypt certonly -d toot.aquilenet.fr --agree-tos -m admin@aquilenet.fr --rsa-key-size 4096 --standalone
106
    service nginx start
107
108
### Backups
109
110
Actuellement, une backup du nécessaire (Postgres + Ruby) est faire par BackupNinja.
111
112 47 loris.hilaire
## Stockage et maintenance
113 46
114
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.
115 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.
116 46
117 47 loris.hilaire
### Supprimer les vieux médias distants
118
119 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.
120 46
121 47 loris.hilaire
    cd /home/mastodon/live && RAILS_ENV=production /home/mastodon/.rbenv/shims/bundle exec /home/mastodon/live/bin/tootctl media remove
122 46
123 47 loris.hilaire
### Supprimer les médias orphelins
124
125 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.
126 47 loris.hilaire
127 46
    cd /home/mastodon/live && RAILS_ENV=production /home/mastodon/.rbenv/shims/bundle exec /home/mastodon/live/bin/tootctl media remove-orphans
128 47 loris.hilaire
129
### Supprimer de la BDD les comptes n'existant plus
130
131 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.
132 47 loris.hilaire
133 48 loris.hilaire
    cd /home/mastodon/live && RAILS_ENV=production /home/mastodon/.rbenv/shims/bundle exec /home/mastodon/live/bin/tootctl accounts cull
134 47 loris.hilaire
135
### Supprimer de la BDD les pouets distants et sans engagement
136
137
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.
138
139
    cd /home/mastodon/live && RAILS_ENV=production /home/mastodon/.rbenv/shims/bundle exec /home/mastodon/live/bin/tootctl status remove
140 50 loris.hilaire
141
### Récupérer les médias perdus
142
143
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 :
144
145
    cd /home/mastodon/live && RAILS_ENV=production /home/mastodon/.rbenv/shims/bundle exec /home/mastodon/live/bin/tootctl accounts refresh --all
146
147
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 :
148
149
    cd /home/mastodon/live
150
    RAILS_ENV=production bundle exec rails c
151
    a = Account.find_remote('USERNAME', 'REMOTE.DOMAIN')
152
    a.reset_avatar!
153
    a.save
154
    exit