Linux

Déploiement d'un environnement de création HCL Commerce version 9.0.0.0 à 9.0.1.17 avec Docker Compose

Déployez un environnement de création simple HCL Commerce pour créer un environnement où les administrateurs de site et les utilisateurs professionnels peuvent mettre à jour le catalogue de magasin ou stocker des configurations à l'aide d'outils HCL Commerce.Avec ce déploiement d'environnement de création simple, vous préparez un conteneur de recherche en tant que nœud search_master. L'environnement opérationnel que vous utilisez avec cet environnement de création doit inclure un search_repeater et un search_slave qui communique avec search_master dans l'environnement de création.

Avant de commencer

  1. Assurez-vous que les images Docker sont chargées dans votre registre Docker privé. Si vous êtes administrateur responsable de votre registre Docker, voir Téléchargement du logiciel HCL Commerce.
  2. Assurez-vous que votre machine dispose des exigences minimales d'un processeur de 2 cœurs, 8 Go de RAM et 50 Go d'espace disque libre.
  3. Assurez-vous que vous déployez l'environnement de création sur une machine qui n'exécute pas un environnement HCL Commerce existant.
  4. Préparez une base de données Db2 pour une utilisation avec HCL Commerce ou Préparez une base de données Oracle pour une utilisation avec HCL Commerce.
  5. Chargez le schéma de base de données de création HCL Commerce en définissant type=staging.

Procédure

  1. Installez Docker.
    1. Installez la version 19.03.8 ou une version ultérieure de Docker.
    2. Installez la version 1.24.1 ou une version ultérieure de Docker Compose.
    3. Envisagez de créer un groupe Docker Unix.
      Remarque : Vous devez ajouter le préfixe sudo aux commandes Docker si vous ne créez pas un groupe Docker Unix. Pour plus d'informations, voir .
  2. Téléchargez l'exemple de fichier Docker Compose suivant en fonction de la configuration de la base de données.
    OptionExemple Docker Compose
    Exécution de la base de données dans un conteneur Docker Téléchargez le fichier suivant :
    Remarque : Si le lien ne vous invite pas à enregistrer, cliquez avec le bouton droit et enregistrez le fichier. Ouvrez le fichier dans un éditeur de code source pour afficher et modifier au format YAML approprié.

    Les fichiers YAML sont des exemples partant du principe que vous utilisez une image Docker Db2. Assurez-vous que vous mettez à jour tous les paramètres qui se trouvent entre crochets <>. Les exemples de fichiers sont commentés avec des descriptions des paramètres.

    Base de données s'exécutant sur un serveur standard (et non sur un conteneur Docker) Téléchargez le fichier suivant :
    Remarque : Si le lien ne vous invite pas à enregistrer, cliquez avec le bouton droit et enregistrez le fichier. Ouvrez le fichier dans un éditeur de code source pour afficher et modifier au format YAML approprié.
    Assurez-vous que vous mettez à jour tous les paramètres qui se trouvent entre crochets <>. Les exemples de fichiers sont commentés avec des descriptions des paramètres.
  3. Oracle Téléchargez le fichier java/ojdbc8.jar pilote JDBC Oracle à partir du dossier d'installation Oracle et placez-le sous le répertoire où vous avez enregistré le fichier Docker Compose.
  4. Dans une interface de ligne de commande, accédez à l'endroit où vous avez enregistré le fichier Docker Compose.
  5. Exécutez la commande applicable pour déployer les conteneurs Docker en fonction du fichier Docker Compose dont vous disposez.
    • docker-compose -f docker-compose-auth.yml up -d
    • docker-compose -f docker-compose-auth-extdb.yml up -d
    Remarque :
    • Si les images ne sont pas déjà sur votre ordinateur, la commande télécharge des images Docker à partir de votre registre. Les images font environ 10 Go au total. La durée de cette commande dépend donc de votre connexion Internet.
    • Chaque fois que votre ordinateur virtuel Docker est redémarré, vous devez redémarrer manuellement les conteneurs Docker en réexécutant cette commande docker-compose -f <file> up -d.
  6. Si vous avez chargé des exemples de données dans votre base de données, créez l'index de recherche.
    1. Envoyez la demande REST suivante (POST) et ajoutez l'authentification de base avec l'identifiant de connexion spiuser et le mot de passe pour le spiuser.
      Vous pouvez créer l'index de recherche à l'aide de l'une des méthodes suivantes :
      • En utilisant l'utilitaire curl. Utilisez la commande curl suivante avec le mot de passe en texte brut spiuser. .
        curl -k -u spiuser:spiuserPassword -X POST https://transaction_server_hostname:5443/wcs/resources/admin/index/dataImport/build?masterCatalogId=10001
      • En utilisant un plug-in de navigateur tel que HttpRequester (pour Mozilla Firefox) ou Postman (pour Google Chrome). Utilisez l'URL suivante et authentifiez-vous avec l'utilisateur spiuser et le mot de passe en texte brut spiuser.
        https://transaction_server_hostname:5443/wcs/resources/admin/index/dataImport/build?masterCatalogId=10001
      Important : Pour définir un mot de passe pour le spiuser, voir Définition du mot de passe spiuser dans vos images Docker.

      Notez le jobstatusId que vous obtenez dans la réponse, par exemple, {"jobstatusId":"xxxxx"}.

    2. Utilisez le jobstatusId et envoyez la demande REST suivante (GET) pour vérifier l'état d'exécution de la demande.
      Encore une fois, utilisez l'authentification de base avec spiuser et le mot de passe spiuser.
      https://<search_server_hostname>:3738/search/admin/resources/index/build/status?jobStatusId={jobstatusId}
      En cas de succès, vous obtiendrez le statut Status: 200 OK et une réponse similaire à l'exemple suivant :
      response content: {
      "finishTime":"2017-08-01 06:49:31.395759",
      "lastUpdate":"2017-08-01 06:49:31.395759",
      "progress":"100%",
      "jobStatusId":"14003",
      "startTime":"2017-08-01 06:48:17.369909",
      "message":"Indexing job started for masterCatalogId:10,001. Indexing job finished successfully for masterCatalogId:10001.",
      "jobType":"SearchIndex",
      "properties":"[]",
      "status":"0"}
  7. Assurez-vous que vous pouvez vous connecter au centre de gestion.
    • https://<transaction_server_hostname>:8000/lobtools/cmc/ManagementCenter
  8. Si vous avez chargé des exemples de données dans votre base de données de création, assurez-vous de pouvoir consulter l'exemple de magasin Aurora.
    • https://<store_server_hostname>:8443/wcs/shop/en/auroraesite

Que faire ensuite