Cette page a été traduite automatiquement. Vous avez repéré une erreur ?Aidez-nous à l'améliorer.
Skip to content

Mise à niveau de la 1.x vers la 2.0 ​

SnapOtter 1.x stockait tout dans un seul fichier SQLite et s'exécutait dans un seul conteneur. SnapOtter 2.0 utilise PostgreSQL et Redis. Ce guide vous accompagne pour migrer une installation 1.x vers la 2.0 sans perdre de données.

En bref : réutilisez votre volume /data existant, et la 2.0 importe automatiquement votre base de données 1.x au premier démarrage. Vos utilisateurs, fichiers enregistrés, paramètres, clés d'API et pipelines sont repris. L'ancienne base n'est jamais modifiée, vous pouvez donc toujours revenir en arrière.

Un mot pour nos utilisateurs de la 1.x

Beaucoup d'entre vous font confiance à SnapOtter depuis le premier jour, et vos retours ont façonné cette version. La 2.0 change beaucoup de choses en coulisses, et ce guide existe pour que la migration ne vous coûte rien de ce qui compte pour vous. Vos comptes, fichiers, paramètres, clés d'API et pipelines sont repris, et votre ancienne base de données n'est jamais touchée. Merci de migrer avec nous.

Avant de commencer : sauvegardez tout le volume /data ​

Faites-le en premier, à chaque fois. Sauvegardez le volume /data entier, pas seulement le fichier snapotter.db.

Voici pourquoi c'est important. La 1.x exécute SQLite en mode WAL : un conteneur 1.x arrêté laisse donc couramment l'essentiel de ses données validées dans snapotter.db-wal, à côté d'un snapotter.db presque vide. Copier uniquement snapotter.db capture une base vide et perd silencieusement tout le reste. Le volume contient snapotter.db, snapotter.db-wal, snapotter.db-shm et votre répertoire files/ ensemble, et ils doivent être transférés comme un tout.

bash
# Adjust the volume name to match yours (see "Check your volume name" below).
docker run --rm -v SnapOtter-data:/data -v "$PWD":/backup \
  alpine tar czf /backup/snapotter-1x-data.tgz -C /data .

Passez d'abord à la 1.17.2 ​

Mettez à niveau votre installation 1.x vers la dernière version 1.x (1.17.2) avant de passer à la 2.0. Cela permet à la 1.x d'exécuter ses propres migrations de schéma finales, de sorte que la 2.0 importe depuis un schéma connu et complet. Passer directement d'une ancienne version 1.x à la 2.0 n'est pas pris en charge.

Vérifiez le nom de votre volume ​

L'importeur ne voit vos données que si la pile 2.0 monte le même volume que celui utilisé par votre installation 1.x. Les noms de volumes Docker sont sensibles à la casse, et d'anciens extraits du README utilisaient snapotter-data en minuscules alors que les fichiers Compose utilisent SnapOtter-data. Confirmez lequel vous avez :

bash
docker volume ls | grep -i snapotter

Utilisez exactement ce nom dans votre configuration 2.0.

Voie A : conteneur unique (la plus rapide) ​

Si vous exécutez SnapOtter avec un seul docker run, continuez ainsi. La 2.0 démarre un PostgreSQL et un Redis embarqués dans le conteneur lorsque vous ne définissez pas DATABASE_URL ni REDIS_URL, et elle détecte et importe automatiquement /data/snapotter.db au premier démarrage.

bash
docker run -d --name snapotter -p 1349:1349 \
  -v SnapOtter-data:/data \
  snapotter/snapotter:latest

Surveillez les journaux pour repérer une ligne comme :

Imported 1.x SQLite database: {"tables":{"users":2,"teams":1,...},"blobs":{"present":1,"missing":0}}

C'est tout. Connectez-vous avec vos identifiants existants.

La pile Compose 2.0 exécute trois services (application, Postgres, Redis). Réutilisez votre volume /data de la 1.x pour le service de l'application. L'application détecte automatiquement /data/snapotter.db et l'importe dans Postgres au premier démarrage.

yaml
services:
  SnapOtter:
    image: snapotter/snapotter:latest
    volumes:
      - SnapOtter-data:/data          # your existing 1.x volume
      - SnapOtter-workspace:/tmp/workspace
    environment:
      - DATABASE_URL=postgres://${POSTGRES_APP_USER:-snapotter_app}:${POSTGRES_APP_PASSWORD:-snapotter_app}@postgres:5432/${POSTGRES_DB:-snapotter}
      - DATABASE_MIGRATION_URL=postgres://${POSTGRES_USER:-snapotter}:${POSTGRES_PASSWORD:-snapotter}@postgres:5432/${POSTGRES_DB:-snapotter}
      - REDIS_URL=redis://:snapotter@redis:6379
    # ...

Si vous préférez pointer explicitement vers l'ancienne base, définissez SQLITE_MIGRATE_PATH=/data/snapotter.db. Un chemin explicite l'emporte toujours sur la détection automatique.

Prévisualiser l'import d'abord (facultatif) ​

Pour voir exactement ce qui serait importé sans rien écrire, lancez une simulation sur votre fichier de base de données :

bash
pnpm --filter @snapotter/api migrate:sqlite -- /path/to/snapotter.db --dry-run

Elle affiche le nombre de lignes par table, le nombre de fichiers de bibliothèque enregistrés trouvés sur le disque et les statuts de tâche qu'elle va normaliser. Elle n'a pas besoin d'un Postgres en cours d'exécution.

Ce qui est repris, et ce qui ne l'est pas ​

Repris :

  • Les utilisateurs, et la possibilité de se connecter. Les hachages de mots de passe sont inchangés : le même nom d'utilisateur et le même mot de passe fonctionnent.
  • Les équipes, les paramètres (y compris l'identité de votre instance), les rôles, les clés d'API (elles continuent de fonctionner) et les pipelines enregistrés.
  • Les enregistrements de l'historique des tâches.
  • Votre bibliothèque de fichiers enregistrés, à la fois les enregistrements et les fichiers eux-mêmes, car /data/files est conservé sur le volume.

Non repris :

  • Les sessions de connexion. Chacun se reconnecte une fois après la mise à niveau. Les identifiants sont inchangés : il s'agit d'une seule reconnexion, rien de plus.
  • Les fichiers d'entrée et de sortie des anciennes tâches de traitement. Ils se trouvaient dans un espace de travail temporaire et ont disparu par conception. Les enregistrements de l'historique des tâches subsistent.
  • Les indicateurs de consentement aux analyses par utilisateur de la 1.x, qui n'ont pas d'équivalent en 2.0 (les analyses de la 2.0 sont un paramètre au niveau de l'instance).

Désactiver l'import ​

Si vous voulez délibérément une base de données neuve alors qu'un snapotter.db est présent sur le volume, définissez SQLITE_MIGRATE_PATH=off.

Si vous avez déjà des données dans l'instance 2.0 ​

L'importeur ne s'exécute que vers une base de données vide. Si vous avez démarré la 2.0 à neuf (en créant des données), puis monté plus tard un ancien snapotter.db, la 2.0 le détectera mais ne l'importera pas, car la fusion de deux jeux de données peut provoquer des collisions d'identifiants. Vous verrez un avertissement dans les journaux. Pour importer les données de la 1.x, il vous faut une instance vide :

  • Si l'instance 2.0 ne contient que l'administrateur par défaut (vous ne l'avez pas vraiment utilisée), arrêtez la pile, supprimez le volume Postgres (SnapOtter-pgdata), puis redémarrez avec l'ancien /data présent. L'import se fera proprement. Cela n'efface que les données Postgres jetables, pas votre base de données 1.x.
  • Si l'instance 2.0 contient de vraies données que vous voulez garder, les deux jeux de données ne peuvent pas être fusionnés automatiquement. Exportez ce dont vous avez besoin et importez les données de la 1.x dans un déploiement neuf distinct.

Revenir en arrière ​

La mise à niveau ne modifie ni ne supprime jamais votre snapotter.db de la 1.x. Si vous devez revenir à la 1.x, redéployez l'image 1.x sur le même volume. Tout ce que vous avez créé en 2.0 après la mise à niveau se trouve dans Postgres et ne figurerait pas dans la base de données 1.x : revenez donc rapidement en arrière si vous comptez le faire.