Installation en tant qu'application OpenShift#
L'ID que vous utilisez pour installer le produit doit être capable d'apporter des modifications à l'environnement hôte. Les outils requis par tous les scénarios d'installation comprennent les éléments suivants :
-
Docker installé sur le système hôte.
Remarque : Si vous utilisez Docker pour Windows, assurez-vous qu'il utilise des conteneurs de type Linux. HCL™ Accelerate ne prend pas en charge les conteneurs de type Windows.
-
Connexion Internet. Lors de l'installation, les fichiers et les images de conteneur sont extraits des emplacements distants. Si vous n'êtes pas en mesure d'accéder à Internet au cours de l'installation, vous pouvez télécharger les fichiers au préalable et effectuer l'installation hors ligne. HCL Accelerate est compatible avec les navigateurs suivants : Chrome, Firefox et Edge.
Remarque : Procédure pour extraire les images de conteneur du référentiel public vers votre référentiel privé :
Utilisez la commande
pull
pour extraire les images du conteneur du référentiel public.$ docker pull public repo
Utilisez la commande
tag
pour baliser le référentiel public et privé.$ docker tag public repo private repo
Utilisez la commande
push
pour envoyer des images de conteneur vers un référentiel privé.$ docker push private repo
Toutes les images de conteneur sont extraites du référentiel public vers le référentiel privé.
Remarque : Les fichiers d'installation utilisés pour l'installation en ligne sont différents de ceux utilisés pour l'installation connectée à Internet. Assurez-vous de télécharger le fichier adéquat pour votre environnement d'installation.
En plus des exigences relatives à tous les scénarios d'installation, les éléments suivants sont requis :
- Instance client OpenShift configurée. Cette rubrique utilise Minishift pour les installations d'instances locales.
- Outil de ligne de commande OpenShift, installé sur le client.
- Créez un projet OpenShift sur lequel vous pouvez installer HCL Accelerate.
- Accès au certificat au format PEM et à la clé privée que vous pouvez utiliser pour configurer des routes OpenShift.
- Nœud maître : 2 vCPU, 8 Go de RAM, 30 Go de stockage.
- Autres nœuds : 1 vCPU, 8 Go de RAM, 15 Go de stockage.
Obtenez une clé. La clé vous permet de terminer l'installation. Rendez-vous sur le portail Web HCL Accelerate afin d'obtenir votre clé. Une fois le formulaire complété, vous recevrez un e-mail de confirmation avec une clé d'accès. Stockez la clé à un emplacement facilement accessible, car vous allez l'utiliser lors de l'installation.
Vous allez installer HCL Accelerate dans un projet OpenShift. Lors de l'installation, vous configurez une base de données MongoDB pour votre projet, ajoutez le service HCL Accelerate à votre catalogue de projets OpenShift, puis créez une route qui rend l'application HCL Accelerate accessible au public.
Si vous devez modifier les paramètres du projet, modifiez le fichier velocity-se-<version number>-openshift.yaml. HCL Accelerate utilise ce fichier pour configurer le projet OpenShift. Le fichier velocity-se-<version number>-openshift.yaml est copié dans votre environnement local lors de l'installation.
-
Téléchargez le fichier d'installation correspondant à votre environnement.
Remarque : Pour les installations macOS et Linux, définissez les droits appropriés avant d'exécuter le fichier :
sudo chmod +x
.- Linux : https://hcl-velocity-binaries.s3.amazonaws.com/accelerate-hcl-install-latest-linux
- Windows : https://hcl-velocity-binaries.s3.amazonaws.com/accelerate-hcl-install-latest-win.exe
- Mac OS : https://hcl-velocity-binaries.s3.amazonaws.com/accelerate-hcl-install-latest-macos
- Exécutez le fichier exécutable téléchargé.
-
Lorsque l'invite Veuillez saisir votre clé d'accès Velocity s'affiche, entrez votre clé d'accès la version de SE.
Si vous avez déjà installé une version de SE, la clé déjà configurée est la valeur par défaut.
Remarque : Assurez-vous d'avoir entré la clé correspondant à la version adéquate.
-
Pour appliquer des limites aux ressources, définissez les valeurs des indicateurs de ressource pour tous les conteneurs et utilisez l'indicateur
customConfigFile
pour définir le chemin du fichier JSON qui contient les valeurs spécifiées pour les services individuels.Voici un exemple de commande d'installation utilisant les nouveaux indicateurs :
/velocity-ibm-install-1-5-5-macos --resourcesRequestsCpu 60m --customConfigFile resources.json
Vous pouvez utiliser les indicateurs suivants dans la commande :
resourceLimitsMemory
resourceLimitscpu
resourceRequestMemory
resourceRequestcpu
customConfigFile
Remarque : Voici un exemple de coderesources.json
.
{ "resources": { "limits": { "memory": { "default": "1Gi", "application-api": "3Gi" }, "cpu": { "application-api": "2" }, }, "requests": { "memory": { "release-events-ui": "256Mi" }, "cpu": { "multi-app-pipeline-api": "45m", "release-events-ui": "55m" } } } }
-
-
Terminez l'installation locale en répondant aux invites décrites dans la procédure suivante.
Lorsque le script démarre, vous êtes invité à accepter la licence. Vous pouvez explicitement accepter la licence sans l'afficher, en joignant le paramètre suivante à la commande :
./<accelerate-installation-file\> **--license=accept**
-
Lorsque l'invite Entrez votre clé de chiffrement ou laissez vide pour utiliser la valeur par défaut. La clé doit comprendre au moins 8 caractères s'affiche, entrez votre clé de chiffrement ou laissez vide pour utiliser la clé de chiffrement par défaut.
Remarque : La clé de chiffrement doit comprendre au moins 8 caractères. Enregistrez la clé de chiffrement afin de l'utiliser pour d'autres mises à niveau.
-
Lorsque l'invite Choisissez la plateforme s'affiche, sélectionnez
OpenShift
. -
Lorsque l'invite Veuillez saisir votre clé d'accès HCL Accelerate s'affiche, indiquez où placer les fichiers d'installation.
-
Lorsque l'invite Nom de projet Openshift s'affiche, saisissez le nom du projet créé précédemment.
-
Lorsque l'invite Nom de l'utilisateur de l'installation s'affiche, saisissez votre ID OpenShift.
-
Lorsque l'invite Choisissez-en un s'affiche, sélectionnez Installer une nouvelle instance.
Si vous effectuez une mise à niveau, voir Mise à niveau des installations OpenShift.
Les fichiers que vous utilisez pour terminer l'installation sont copiés vers le répertoire spécifié.
-
-
Dans le répertoire dans lequel vous avez installé les fichiers de produit, exécutez
oc apply -f pre-install-for-cluster.yaml
, puisoc apply -f pre-install-for-namespace.yaml
.Remarque : L'utilisateur doit être autorisé à créer des ressources au niveau du cluster pour pouvoir exécuter
oc apply -f pre-install-for-cluster.yaml
. L'utilisateur doit être autorisé à créer des ressources au niveau de l'espace de nom pour exécuteroc apply -f pre-install-for-namespace.yaml
.La propriété
user
dans le fichierpre-install-for-cluster.yaml
etpre-install-for-namespace.yaml
est 'admin' par défaut. Assurez-vous que la propriétéuser
contient l'identifiant utilisateur OpenShift correct. -
Depuis le tableau de bord OpenShift, créez un projet pour HCL Accelerate.
Lorsque le projet est créé, dans la zone Mes projets, sélectionnez le projet, puis cliquez sur Parcourir le catalogue.
-
Installez le modèle de service HCL Accelerate dans le catalogue de projets en procédant comme suit :
-
Depuis le catalogue de projets OpenShift, utilisez la commande Ajouter au projet > Importer YAML/JSON, puis importez le fichier velocity-se-<version number>-openshift.yaml.
Le fichier yaml a été installé à l'étape précédente.
-
Sélectionnez Créer, désélectionnez la case Traiter le modèle, puis cochez Sauvegarder le modèle.
Après avoir actualisé le navigateur, le service HCL Accelerate s'affiche dans le catalogue de projets OpenShift.
-
-
Créez un service MongoDB pour le projet en procédant comme suit :
-
Depuis le catalogue de projets OpenShift, sélectionnez MongoDB.
-
Sur la page de configuration de MongoDB, cliquez sur Suivant, puis, dans le champ Mot de passe Admin MongoDB, saisissez un mot de passe pour l'utilisateur Admin.
Vous pouvez accepter les valeurs par défaut pour les autres paramètres.
Remarque : L'utilisateur doit être un utilisateur Admin et non l'utilisateur de MongoDB.
-
Cliquez sur Créer.
-
Sur la page La base de données MongoDB a été créée, copiez la chaîne
Connection URL
et stockez-la à un emplacement facile d'accès, puis fermez la fenêtre de configuration.Vous utilisez la chaîne de connexion pour configurer votre projet HCL Accelerate.
-
-
Créez un service HCL Accelerate en procédant comme suit.
-
Depuis le catalogue de projets, sélectionnez Velocity .
La fenêtre de configuration de Velocity s'affiche.
-
Cliquez sur Suivant, puis, dans le champ Nom, saisissez un nom de service.
-
Dans le champ Nom d'hôte, entrez le nom de l'hôte du service.
Le nom d'hôte doit se rapporter à un nom sur votre serveur DNS ou dans le fichier hosts du serveur. Sous Linux, l'emplacement du fichier est etc/hosts, et C:\Windows\System32\drivers\etc\hosts sous Windows.
Remarque : Le nom d'hôte ne peut pas être une adresse IP.
-
Dans le champ Clé d'accès, collez la clé d'accès HCL Accelerate reçue précédemment.
-
Dans le champ URL Mongo, collez la chaîne de connexion MongoDB correspondant au service MongoDB.
N'utilisez pas le nom d'utilisateur ou de base de données par défaut. Utilisez l'utilisateur Admin et le mot de passe créés pour l'administrateur. Par exemple :
mongodb://admin:password@mongodb
Remarque : Lorsque vous copiez l'exemple de code de connexion, veillez à supprimer la partie
sampleDB
du code copié.Si vous vous connectez à une base de données MongoDB authentifiée, vous pouvez utiliser authSource pour spécifier la base de données dans laquelle les utilisateurs authentifiés sont définis. Par exemple, si l'utilisateur admin est défini dans la base de données admin, vous pouvez utiliser mongodb://root:password@velocity-mongo-mongodb?authSource=admin. Si vous ne souhaitez pas utiliser l'utilisateur Admin, connectez-vous à la base de données MongoDB et utilisez une commande similaire à celle-ci pour accorder des droits Admin à l'utilisateur :
db.grantRolesToUser( "mongo", ["readWriteAnyDatabase", "dbAdminAnyDatabase", "clusterAdmin"] )
-
Acceptez les valeurs par défaut des autres paramètres, puis cliquez sur Créer.
-
-
Créez une route en procédant comme suit :
-
Depuis le tableau de bord du projet, cliquez sur Applications > Routes > Créer une route.
-
Dans le champ Nom, entrez un nom à donner à la route.
-
Dans le champ Nom d'hôte, saisissez le nom d'hôte que vous avez indiqué précédemment pour HCL Accelerate.
-
Dans le champ Service, sélectionnez le service
velocity-router
. -
Cochez Route sécurisée.
-
Dans la liste Résiliation TLS, sélectionnez
Edge
. -
Téléchargez votre certificat au format PEM ou, sur la liste Trafic non sécurisé, sélectionnez
Allow
. -
Cliquez sur Créer.
La nouvelle route est répertoriée sur la page Routes.
-
Lorsque l'installation est terminée, ouvrez HCL Accelerate en cliquant sur le lien du nom de la route. Le nom d'utilisateur par défaut est admin et le mot de passe par défaut est admin.
Sujet parent : Installation