Déploiement d'images Docker mises à jour à l'aide de Docker Compose (pour une utilisation hors production)

Les mises à jour pour les environnements de production HCL Commerce sont livrées sous forme d'images Docker. Pour mettre à jour votre environnement de production, téléchargez les nouvelles images et reconstruisez-les en tant qu'images personnalisées pour inclure votre code personnalisé. Vous déployez ensuite les conteneurs personnalisés.

Before you begin

Assurez-vous que votre registre Docker privé est mis à jour avec les dernières images Docker,
Exécutez l'utilitaire updatedb pour mettre à jour votre base de données.
A partir de HCL Commerce 9.1.14.0, les images de conteneurs d'applications sont conçues pour être exécutées par défaut en tant qu'utilisateur non root. Cette modification peut potentiellement faire échouer votre déploiement personnalisé. Vous devez donc passer ce changement et ses impacts potentiels en revue. Pour plus d'informations, voir HCL Commerce utilisateurs et privilèges liés aux conteneurs.

About this task

Le processus de déploiement de HCL Commerce avec Docker Compose a été mis à jour dans l'édition 9.1.6.0.

Les améliorations sont les suivantes :

Une structure de répertoires simplifiée pour les volumes montés.
- Pour faciliter l'importation de fichiers essentiels dans vos images Docker sans avoir à créer ou recréer des images personnalisées ;
- Pour faire perdurer les données de démonstration de HCL Commerce si jamais vos conteneurs sont mis hors ligne ou redémarrés.
- Déploiement automatisé d'images Docker à utiliser dans un HCL Commerce development environment.
Pour plus d'informations sur les volumes montés, voir Structure et contenu du répertoire /volumes/ du déploiement Docker Compose.
Automatisation améliorée du déploiement. Il suffit de mettre à jour les informations d'environnement requises et d'exécuter un script pour configurer et déployer HCL Commerce et les applications associées. Cela évite d'avoir à éditer manuellement vos fichiers de déploiement, ce qui peut entraîner des erreurs.
Pour plus d'informations sur la configuration de déploiement, voir Fichier de configuration env.sh pour le déploiement de Docker Compose.

En raison de ces améliorations, la procédure suivante varie d'une édition à l'autre.

Procedure

Nettoyez tout déploiement existant.
1. Mettez fin à tout déploiement actif.
  Si vous utilisez une édition HCL Commerce 9.1.6.0 ou supérieure, utilisez le script de démontage, teardown.sh, ou la commande docker-compose down.
  
  Pour plus d'informations, voir la description du script de démontage dans Déploiement d'HCL Commerce version 9.1.6.0 ou supérieure à l'aide de Docker Compose (pour une utilisation hors production).
  Si vous utilisez Docker Compose avec une version de HCL Commerce antérieure à la version 9.1.6.0,
```
docker-compose -f path_to_compose_yml stop
```
2. Supprimez les anciens conteneurs.
  Par exemple, exécutez l'une des commandes suivantes :
  - Si votre base de données s'exécute dans un conteneur Docker et que le conteneur est défini dans votre fichier YML Docker Compose, supprimez tous les conteneurs à l'exception du conteneur de base de données. Si vous supprimez le conteneur de base de données, vous perdez vos données.
    Par exemple, pour un environnement de création, avec une solution de recherche basée sur Solr,
    docker-compose -f path_to_compose_yml rm redis txn web tooling-web search_master store
  - Si votre base de données ne s'exécute pas dans un conteneur Docker, vous pouvez utiliser la commande suivante.
```
docker-compose -f path_to_compose_yml rm
```

Mettez à jour votre environnement et déployez la dernière version des conteneurs HCL Commerce.

Si vous utilisez HCL Commerce version 9.1.6.0 ou supérieure :
Suivez la procédure définie dans Déploiement d'HCL Commerce version 9.1.6.0 ou supérieure à l'aide de Docker Compose (pour une utilisation hors production).

Si vous utilisez une version de HCL Commerce antérieure à la version 9.1.6.0 :

Mettez à jour le déploiement avec des images Docker plus récentes.

Ouvrez vos fichiers YML Docker Compose existants que vous avez utilisés pour déployer vos environnements de production.

Mettez à jour le chemin d'accès de l'image dans le fichier YML pour pointer vers la nouvelle image Docker.

Par exemple, pour l'image Docker du serveur de transaction (ts-app), si vous avez marqué l'image mise à jour comme 9.0.0.1,

Déploiement à l'aide de Docker Compose
	Exemple
Si vous tirez des images du registre Docker privé de votre organisation	`image: Private_Docker_registry/library/ts-app:9.0.0.1`
Si vous avez utilisé `docker load` pour charger les images Docker localement	`image: commerce/ts-app:9.0.0.1`

Extrayez les nouvelles images et déployez de nouveaux conteneurs.
```
docker-compose -f path_to_compose_yml up -d
```

Vérifiez que le déploiement exécute des conteneurs mis à jour.
1. Exécutez la commande suivante :
```
docker ps
```
  Assurez-vous que les balises de conteneur Docker sont les mêmes que la balise que vous avez définie dans votre fichier YML de déploiement.
2. Accédez à chaque conteneur et exécutez la commande viewlabels.
  Par exemple,
```
docker exec -it container_name bash /SETUP/bin/viewlabels
```
  Assurez-vous que toutes les étiquettes des conteneurs ont le même horodatage.