Erreurs d’installation lors de la configuration de l’instance Sitecore 10.x avec Docker / Blogs / Perficient

En tant que développeur Sitecore, vous avez peut-être rencontré des erreurs en travaillant avec Sitecore, en particulier pendant le processus de configuration/installation. Dans cet article de blog, nous discuterons de certaines des erreurs que j’ai rencontrées lors de la configuration du modèle de démarrage de Sitecore via Docker sur ma machine locale.

« Docker Desktop – Version du noyau WSL trop faible »

C’est la toute première erreur que j’ai rencontrée lors de l’installation de Sitecore avec Docker. Mais il s’agit d’une erreur purement spécifique à Docker et non liée à Sitecore. Cela se produit lorsque Docker pour Windows nécessite la dernière version du noyau WSL de votre machine Windows. Docker possède certaines configurations et fonctionnalités qui dépendent du noyau WSL et nécessitent la dernière version. Pour résoudre cette erreur, il nous suffit d’exécuter la commande ci-dessous.
'wsl --update'

Après avoir exécuté cette commande, votre Windows est mis à niveau avec la dernière version de WSL. Vous pouvez consulter les journaux WSL pour valider le correctif ci-dessus. Pour récupérer les journaux WSL, vous devez télécharger et exécuter ce script PowerShell collect-wsl-logs.ps1 avec des droits administratifs.

« aucun manifeste correspondant pour Windows/amd64 dans les entrées de la liste des manifestes« 

Une autre erreur que j’ai reçue lors de l’exécution de la commande docker-compose affiche le message d’erreur ci-dessus dans la console.

Ceci n’est pas non plus lié à Sitecore et est purement spécifique à Docker. La cause première de ce problème est que votre Docker pour Windows s’exécute avec des conteneurs Linux au lieu de conteneurs Windows. Si vous voyez l’option « Passer aux conteneurs Windows » après un clic droit sur l’icône Docker, cela signifie que votre Docker fonctionne avec des conteneurs Linux. Donc, pour résoudre ce problème, nous devons basculer les conteneurs vers Windows.

Après être passé aux conteneurs Windows, suivez les étapes ci-dessous pour le contourner en exécutant le démon Docker.

1. Allez dans Paramètres
2. Sélectionnez l’onglet « Docker Engine »
3. Mettez à jour les paramètres ci-dessous dans le démon Docker – {« expérimental » : true}
4. Après avoir effectué toutes les modifications mentionnées. N’OUBLIEZ PAS de redémarrer le Docker.

« une image basée sur Windows version 10.0.20348 est incompatible avec un hôte 10.0.19044»

Après avoir résolu le problème ci-dessus, spécifique à Docker, j’ai rencontré une erreur supplémentaire, et cette fois elle est spécifique à Sitecore. Tout en exécutant le même docker-compose up -d commande, il affiche le message d’erreur ci-dessus dans la console.

J’ai reçu cette erreur car l’image Docker et ma machine hôte sont incompatibles. Pour résoudre cette erreur, nous devons d’abord vérifier s’il existe une mise à jour Windows sur la machine hôte. Une fois que nous avons mis à jour Windows de la machine hôte, nous devons mettre à jour quelques paramètres du fichier .env. Veuillez ouvrir le fichier .env, disponible dans votre dossier src, et mettre à jour la ligne ci-dessous en fonction de vos versions Windows et Sitecore.

SITECORE_VERSION=10.3-ltsc2019 -- line no 3
EXTERNAL_IMAGE_TAG_SUFFIX=ltsc2019 -- line no 36

Ici vous pouvez vérifier les versions compatibles avec votre Windows,
Nano Serveur par Microsoft | Centre Docker

Après avoir apporté ces modifications dans le fichier .env, j’ai réexécuté la commande docker-compose, et cette fois elle s’est exécutée avec succès sans aucune erreur.

J’espère que cet article de blog vous aidera à résoudre l’erreur ci-dessus. Récemment, j’ai installé l’instance Sitecore 10.x avec JSS et j’ai rencontré quelques erreurs, je vais donc partager ces erreurs et leur correctif dans mes prochains blogs. Alors restez à l’écoute!

Bonne installation !