Wikibase/Maintaining/fr



Maintenir une instance Wikibase
Vous trouverez sur cette page quelques ressources pour vous documenter sur votre instance de Wikibase et la garder fonctionnelle et à jour.



Aperçu de l'architecture
D'abord il est important de comprendre ce que vous avez entre les mains. Take a look at our Docker architecture overview.

Voici un tableau de l'architecture avec un diagramme.





Outillage Docker
Le meilleur outil pour gérer votre installation Docker est celui que vous avez utilisé pour l'obtenir et qui se trouve à la première place : docker-compose. This manual can’t possibly replace a grounding in Docker, so check out Docker’s own command references for docker-compose and the docker engine.

Ceci dit, plusieurs commandes de démarrage s'avèrent pratiques.



Obtenir un shell de commande sur un conteneur
Il ne vous sera pas utile pour les activités typiques de Wikibase, mais pour ceux qui débutent avec Docker voici une commande très utile pour vous connecter à un conteneur actif :

docker exec -it &lt;container name&gt; bash



Copier un fichier dans votre répertoire local
docker cp wbdocker_wikibase_1:/var/www/html/LocalSettings.php LocalSettings.php

Ceci fonctionne également dans l'autre sens et la combinaison est utile pour disons, récupérer votre LocalSettings.php, le modifier et le sauvegarder à nouveau.

docker cp LocalSettings.php wbdocker_wikibase_1:/var/www/html/LocalSettings.php

Read Adam Shorland’s excellent blog post for more detail on modifying files on containers.



Arrêter les conteneurs Docker
Cette commande arrête les conteneurs Docker en laissant les machines intactes (avec bien sûr toutes les données) :

Comme on peut l'imaginer, vous pouvez utiliser  pour les redémarrer.



Supprimer les conteneurs en préservant les données
Cette commande supprime les conteneurs en préservant toutes les données dans MySQL, MediaWiki et le service de requête dans les volumes Docker.



Journaux
Chaque application de la grappe Wikibase génère ses propres traces dans le journal. Consultez la documentation propre à chaque service pour savoir comment lire les journaux.

Dans le répertoire où vous avez placé votre fichier, exécutez la commande   et le nom du service (voir la table ci-dessus) pour voir les traces correspondantes dans le journal. Par exemple :

user@host:~/docker$ docker-compose logs -f --tail=100 mysql mysql_1 | 2019-12-31 10:00:00+00:00 [Note] [Entrypoint]: Entrypoint script for MySQL Server started. mysql_1 | 2019-12-31 10:00:00+00:00 [Note] [Entrypoint]: Switching to dedicated user 'mysql' ...



Sauvegarde et restauration
Les données de votre instance Wikibase sont précieuses. What would happen if your datacenter burnt down? Combien de temps faut-il pour une reconstruction ? Les sauvegardes et le test des données restaurées régulièrement sont des actions primordiales.

En général, il existe deux ensembles de données que vous devrez sauvegarder : le système de fichiers MediaWiki / Wikibase et plus important : la base de données MySQL. First and foremost, we recommend reading the Wikibase Docker install doc to get the lay of the land.



Au niveau Docker
Puisqu'il s'agit d'une installation Docker, il est recommandé d'utiliser les outils Docker pour les sauvegardes.

Docker-level backup is explained in some detail here. It involves backing up the Docker volumes and dumping out the database with mysqldump.

For a helpful overview of Docker data backup and restore, including the use of the  and   commands, read this excellent StackOverflow post. It’s been updated several times since its original posting in 2014 and constitutes a great tour and jumping-off point for the docker command-line reference linked above.



Au niveau conteneur
Backup on the container level is not an easy proposition; we cover it here mainly to present a more complete picture of MediaWiki and Wikibase under the hood.

To that end, read the documentation on, bearing in mind that the work needs to be done from within the containers (cf. Docker tooling above) and the data extracted and placed somewhere safe outside of Docker.



Outils Wiki
Wikibase est une extension de MediaWiki. Much of the functionality you’ll be working with is actually that of MediaWiki, so consult the and the. Of particular note:


 * - guide utilisateur
 * - gestion des droits utilisateurs
 * - guide de l'administrateur Wiki

Mise à jour
Keeping software up to date is the only way to obtain new features, not to mention how important it is to apply bug and security fixes.

To update Wikibase on Docker, read our upgrade documentation.

Updating a manual install of the Wikibase suite isn't as straightforward: it involves upgrading MediaWiki itself (see the MediaWiki update documentation) and then the individual software components.