Important

Cette section suppose que vous avez déployé Parsec en suivant les instructions de Server deployment section. Si vous avez déployé Parsec différemment, vous devrez peut-être adapter cette section à votre déploiement personnalisé.

Mise à jour du serveur Parsec

Avertissement

Avant de procéder à la mise à jour, assurez-vous de sauvegarder la base de données comme expliqué dans la section, Sauvegarde et restauration au cas où vous auriez besoin de revenir sur la mise à jour.

Dans ce guide, nous allons migrer parsec-server de la version v3.0.0 vers v3.1.0.

  1. Mettre à jour le tag docker image de parsec-server dans le fichier docker-compose (``parsec-server.docker.yaml`) :

1services:
2  # ...
3
4  parsec-server:
5    image: ghcr.io/scille/parsec-cloud/parsec-server:v3.0.0
6    # ...

Vous devez changer la balise utilisée (à la ligne 5) en v3.1.0.

  1. Liste des migrations en attente à appliquer :

docker compose -f parsec-server.docker.yaml run parsec-server migrate --dry-run

Le résultat devrait ressembler à ceci :

0001_initial.sql (already applied)
0002_add_migration_table.sql (already applied)
0003_human_handle.sql (already applied)
0004_invite.sql (already applied)
0005_redacted_certificates.sql (already applied)
0006_outsider_enabled.sql (already applied)
0007_users_limit.sql (already applied)
0008_apiv1_removal.sql (already applied)
0009_add_realm_user_change_table.sql (already applied)
0010_add_pki_certificate_table.sql (already applied)
0011_add_sequester_tables.sql (already applied)
0012_add_sequester_webhook.sql (already applied)
0013_add_shamir_recovery.sql ✔
0014_add_realm_archiving.sql ✔

Note

Ce résultat est fourni à titre d’exemple. Ne vous attendez pas à ce qu’elle corresponde à la vôtre.

Les lignes se terminant par already applied sont des migrations déjà présentes dans la base de données tandis que celles se terminant par ✔ sont des migrations à appliquer.

  1. Appliquer la migration de la base de données :

docker compose -f parsec-server.docker.yaml run parsec-server migrate

  1. Redémarrer le conteneur parsec-server :

docker compose -f parsec-server.docker.yaml restart parsec-server

Rétablir une version antérieure du serveur Parsec

Avertissement

Le retour en arrière est actuellement limité dans Parsec. La seule façon de revenir en arrière est d’utiliser la sauvegarde de la base de données précédente. Vous perdrez donc le delta entre la sauvegarde et la base de données actuelle.

Pour revenir à une version antérieure, disons que nous voulons rétrograder parsec-server de la version v3.1.0 à v3.0.0.

  1. Rétrogradez le tag docker image de parsec-server dans le fichier docker-compose (parsec-server.docker.yaml`). Comme dans :ref:`Mettre à jour le tag parsec-server <update_docker_image_tag>` changer le tag ``v3.1.0 en v3.0.0.

  2. Remplacer la base de données actuelle par la sauvegarde de la base de données Postgres.

  3. Redémarrer le conteneur du serveur Parsec