Installer les composants du conteneur HCL Digital Experience 9.5 - Tech Preview

Cette section donne une présentation générale de l'architecture et de la procédure d'installation et de configuration d'HCL Digital Experience 9.5 Experience API - Tech Preview, d'HCL Digital Experience 9.5 Content Composer - Tech Preview et d'HCL Digital Experience 9.5 Digital Asset Management - Tech Preview.

Architecture et topologie de niveau supérieur

Figure 1. Architecture de niveau supérieur

Prérequis

Installez et configurez la version de mise à jour de conteneur HCL Digital Experience 9.5 CF_173 ou une version ultérieure, sur Amazon Elastic Kubernetes Service (EKS) ou sur la plateforme de conteneur Red Hat OpenShift à l'aide des procédures de la section Déploiement

Remarque : Il est recommandé d'installer HCL Digital Experience 9.5 Experience API - Tech Preview, d'HCL Digital Experience 9.5 Content Composer - Tech Preview et d'HCL Digital Experience 9.5 Digital Asset Management - Tech Preview dans un environnement HCL Digital Experience 9.5 non destiné à la production (test).

Installation des composants Tech Preview

Suivez ces étapes pour installer vos composants HCL Digital Experience 9.5 CF_173 Experience API ou version ultérieure - Tech Preview, d'HCL Digital Experience 9.5 Content Composer - Tech Preview et d'HCL Digital Experience 9.5 Digital Asset Management - Tech Preview.

Vérifiez que vous pouvez accéder à Practitioner Studio HCL Digital Experience 9.5 CF_173 ou version ultérieure en vous connectant à votre interface HCL Digital Experience 9.5 Practitioner Studio. Voir la rubrique HCL Digital Experience 9.5 Practitioner Studio pour plus d'informations.
Téléchargez et extrayez les composants HCL Digital Experience 9.5 Tech Preview de vos autorisations Digital Experience depuis HCL Software License Portal vers le système de fichiers local.
Télécharger le nom du package : hcl-dx-tech-preview-v95-CF173.zip ou version ultérieure tech-preview-v95-CFxx.zip
Contenu :
- HCL Experience API - Tech Preview (image Docker) - hcl-dx-ringapi-image-v0.6.0_xxxxxxxx-xxxx.tar.gz
- HCL Digital Asset Management - Tech Preview (opérateur) - hcl-dx-medialibrary-operator-image-v95_CF173_xxxxxxxx-xxxx.tar.gz
- HCL Digital Experience Digital Asset Management - Tech Preview (image Docker) - hcl-dx-media-library-image-v0.1.0_xxxxxxxx-xxxx.tar.gz
- HCL Digital Experience Digital Asset Management - Tech Preview (processeur d'images) - hcl-dx-image-processor-image-v1.0.0_xxxxxxxx-xxxx.tar.gz
- HCL Content Composer - Tech Preview (image Docker) - hcl-dx-content-ui-image-v0.2.0_xxxxxxxx-xxxx.tar.gz
- Postgres - hcl-dx-postgres-image-11.5_xxxxxxxx-xxxx.tar.gz
Extrayez les images du système de fichiers local.
Ouvrez une fenêtre de terminal et accédez au répertoire racine des images du package extrait.

Chargez les conteneurs dans votre référentiel Docker sur Amazon EKS ou la plateforme Red Hat OpenShift.

Par exemple:

Docker load < hcl-dx-ringapi-image-v0.6.0_xxxxxxxx-xxxx.tar.gz

Docker load < hcl-dx-medialibrary-operator-image-v95_CF173_xxxxxxxx-xxxx.tar.gz

Docker load < hcl-dx-media-library-image-v0.1.0_xxxxxxxx-xxxx.tar.gz

Docker load < hcl-dx-content-ui-image-v0.2.0_xxxxxxxx-xxxx.tar.gz

Docker load < hcl-dx-image-processor-image-v1.0.0_xxxxxxxx-xxxx.tar.gz

Docker load < hcl-dx-postgres-image-11.5_xxxxxxxx-xxxx.tar.gz

Remarque : -i ou < fonctionne pour la commande de chargement. Si vous rencontrez une erreur lorsque vous utilisez un de ces éléments, essayez d'exécuter la commande en utilisant l'autre élément.

Installez les composants HCL Digital Experience 9.5 CF_173 ou version ultérieure, Experience API, Content Composer et Digital Asset Management Tech Preview.
Remarque : HCL Experience API - Tech Preview doit être installé pour accéder et utiliser HCL Content Composer - Tech Preview et les fonctionnalités d'HCL Digital Asset Management - Tech Preview.
Vérifiez que votre instance de conteneur HCL Digital Experience 9.5 CF_173 ou version ultérieure est opérationnelle sur Amazon EKS ou Red Hat OpenShift.
Mettez à jour la mappe de configuration de déploiement de conteneur HCL Digital Experience 9.5 CF_173 pour déployer les composants Tech Preview d'HCL Experience API, HCL Content Composer et HCL Digital Asset Management CF_173 ou version ultérieure.
Remarque : La valeur du nom de mappage de configuration utilisée pour prendre en charge les composants Tech Preview de CF_173 ou version ultérieure doit être identique au déploiement HCL Digital Experience 9.5 CF_173 ou version ultérieure. Par défaut, la valeur du nom de déploiement du mappage de configuration est dx-deployment.
Créez un fichier YAML avec les paramètres de mappage de configuration suivants
```
kind: DxDeployment
```
```
metadata:
  name: dx-deployment
```
Utilisez l'exemple de fichier YAML suivant (dx-deploy-config-map.yaml) pour déployer les composants Tech Preview d'HCL Experience API, HCL Content Composer et HCL Digital Asset Management CF_173 ou version ultérieure. Si vous déployez les composants Tech Preview d'HCL Digital Asset Management et Content Composer CF18, remplacez leurs noms de fichier dans les exemples de lignes de services de fichiers YAML utilisés.
Remarque : Il est possible de déployer les services pour HCL Experience API et HCL Content Composer et/ou Digital Asset Management Tech Previews en supprimant les lignes de service HCL Content Composer ou HCL Digital Asset Management du fichier YAML.
```
kind: ConfigMap
```
```
metadata:
  name: dx-deployment
  namespace: your-namespace
```
```
apiVersion: v1
```
```
data:
  dx.deploy.contentui.enabled: "true"
  dx.deploy.contentui.image: portal/content-ui
  dx.deploy.contentui.tag: v0.2.0_20200323-2149_95_CF173

  dx.deploy.experienceapi.enabled: "true"
  dx.deploy.experienceapi.image: portal/api/ringapi
  dx.deploy.experienceapi.tag: v0.6.0_20200318-1556_95_CF173 

  dx.deploy.medialibrary.enabled: "true"
  dx.deploy.medialibrary.imgprocessor.image: portal/image-processor
  dx.deploy.medialibrary.imgprocessor.tag: v1.0.0_20200319-1731_rohan_release_95_CF173

  dx.deploy.medialibrary.medialibrary.image: portal/media-library
  dx.deploy.medialibrary.medialibrary.tag: v0.1.0_20200325-0746_rohan_release_95_CF173

  dx.deploy.medialibrary.operator.image: hcl-medialibrary-operator
  dx.deploy.medialibrary.operator.tag: 9.5.ml.next

  dx.deploy.medialibrary.persistence.image:  portal/persistence/postgres
  dx.deploy.medialibrary.persistence.tag: 11.5_20200323-1800_release_95_CF173

  dx.deploy.medialibrary.storageclass: dx-deploy-stg
  dx.deploy.medialibrary.volume: ml-volume-1
```
Les configurations dx.deploy.contentui.enabled et dx.deploy.experienceapi.enabled indiquent à l'opérateur de déployer HCL Content Composer et HCL Experience API Tech Previews. Le paramètre par défaut consiste à utiliser le même référentiel que le déploiement principal du conteneur HCL Digital Experience 9.5 CF_173.
Remarques sur ce fichier YAML :
- Le déploiement des composants HCL Content Composer and HCL Experience API Tech Preview crée :
  - Les déploiements s'appellent dx-deployment-contentui et dx-deployment-ringapi.
  - Sert dx-deployment-service-content-ui et dx-deployment-service-ring-api, et un itinéraire pour chaque.
- dx.deploy.medialibrary.enabled indique à l'opérateur de déployer le composant HCL Digital Asset Management. Remarque : il y a 4 ensembles requis de paramètres image/balise :
  - Les variables d'opérateur HCL Digital Asset Management utilisent ce préfixe dx.deploy.medialibrary.operator.
  - Le magasin de données Postgres utilise dx.deploy.medialibrary.persistence.
  - Les services de bibliothèque HCL Digital Asset Management utilisent dx.deploy.medialibrary.medialibrary.
  - Le processeur d'image utilise dx.deploy.medialibrary.persistence.
  Les deux derniers paramètres de l'exemple de fichier YAML fournissent la classe et le volume de stockage (doivent être ReadWriteMany) pour le composant HCL Digital Asset Management - Tech Preview. C'est là que la couche de persistance conserve la couche du magasin de données.
  Un volume d'approvisionnement automatique supplémentaire est créé pour le service de bibliothèque HCL Digital Asset Management. Si ce volume n'est pas présent, les images sont perdues et s'affichent vides si/lorsque la bibliothèque HCL Digital Asset Management est redémarrée.
  Les administrateurs peuvent remplacer le référentiel en ajoutant :
```
dx.deploy.contentui.repository
```
  En outre, les paramètres par défaut suivants peuvent être ajustés :
  - dx.deploy.contentui.resources.cpurequest, the default is 1.
  - dx.deploy.contentui.resources.cpulimit, the default is 3.
  - dx.deploy.contentui.resources.memoryrequest, the default is 2G.
  - dx.deploy.contentui.resources.memorylimit, the default is 4G.
  - dx.deploy.experienceapi.resources.cpurequest, the default is 1.
  - dx.deploy.experienceapi.resources.cpulimit, the default is 3.
  - dx.deploy.experienceapi.resources.memoryrequest, the default is 2G.
  - dx.deploy.experienceapi.resources.memorylimit, the default is 4G.
  Les options de configuration supplémentaires ne sont actuellement pas prises en charge.
Déployez le fichier YAML (dx-deploy-config-map.yaml) en exécutant la commande :
```
kubectl apply -f dx-deploy-config-map.yaml -n your-namespace
```
Arrêtez et redémarrez votre déploiement de conteneur HCL Digital Experience 9.5 CF_173 ou version ultérieure.
Remarque : Si vous ajoutez les Tech Previews pour HCL Content Composer, HCL Digital Asset Management et HCL Experience API à un environnement de test HCL Digital Experience 9.5 existant (doit être au niveau 9.5 CF_173 ou supérieur), vous devez arrêter le déploiement et le redémarrer avec une (1) réplique. Une fois qu'il est complètement démarré, vous pouvez l'adapter en toute sécurité aux instances N.
Rappel : Il n'est pas conseillé de déployer les composants Tech Preview dans un déploiement HCL Digital Experience 9.5 de production.
Accédez aux composants Tech Preview d'HCL Content Composer et d'HCL Digital Asset Management en accédant à Practitioner Studio > Contenu Web > Contenu, ou Practitioner Studio > Documents numériques.
```
https://your-portal.net/wps/myportal/Practitioner/Web Content/Content Library
```
```
https://your-portal.net/wps/myportal/Practitioner/Digital Assets
```
Accédez à HCL Experience API - Tech Preview Explorer sur l'URL suivante :
```
route location / explorer
```
Par exemple,
```
https://your-host.net/k8s/ns/ml-tests-1/routes
```

Commentaires sur Tech Preview

HCL Digital Experience s'intéresse à votre expérience et vos commentaires issus de votre utilisation de ce logiciel Tech Preview. Pour nous faire part de vos commentaires ou de problèmes concernant vos constatations, veuillez accéder à l'application sur les rapports de commentaires d'HCL Digital Experience 9.5 Tech Preview.