Solution communautaire

Nextcloud + MySQL sur CasaOS : ce qui reste valable aujourd’hui

A September 2023 community post shared a video tutorial for deploying Nextcloud with MySQL on CasaOS, but the post itself did not document the exact configuration steps.

L’idée centrale de ce tutoriel CasaOS de 2023 reste valable : Nextcloud peut utiliser MySQL ou MariaDB comme base de données. En revanche, il ne faut pas reprendre aveuglément un ancien guide de déploiement de conteneurs dont les balises d’image exactes, les variables d’environnement, le comportement réseau et les versions de base de données ont pu changer.

Pour un déploiement actuel, utilisez une version de base de données prise en charge par votre version actuelle de Nextcloud, prévoyez un stockage persistant pour les deux services, connectez-les sur un réseau Docker stable et référencez la base de données par le nom du service ou du conteneur plutôt que par une adresse IP de conteneur codée en dur.

Ce que contenait réellement le fil de discussion original

La publication du forum présentait un guide vidéo pour configurer MySQL avec Nextcloud sur CasaOS. Elle ne publiait pas le fichier Docker Compose ni les valeurs de configuration du tutoriel dans le texte du fil ; il n’existe donc aucune base fiable pour reconstituer ces anciennes étapes à partir de la seule page du forum.

Cette distinction est importante, car une vidéo de 2023 peut toujours expliquer correctement l’architecture tout en montrant des balises d’image ou des champs de configuration désormais obsolètes.

Nextcloud prend toujours en charge MySQL et MariaDB

Les exigences système de Nextcloud actuelles répertorient les familles et versions de bases de données prises en charge. MySQL reste pris en charge, tandis que MariaDB et PostgreSQL sont également des choix courants.

Consultez les exigences correspondant exactement à la version majeure de Nextcloud que vous installez. Évitez d’épingler une image de base de données vieille de plusieurs années simplement parce qu’elle apparaît dans un ancien tutoriel.

Utilisez un réseau Docker stable, pas les adresses IP des conteneurs

Lorsque Nextcloud et la base de données s’exécutent dans des conteneurs distincts, placez-les sur le même réseau Docker défini par l’utilisateur ou dans le même projet Compose, puis indiquez le nom du service de base de données comme hôte de la base de données. Les adresses IP des conteneurs peuvent changer après une recréation ou un redémarrage.

La version actuelle de ZimaOS prend en charge les déploiements Compose à plusieurs conteneurs. Si vous passez d’un ancien tutoriel CasaOS à la version actuelle de ZimaOS, le guide matériel Nextcloud fournit des indications sur le dimensionnement avant le déploiement.

Conservez les données de Nextcloud et de la base de données sur un stockage persistant

L’application web et la base de données ont des besoins différents en matière de persistance. Associez un stockage durable à la configuration et aux données de Nextcloud, ainsi qu’au répertoire de données de la base de données. La recréation d’un conteneur ne doit effacer l’état d’aucun des deux services.

Ne considérez pas le répertoire d’une base de données active comme un simple dossier à sauvegarder. Une exportation cohérente de la base de données, une procédure compatible avec les instantanés ou une sauvegarde tenant compte de l’application est plus sûre. Le guide de sauvegarde des conteneurs de bases de données explique pourquoi la cohérence est importante.

Que saisir dans l’installateur Nextcloud

L’assistant d’installation actuel de Nextcloud demande les identifiants de la base de données ainsi que l’hôte de la base de données. Dans une pile Compose, cet hôte doit normalement être le nom du service de base de données, suivi d’un port uniquement lorsqu’un port différent de celui par défaut est requis.

N’exposez pas le port de la base de données sur l’ensemble du réseau local, sauf si un autre hôte en a réellement besoin. Nextcloud et sa base de données doivent généralement communiquer uniquement via leur réseau Docker.

En résumé

L’architecture de l’ancien tutoriel CasaOS — Nextcloud associé à une base de données SQL distincte — reste pertinente, mais utilisez les exigences actuelles du projet plutôt que de copier les versions d’images ou les détails réseau de 2023. Les volumes persistants et l’utilisation d’un réseau stable fondé sur les noms de services sont les éléments à conserver.