docs: Sphinx manuel joueur/admin/dev + build HTML
Manuel complet DauphinCraft v0.1.0 : 14 pages RST (joueur, admin, dev, annexes), conf.py rtd-theme, Makefile/make.bat, build HTML propre. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
96
docs/_build/html/_sources/admin/maintenance.rst.txt
vendored
Normal file
96
docs/_build/html/_sources/admin/maintenance.rst.txt
vendored
Normal file
@@ -0,0 +1,96 @@
|
||||
Maintenance du serveur
|
||||
======================
|
||||
|
||||
Mise à jour du serveur
|
||||
----------------------
|
||||
|
||||
Pour mettre à jour DauphinCraft vers une nouvelle version :
|
||||
|
||||
1. Téléchargez le nouveau tarball depuis le dépôt officiel :
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
wget http://<gitea-host>/dauphincraft/releases/download/vX.Y.Z/DauphinCraft-Server-vX.Y.Z.tar.gz
|
||||
|
||||
2. Arrêtez le service :
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
sudo systemctl stop dauphincraft
|
||||
|
||||
3. Sauvegardez l'ancienne version (optionnel mais recommandé) :
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
sudo cp -r /opt/dauphincraft /opt/dauphincraft.bak
|
||||
|
||||
4. Extrayez la nouvelle version :
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
sudo tar -xzf DauphinCraft-Server-vX.Y.Z.tar.gz -C /opt/
|
||||
sudo rsync -a --exclude='logs' /opt/DauphinCraft-Server/ /opt/dauphincraft/
|
||||
|
||||
5. Relancez le service :
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
sudo systemctl start dauphincraft
|
||||
systemctl status dauphincraft
|
||||
|
||||
Surveillance et logs
|
||||
---------------------
|
||||
|
||||
**Consultation des logs en direct :**
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
journalctl -u dauphincraft -f
|
||||
|
||||
**Consultation des dernières lignes :**
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
tail -n 100 /var/log/dauphincraft.log
|
||||
|
||||
**Rotation des logs :** le service redirige stdout/stderr vers ``/var/log/dauphincraft.log``.
|
||||
Pour éviter que ce fichier grossisse indéfiniment, configurez ``logrotate`` :
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
sudo nano /etc/logrotate.d/dauphincraft
|
||||
|
||||
Contenu suggéré :
|
||||
|
||||
.. code-block:: text
|
||||
|
||||
/var/log/dauphincraft.log {
|
||||
daily
|
||||
rotate 7
|
||||
compress
|
||||
missingok
|
||||
notifempty
|
||||
}
|
||||
|
||||
Vérification de l'état du serveur
|
||||
-----------------------------------
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
systemctl is-active dauphincraft
|
||||
|
||||
Retourne ``active`` si le serveur est opérationnel, ``failed`` sinon.
|
||||
|
||||
Redémarrage automatique
|
||||
------------------------
|
||||
|
||||
Le fichier de service inclut ``Restart=on-failure`` avec un délai de 5 secondes.
|
||||
Le serveur redémarre donc automatiquement en cas de crash.
|
||||
|
||||
Gestion des joueurs (Kick / Ban)
|
||||
----------------------------------
|
||||
|
||||
.. note::
|
||||
|
||||
Les commandes d'administration en jeu (kick, ban) sont prévues pour la version 0.2.0.
|
||||
Aucune interface d'administration n'est disponible dans la version actuelle.
|
||||
Reference in New Issue
Block a user