Restauration du contenu DXP de production pour le développement local d'Episerver

Lors du développement de nouvelles fonctionnalités dans Episerver CMS, il peut être extrêmement utile d'avoir une copie locale du contenu de production. Voici les étapes requises pour extraire le contenu de la plate-forme DXP d'Episerver et le restaurer dans votre environnement local pour le développement.

Étape 1: Demander une sauvegarde de la base de données du portail PaaS

La première étape du processus est la seule que vous ne peut pas contrôler complètement. Vous devez lancer une exportation de base de données à partir du portail PaaS. Accédez à paasportal.episerver.net, sélectionnez le compte approprié et lancez une exportation de production à partir de l'onglet Dépannage.

Ce processus prend de quelques minutes à quelques jours. Personnellement, j'aime lancer cela après un déploiement de production réussi ou après de gros efforts de manipulation de contenu. Une fois terminé, vous verrez un lien pour télécharger un fichier .bacpac dans cette même section.

Étape 2: Importez la sauvegarde dans votre serveur SQL local

Une fois que vous avez reçu le .bacpac vous devrez l'importer dans votre environnement de développement local. J'exécute toujours Episerver sous IIS avec SQL Server, donc ces instructions sont adaptées à cette configuration (par opposition à IIS Express et SQL Express). Je commence généralement par désactiver IIS, fermer les connexions existantes à ma base de données actuelle et la supprimer. À partir de là, exécutez une importation de niveau de données pour restaurer la production .bacpac avec le même nom que votre configuration de développement local.

Un autre conseil ici: Tous les développeurs travaillant sur la même solution partagent un alias SQL appelé «episerver» résolvant leur installation SQL locale. Nous utilisons tous un compte SQL local appelé «episerver» qui est un administrateur de l'installation SQL locale, tous avec le même mot de passe. De là, nous appelons généralement la base de données episerver.projectname . Indépendamment de votre configuration, assurez-vous simplement d'importer la base de données de production et de configurer votre chaîne de connexion dans votre web.config en conséquence.

Étape 3: Exécutez la commande SQL pour mettre à jour la gestion des versions

C'est une petite étape cachée qui me semble beaucoup de monde. Nous automatisons l'installation de code via notre plateforme devops de choix (par exemple, Azure Devops). Dans le cadre de cette configuration, nous introduisons toujours la gestion des versions d'assembly, de sorte que chaque nouvelle version de l'application obtient un numéro de version automatiquement attribué et incrémenté. Ces numéros de version sont stockés dans la base de données d'Epi, et Epi évitera de mettre à jour les ContentTypes qui ont une version inférieure à ceux trouvés dans la base de données. Pour corriger cela, redéfinissez la version sur 1.0.0.0 (ou ce qui se trouve dans votre fichier AssemblyInfo.cs local). Voici le script SQL pour le faire (remplacez MySite et x.y.z.0 en conséquence):

 UPDATE [episerver.mysite]. [dbo]. [tblContentType]
ENSEMBLE
  ModelType = REPLACE (ModelType, 'x.y.z.0', '1.0.0.0'),
  Version = '1.0.0.0'
WHERE ModelType comme '% MySite%' 

Étape 4: Exporter / Importer des Blobs depuis la production

Maintenant que vous avez le contenu, vous avez besoin des Blobs pour l'accompagner. Cette étape est assez simple – nous optons généralement pour stocker les Blobs dans la zone «Pour ce site» ou «Pour tous les sites». Connectez-vous à la production, accédez à l'onglet d'administration et lancez une exportation de contenu des racines nécessaires. À partir de là, reconnectez-vous à votre environnement local et importez ces racines.

Vous pouvez en savoir plus sur l'exportation et l'importation depuis ici .

N'oubliez pas, car vous avez restauré la base de données de production sur votre local, vous devez vous connecter avec vos informations d'identification de production.

Étape 5: Mettez à jour la configuration de votre site

Enfin, reconnectez-vous à votre instance Episerver locale, accédez à l'onglet Admin et configurez la définition de votre site avec les noms d'hôte appropriés . Si vous avez un nom d’hôte générique en production, vous n’avez peut-être pas besoin de le faire, mais je vous recommande de le faire pour être minutieux.

Étape 6: Profit!

Et c’est tout! Garder votre environnement local synchronisé avec la production est essentiel pour être un développeur efficace sur un projet Epi. J'espère que cela vous aidera, bon codage.

À propos de l'auteur <! -: dmccurry, Architecte de solutions ->

Je suis un développeur Sitecore certifié, un singe de code et un nerd général. J'ai sauté dans l'espace .NET il y a 10 ans pour travailler sur des applications de classe entreprise et je n'ai jamais regardé en arrière. J'adore créer des choses, des Legos aux logiciels qui résolvent de vrais problèmes. Ai-je mentionné que j'aime les jeux vidéo?

Plus de cet auteur