Red Hat OpenShift

Cette section décrit la procédure de déploiement d'HCL Digital Experience à l'aide de Red Hat OpenShift 4.1.

Pourquoi et quand exécuter cette tâche

Suivez ces étapes pour déployer la version de conteneur HCL Digital Experience 9.5 dans OpenShift.
Remarque : Consultez les dernières listes portant sur les fichiers de mise à jour et la version de conteneur HCL DX 9.5 dans la rubrique.Déploiement du conteneur.

Procédure

  1. Téléchargez et extrayez le contenu du package HCL DX OpenShift dans le système de fichiers local. 
    -rw- r--r-- 1 hcl-dx-cloud-operator-image-v95_xxxxxxxx-xxxx.tar.gz
    -rw- r--r-- 1 hcl-dx-core-image-v95_xxxxxxxx-xxxx.tar.gz
    -rw- r--r-- 1 hcl-dx-openshift-scripts-v95_xxxxxxxx-xxxx.zip
    Remarque : Remarque : Si vous utilisez la version de mise à jour de conteneur HCL DX 9.5 CF_171 ou une version ultérieure, le nom de fichier hcl-dx-openshift-v95 est remplacé par hx-dx-cloud. Le changement de nom de fichier affecte également le nom du répertoire pour les étapes ultérieures.
  2. Ouvrez une fenêtre de terminal et accédez au répertoire racine du package extrait.
  3. Chargez le conteneur dans votre référentiel Docker. 
    • docker load < hcl-dx-cloud-operator-image-v95_xxxxxxxx-xxxx.tar.gz
    • docker load < hcl-dx-core-image-v95_xxxxxxxx-xxxx.tar.gz
    Figure 1. Chargement des conteneurs dans votre référentiel Docker.
  4. Extrayez les scripts HCL DX OpenShift. 
    unzip hcl-dx-openshift-scripts-v95_xxxxxxxx-xxxx.zip
    Figure 2. Extraction des scripts OpenShift
  5. Accédez au répertoire des fichiers extraits, ./hcl-dx-openshift-scripts
  6. Installez la définition de ressource personnalisée DxDeployment. (Ne modifiez pas le fichier git_v1_dxdeployment_crd.yaml. Veuillez personnaliser ./deploy/crds/git_v1_dxdeployment_cr.yaml si nécessaire.) Utilisez l'une des commandes suivantes : 
    • './scripts/deployCrd.sh'
    • 'kubectl create -f hcl-dx-openshift-scripts/deploy/crds/git_v1_dxdeployment_crd.yaml'
    Figure 3. Installation de la définition de ressource personnalisée DxDeployment
  7. Créez (ou demandez à l'administrateur OpenShift de s'en charger) un volume persistant où AccessMode doit être ReadWriteMany et où la stratégie de récupération de volume persistant doit être "Retain".
    Figure 4. Volumes persistants
    • Utilisez chown et chgrp pour définir l'utilisateur et le groupe sur ID 1000.
  8. Pour créer l'espace de noms, installez le compte de service de portée du projet, le rôle, la liaison de rôle, l'opérateur et le déploiement, puis exécutez le script deployDx.sh. 
    ./scripts/deployDx.sh NAMESPACE REPLICAS REPOSITORY IMAGENAME IMAGETAG VOLUMENAME STORAGECLASS DBTYPE
    • ESPACE DE NOMS : le projet ou l'espace de noms à créer ou à utiliser pour le déploiement.
    • REPLIQUES : le nombre d'instances initiales pour le déploiement.
    • REPOSITORY : votre référentiel local, le référentiel utilisé par OpenShift/Kubernetes.
    • IMAGENAME : le nom de l'image dxCore, tel qu'il a été ajouté au référentiel ci-dessus.
    • IMAGETAG : la balise de l'image cible ajoutée au référentiel ci-dessus.
    • VOLUMENAME : le volume à utiliser par le déploiement pour la persistance, qui doit utiliser AccessMode ReadWriteMany.
    • STORAGECLASS : le nom de la classe de stockage utilisé pour créer le volume persistant.
    • DBTYPE : le type de base de données. Par défaut, et initialement, il s'agit de Derby. HCL DX 9.5 utilise Apache Derby, Oracle Database, IBM DB2 oU Microsoft SQL Server. Les valeurs acceptables sont derby, oracle, db2 ou msSql.
  9. Voir les sections sous Comprendre le déploiement OpenShift et Personnalisation du déploiement du conteneur.
    Remarque : Pour la version initiale 9.5, vous devez modifier le fichier operator.yaml et vous assurer que IMAGENAME et IMAGETAG sont corrects.
    Mettre à jour
    • Pour mettre à jour le déploiement, exécutez le script updateDx.sh avec les valeurs mises à jour. 
      ./scripts/updateDx.sh NAMESPACE REPLICAS REPOSITORY IMAGENAME IMAGETAG VOLUMENAME STORAGECLASS DBTYPE
      • ESPACE DE NOMS : le projet ou l'espace de noms à créer ou à utiliser pour le déploiement.
      • REPLIQUES : le nombre d'instances initiales pour le déploiement.
      • REPOSITORY : votre référentiel local, le référentiel utilisé par OpenShift/Kubernetes.
      • IMAGENAME : le nom de l'image dxCore, tel qu'il a été ajouté au référentiel ci-dessus.
      • IMAGETAG : la balise de l'image cible ajoutée au référentiel ci-dessus.
      • VOLUMENAME : le volume à utiliser par le déploiement pour la persistance, qui doit utiliser AccessMode ReadWriteMany.
      • STORAGECLASS : le nom de la classe de stockage utilisé pour créer le volume persistant.
      • DBTYPE : le type de base de données. Par défaut, et initialement, il s'agit de Derby.
    Par exemple, une fois la base de données transférée, DBTYPE devra être mis à jour afin que vous puissiez augmenter l'échelle des instances. En outre, une fois la base de données transférée, le nombre de répliques peut être augmenté. II existe des options supplémentaires pour personnaliser le déploiement.
    Figure 5. Exemple de mise à niveau
    Remarque : La même syntaxe est généralement utilisée pour le déploiement. Le script de mise à niveau utilisé est upgradeDx.sh et la balise d'image est modifiée.
    Supprimer
    • A cause de la conception, la suppression de l'ensemble du déploiement nécessite plusieurs étapes.
      • Pour supprimer le déploiement dans un espace de noms spécifique : 
        ./scripts/removeDx.sh NAMESPACE
        • ESPACE DE NOMS : le projet ou l'espace de noms à créer ou à utiliser pour le déploiement.
    • Pour supprimer un espace de noms, utilisez l'une des commandes suivantes :
      • Commandes OpenShift : 
        'oc delete project <project_name>'
         'oc delete -f dxNameSpace_NAMESPACE.yaml' where NAMESPACE is the namespace to be removed
      • Commande Kubernetes :
        'kubectl delete -f dxNameSpace_NAMESPACE.yaml' where NAMESPACE is the namespace to be removed
    • Le volume persistant associé au déploiement doit être nettoyé par votre administrateur. Pour réutiliser un volume persistant, reportez-vous aux étapes suivantes :
      • Ouvrez le volume persistant dans un éditeur visuel (vi) à l'aide du
        • Commande OpenShift : 
          oc edit pv your_namespace
        • Commande Kubernetes : 
          kubectl edit pv your_namespace
      • Supprimez la section claimRef. 
        claimRef:
   apiVersion: v1
   kind: PersistentVolumeClaim
   name: dx-deploy-pvc
   namespace: your_namespace
   resourceVersion: "488931120"
   uid: ebd58361-0e2a-11ea-b02e-02f8fe687954
      • Assurez-vous de recevoir le message 'persistentvolume/your_namespace edited'.
      • Vous devrez peut-être supprimer manuellement toutes les données restantes du déploiement précédent.
    Pour plus d'informations, reportez-vous aux sections suivantes :