Dépannage du problème de mise à jour de l’image Sitecore / Blogs / Perficient

Le dépannage des problèmes de mise à jour des images dans Sitecore peut s’avérer être une tâche complexe, car divers facteurs peuvent contribuer au problème. Nous avons récemment rencontré un problème où, après la mise à jour des « Images Sitecore », notre instance de projet locale a cessé de fonctionner.

Afin de résoudre le problème, nous avons essayé plusieurs solutions possibles, y compris celles disponibles sur Internet, mais nous n’avons pas pu identifier la cause première du problème au départ. Pour trouver la cause première du problème, nous avons choisi de suivre le processus suivant :

Étape 1 : Configurer Sitecore 10.2 – Instance non Docker

Nous avons téléchargé et installé l’instance non-docker « Sitecore 10.2 » et l’avons intégrée à la base de code de notre projet. Cette étape a vérifié le bon fonctionnement de notre instance non-docker « Sitecore 10.2 » ainsi que notre base de code, ne laissant aucun doute sur le fait que le problème ne s’est pas produit à cause de la base de code.

Pour cette raison, nous avons également comparé le dossier bin de l’instance de projet non-docker « Sitecore 10.2 » avec le dossier bin de l’instance de projet docker « Sitecore 10.2 » et avons découvert que les DLL ne correspondaient pas.

Pour résoudre ce problème, nous avons même essayé de mettre à jour les DLL, mais après avoir mis à jour une DLL, cela a présenté un autre problème et a continué à se répéter.

Étape 2 : Dépannage de l’image « Sitecore-xp0-cm »

Heureusement, un de mes collègues disposait d’une instance de projet « Sitecore 10.2 » fonctionnelle avec Docker sur sa machine. C’est pourquoi nous avons décidé de déboguer les images sitecore pour identifier la cause première du problème.

docker image inspect --format '{{json .}}' "Add your image id here" '. | {Id: .Id, Digest: .Digest, RepoDigests: .RepoDigests, Labels: .Config.Labels}'

La commande PowerShell ci-dessus génère le sortir au format JSON. Un extrait de code du fichier de sortie se trouve ci-dessous.

"Id": "sha256:55825c834be6aa053e9292c77f90cd64557cf5a5be21a8fb412f1b76074076aa",
"RepoTags": [
  "scr.sitecore.com/sxp/sitecore-xp0-cm:10.2-ltsc2019"
],
"RepoDigests": [
  "scr.sitecore.com/sxp/sitecore-xp0-cm@sha256:d2ac9c0b631ff23aae6915836123049ff6d714e01fc8af49eef69cc07cb7abf5"
]

Digest ID of sitecore-xp0-cm image

sha256:d2ac9c0b631ff23aae6915836123049ff6d714e01fc8af49eef69cc07cb7abf5

À partir de l’extrait de code ci-dessus, localisez les « RepoDigests », extrayez le « Digest Id », copiez-le et recherchez-le dans le «Liste de détails des images Sitecore Docker« . Vous constaterez que l’image « Sitecore-xp0-cm » télécharge la balise « 10.2.1-ltsc2019 » ou l’image versionnée.

Notre projet repose sur la version « 10.2.0-ltsc2019 », c’est pourquoi l’instance locale du projet ne fonctionnait pas.

Pour résoudre ce problème, nous avons modifié notre fichier « .env », où se trouvent les variables liées à Docker, et inclus la « Version Sitecore » nécessaire sur laquelle notre base de code est configurée.

SITECORE_VERSION=10.2.0-ltsc2019

Après avoir modifié le fichier « .env », suivez les étapes ci-dessous afin de rendre l’instance de projet locale opérationnelle.

1. Supprimez tous les conteneurs Docker
2. Supprimez toutes les images Docker
3. Redémarrez le système
4. Téléchargez toutes les images et construisez les conteneurs
5. Après cela, nous avons pu rendre notre instance de projet locale opérationnelle.

Conclusion:

Des modifications importantes ont été apportées au fichier « .env » et la « Version Sitecore » a été remplacée par « 10.2.0-ltsc2019 ». Notre base de code et d’autres environnements de niveau supérieur, tels que le site en direct, avaient été configurés pour la version « Sitecore 10.2.0 », et c’est pourquoi nous avons opté pour cette étape. Si nous passons à la « version Sitecore » de « 10.2.1-ltsc2019 », qui est la dernière par défaut, nous devrons mettre à niveau notre base de code en plus des autres environnements.

J’espère que cela t’aides. Bon apprentissage de Sitecore et Docker !!!