Installation sur ICP#
Installez HCL™ Accelerate dans un cluster Kubernetes sur ICP.
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.
Avant de démarrer l'installation, assurez-vous que les applications suivantes sont installées dans l'environnement cible :
- Kubectl installé sur le client.
- Helm version 2.6.0 ou ultérieure sur client.
- Compte IBM Cloud Private et une instance client prête à l'emploi. ICP version 3.10 ou ultérieure est pris en charge.
- Client de ligne de commande ICP installé sur l'hôte.
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 cluster Kubernetes sur ICP. Ces commandes extraient les images HCL Accelerate depuis un référentiel GitHub et les placent dans les clusters ICP.
-
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
- Dans votre tableau de bord ICP, sélectionnez Configurer le client, puis collez les commandes Kubectl fournies dans un shell de commande sur votre client et exécutez-les.
Les commandes Kubectl définissez votre contexte Kubernetes. Testez la configuration en exécutant la commande suivante :
kubectl get nodes kubectl get pods --all-namespaces
Si des messages similaires aux exemples suivants s'affichent, votre configuration est prête à l'emploi.
10.134.119.132 Ready <none> 151d v1.10.0+icp-ee 10.134.119.24 Ready <none> 151d v1.10.0+icp-ee 10.134.119.65 Ready <none> 151d v1.10.0+icp-ee 10.134.119.9 Ready <none> 151d v1.10.0+icp-ee
-
Dans le tableau de bord ICP, cliquez sur Gérer > Espaces de noms > Créer des espaces de noms > ****, puis saisissez un nom à donner à l'espace de nom.
-
Créez MongoDB dans le nouvel espace de nom en procédant comme suit :
-
Dans le tableau de bord ICP, sélectionnez Catalogue > ibm-mongodb-dev.
-
Sur la page ibm-mongodb-dev, sélectionnez Configurer, puis, depuis la liste Espace de nom cible, sélectionnez l'espace de nom créé précédemment.
-
Terminez la configuration en saisissant un nom de version et un mot passe pour l'utilisateur Admin MongoDB, puis cliquez sur Installer.
Cela permet de créer un appel du volume persistant.
-
-
Cliquez sur Plateforme > Stockage > ****, puis créez un volume persistant pour votre appel en procédant comme suit :
-
Sur la page Stockage, cliquez sur Créer un volume persistant.
-
Dans la fenêtre Créer un volume persistant, saisissez un nom à donner au volume.
-
Activez le mode JSON.
Le fichier JSON sous-jacent correspondant au volume persistant s'affiche. Dans le script JSON correspondant au projet
NFS
, spécifiez l'adresse IP du serveur et le chemin d'accès au nouveau volume. L'extrait de code suivant illustre un exemple classique :"nfs": { "server": "ip\_address", "path": "/volume\_path" },
-
Cliquez sur Créer.
Dans la fenêtre Stockage, vérifiez le statut de
Bound
pour le nouveau volume. -
Dans un shell de commande sur le client, utilisez la commande kubectl suivante pour vérifier le statut du pod :
kubectl get pods -n persistentVolume\_name.
-
-
Accordez des droits supplémentaires à l'utilisateur MongoDB en procédant comme suit :
-
A l'aide d'un shell de commande client, connectez-vous au pod en tant qu'utilisateur Admin.
-
Accordez des droits supplémentaires à l'aide de la commande suivante :
db.grantRolesToUser( "mongo", ["readWriteAnyDatabase", "dbAdminAnyDatabase", "clusterAdmin"] )
En cas d'échec de la commande, un message d'erreur s'affiche.
-
Si aucun message ne s'affiche, saisissez
exit
pour quitter le pod.
-
-
A l'aide d'un shell de commande client, saisissez
kubectl get services -n namespace
pour afficher le service MongoDB.Le nom du service est le nom d'hôte pour le service MongoDB.
-
Déterminez les propriétés de configuration à spécifier. Vous pouvez personnaliser l'installation en spécifiant les propriétés de configuration dans la commande helm install.
Certaines des propriétés spécifiées dépendent de votre environnement. Cependant, plusieurs propriétés doivent être spécifiées. Les propriétés obligatoires sont indiquées ci-dessous.
-
access.key
Clé d'accès du produit obtenue depuis Passport Advantage.
-
url.domain
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.
-
mongo.url
URL de la base de données MongoDB. Spécifiez les paramètres suivants.
-
username
ID utilisateur utilisé pour l'authentification auprès de la base de données MongoDB.
-
mot_de_passe
Mot de passe associé pour l'authentification auprès de la base de données MongoDB.
-
port
Numéro de port de la base de données MongoDB. Utilisez la valeur indiquée dans l'exemple, soit 27017.
-
service_name
Le nom du service MongoDB que vous avez extrait à l'étape 8.
Remarque : Si vous avez utilisé la commande d'installation à l'étape précédente pour installer MongoDB, utilisez les valeurs suivantes pour la propriété mongo.url.
mongodb://mongo:mongo@velocity-mongo-ibm-mongodb-dev:27017/admin
Si vous utilisez la base de données MongoDB IBM par défaut, assurez-vous d'accorder à l'utilisateur MongoDB des droits d'écriture complets.
-
-
name
L'espace de nom où le tableau Helm est appliqué, et le nom du tableau Helm.
--name standard ./velocity-1-5-0-helm.tgz
-
-
Exécutez la commande
helm install
pour installer les images HCL Accelerate dans ICP. L'exemple suivant montre les propriétés d'une configuration standard :helm install \ --set access.key=my\_access\_key \ --set url.domain=my\_hostname \ --set mongo.url=mongodb://mongo:mongo@mongodb-servicename:27017/admin \ --set url.protocol=https \ --set ui.service.externalPort=80 \ --set ingress.enable=true \ --name standard ./velocity-1-5-0-helm.tgz
Accédez à HCL Accelerate à l'aide de l'URL que vous avez indiquée dans la charte Helm. Vous pouvez actualiser l'affichage du statut à l'aide de la commande kubectl suivante : kubectl get pods
. Le nom d'utilisateur Admin par défaut est admin, et le mot de passe par défaut est admin.