Migration héritée

Quand est-ce nécessaire ?

Uniquement pour un déploiement dont le répertoire contient .env et .secrets/ à sa racine et aucun .deployment_states/ : un déploiement configuré à la main, ou par un outil de déploiement antérieur à la version 2.7.0. Ces déploiements sont également antérieurs à Authentik et conservent leurs utilisateurs dans la base de données Avatar.

Tous les autres déploiements suivent Mise à jour et retour arrière.

La migration s'exécute une seule fois. Elle déplace la configuration vers la structure gérée par octopize-deploy-tool, puis importe les utilisateurs, organisations et licences existants dans Authentik. Par la suite, le déploiement se met à jour comme n'importe quel autre.

1. Sauvegarder le déploiement hérité

Sauvegardez la base de données et copiez l'intégralité du répertoire hérité. Les commandes de sauvegarde s'appliquent, avec les chemins du répertoire hérité.

2. Migrer la configuration

Installez la dernière version de l'outil de déploiement, puis indiquez-lui le répertoire hérité et un nouveau répertoire de déploiement vide :

octopize-deploy-tool migrate \
  --app-root ./app/avatar-new \
  --from-legacy ./app/avatar-old

migrate lit les valeurs depuis les .env et .secrets/ hérités et demande celles qui manquent. Il affiche ensuite la différence, en commençant par les versions de services qui changent. Attendez-vous à une différence importante : la structure change et chaque service passe directement à la version actuelle.

Exécutions non interactives

Avant d'exécuter avec --non-interactive, vérifiez que le .env hérité définit NGINX_SSL_CERTIFICATE_PATH et NGINX_SSL_CERTIFICATE_KEY_PATH avec des chemins qui existent.

3. Démarrer et importer les utilisateurs

octopize-deploy-tool start --app-root ./app/avatar-new

Le premier start après un migrate propose d'importer les utilisateurs dans Authentik. Il prévisualise chaque opération et demande une confirmation. Acceptez.

Si vous avez refusé, ou si l'import a échoué en cours de route, lancez-le plus tard. Il peut être relancé sans risque, car les utilisateurs déjà importés sont ignorés :

# Prévisualiser sans rien modifier
octopize-deploy-tool tasks authentik-migrate --from-docker --app-root ./app/avatar-new --dry-run

# Importer
octopize-deploy-tool tasks authentik-migrate --from-docker --app-root ./app/avatar-new

# Relancer uniquement les opérations qui ont échoué
octopize-deploy-tool tasks authentik-migrate --from-docker --app-root ./app/avatar-new \
  --from-log migration_log.jsonl --failed-only

4. Vérifier

Suivez Vérification et dépannage. Les utilisateurs existants se connectent désormais via Authentik. Pour en ajouter de nouveaux, consultez Gestion des utilisateurs.

Si la migration échoue, arrêtez le nouveau déploiement, restaurez la sauvegarde de la base de données, puis redémarrez le déploiement hérité depuis son répertoire.