Chapitre 3. Installation de traçage distribué
3.1. Installation du traçage distribué
Vous pouvez installer le traçage distribué de Red Hat OpenShift sur OpenShift Container Platform de deux manières :
-
Vous pouvez installer Red Hat OpenShift distributed tracing dans le cadre de Red Hat OpenShift Service Mesh. Le traçage distribué est inclus par défaut dans l'installation de Service Mesh. Pour installer le traçage distribué Red Hat OpenShift dans le cadre d'un Service Mesh, suivez les instructions d'installation de Red Hat Service Mesh. Vous devez installer Red Hat OpenShift distributed tracing dans le même espace de noms que votre service mesh, c'est-à-dire que les ressources
ServiceMeshControlPlane
et Red Hat OpenShift distributed tracing doivent être dans le même espace de noms. - Si vous ne souhaitez pas installer un maillage de services, vous pouvez utiliser les opérateurs de traçage distribué Red Hat OpenShift pour installer le traçage distribué de manière autonome. Pour installer Red Hat OpenShift distributed tracing sans service mesh, utilisez les instructions suivantes.
3.1.1. Conditions préalables
Avant d'installer Red Hat OpenShift distributed tracing, passez en revue les activités d'installation et assurez-vous que vous remplissez les conditions préalables :
- Posséder un abonnement OpenShift Container Platform actif sur votre compte Red Hat. Si vous n'avez pas d'abonnement, contactez votre représentant commercial pour plus d'informations.
- Consultez la présentation de OpenShift Container Platform 4.12.
Installez OpenShift Container Platform 4.12.
-
Installez la version de l'OpenShift CLI (
oc
) qui correspond à la version de votre OpenShift Container Platform et ajoutez-la à votre chemin d'accès. -
Un compte avec le rôle
cluster-admin
.
3.1.2. Aperçu de l'installation du traçage distribué de Red Hat OpenShift
Les étapes d'installation du traçage distribué de Red Hat OpenShift sont les suivantes :
- Examinez la documentation et déterminez votre stratégie de déploiement.
- Si votre stratégie de déploiement nécessite un stockage persistant, installez l'OpenShift Elasticsearch Operator via l'OperatorHub.
- Installez la plateforme de traçage distribuée Red Hat OpenShift Operator via OperatorHub.
- Modifiez le fichier YAML des ressources personnalisées pour soutenir votre stratégie de déploiement.
- Déployez une ou plusieurs instances de la plateforme de traçage distribuée Red Hat OpenShift dans votre environnement OpenShift Container Platform.
3.1.3. Installation de l'opérateur OpenShift Elasticsearch
Le déploiement par défaut de la plateforme de traçage distribué Red Hat OpenShift utilise le stockage en mémoire car il est conçu pour être installé rapidement pour ceux qui évaluent le traçage distribué Red Hat OpenShift, font des démonstrations ou utilisent la plateforme de traçage distribué Red Hat OpenShift dans un environnement de test. Si vous prévoyez d'utiliser la plateforme de traçage distribué Red Hat OpenShift en production, vous devez installer et configurer une option de stockage persistant, dans ce cas, Elasticsearch.
Conditions préalables
- Vous avez accès à la console web de OpenShift Container Platform.
-
Vous avez accès au cluster en tant qu'utilisateur avec le rôle
cluster-admin
. Si vous utilisez Red Hat OpenShift Dedicated, vous devez avoir un compte avec le rôlededicated-admin
.
N'installez pas les versions communautaires des opérateurs. Les opérateurs communautaires ne sont pas pris en charge.
Si vous avez déjà installé l'OpenShift Elasticsearch Operator dans le cadre d'OpenShift Logging, vous n'avez pas besoin d'installer à nouveau l'OpenShift Elasticsearch Operator. L'opérateur de la plateforme de traçage distribuée Red Hat OpenShift crée l'instance Elasticsearch à l'aide de l'opérateur OpenShift Elasticsearch installé.
Procédure
-
Connectez-vous à la console web de OpenShift Container Platform en tant qu'utilisateur avec le rôle
cluster-admin
. Si vous utilisez Red Hat OpenShift Dedicated, vous devez avoir un compte avec le rôlededicated-admin
. -
Naviguez jusqu'à Operators
OperatorHub. - Tapez Elasticsearch dans la boîte de filtre pour trouver l'OpenShift Elasticsearch Operator.
- Cliquez sur le site OpenShift Elasticsearch Operator fourni par Red Hat pour afficher des informations sur l'opérateur.
- Cliquez sur Install.
- Sur la page Install Operator, sélectionnez le canal de mise à jour stable. Ce canal met automatiquement à jour votre opérateur au fur et à mesure que de nouvelles versions sont publiées.
Accepter le projet par défaut All namespaces on the cluster (default). L'opérateur est ainsi installé dans le projet par défaut
openshift-operators-redhat
et mis à la disposition de tous les projets du cluster.NoteL'installation d'Elasticsearch nécessite l'espace de noms openshift-operators-redhat pour l'opérateur OpenShift Elasticsearch. Les autres opérateurs de traçage distribués de Red Hat OpenShift sont installés dans l'espace de noms
openshift-operators
.Accepter la stratégie d'approbation par défaut Automatic. En acceptant la stratégie par défaut, lorsqu'une nouvelle version de cet opérateur est disponible, Operator Lifecycle Manager (OLM) met automatiquement à niveau l'instance en cours d'exécution de votre opérateur sans intervention humaine. Si vous sélectionnez Manual updates, lorsqu'une nouvelle version d'un opérateur est disponible, OLM crée une demande de mise à jour. En tant qu'administrateur de cluster, vous devez alors approuver manuellement cette demande de mise à jour pour que l'opérateur soit mis à jour avec la nouvelle version.
NoteLa stratégie d'approbation Manual exige qu'un utilisateur disposant des informations d'identification appropriées approuve le processus d'installation et d'abonnement de l'opérateur.
- Cliquez sur Install.
-
Sur la page Installed Operators, sélectionnez le projet
openshift-operators-redhat
. Attendez de voir que l'OpenShift Elasticsearch Operator affiche le statut "InstallSucceeded" avant de continuer.
3.1.4. Installation de la plateforme de traçage distribuée Red Hat OpenShift Opérateur
Pour installer Red Hat OpenShift distributed tracing platform, vous utilisez OperatorHub pour installer l'opérateur Red Hat OpenShift distributed tracing platform.
Par défaut, l'opérateur est installé dans le projet openshift-operators
.
Conditions préalables
- Vous avez accès à la console web de OpenShift Container Platform.
-
Vous avez accès au cluster en tant qu'utilisateur avec le rôle
cluster-admin
. Si vous utilisez Red Hat OpenShift Dedicated, vous devez avoir un compte avec le rôlededicated-admin
. - Si vous avez besoin d'un stockage persistant, vous devez également installer l'Opérateur OpenShift Elasticsearch avant d'installer l'Opérateur de la plateforme de traçage distribuée Red Hat OpenShift.
N'installez pas les versions communautaires des opérateurs. Les opérateurs communautaires ne sont pas pris en charge.
Procédure
-
Connectez-vous à la console web de OpenShift Container Platform en tant qu'utilisateur avec le rôle
cluster-admin
. Si vous utilisez Red Hat OpenShift Dedicated, vous devez avoir un compte avec le rôlededicated-admin
. -
Naviguez jusqu'à Operators
OperatorHub. - Tapez distributed tracing platform dans le filtre pour localiser l'opérateur de la plateforme de traçage distribuée Red Hat OpenShift.
- Cliquez sur le site Red Hat OpenShift distributed tracing platform Operator fourni par Red Hat pour afficher des informations sur l'opérateur.
- Cliquez sur Install.
- Sur la page Install Operator, sélectionnez le canal de mise à jour stable. Ce canal met automatiquement à jour votre opérateur au fur et à mesure que de nouvelles versions sont publiées.
Accepter le projet par défaut All namespaces on the cluster (default). L'opérateur est ainsi installé dans le projet par défaut
openshift-operators
et mis à la disposition de tous les projets du cluster.Accepter la stratégie d'approbation par défaut Automatic. En acceptant la stratégie par défaut, lorsqu'une nouvelle version de cet opérateur est disponible, Operator Lifecycle Manager (OLM) met automatiquement à niveau l'instance en cours d'exécution de votre opérateur sans intervention humaine. Si vous sélectionnez Manual updates, lorsqu'une nouvelle version d'un opérateur est disponible, OLM crée une demande de mise à jour. En tant qu'administrateur de cluster, vous devez alors approuver manuellement cette demande de mise à jour pour que l'opérateur soit mis à jour avec la nouvelle version.
NoteLa stratégie d'approbation Manual exige qu'un utilisateur disposant des informations d'identification appropriées approuve le processus d'installation et d'abonnement de l'opérateur.
- Cliquez sur Install.
-
Naviguez jusqu'à Operators
Installed Operators. -
Sur la page Installed Operators, sélectionnez le projet
openshift-operators
. Attendez de voir que l'opérateur de la plate-forme de traçage distribuée Red Hat OpenShift affiche un état de "Réussi" avant de continuer.
3.1.5. Installation de l'opérateur de collecte de données de traçage distribué Red Hat OpenShift
L'opérateur de collecte de données de traçage distribué de Red Hat OpenShift est une fonctionnalité d'aperçu technologique uniquement. Les fonctionnalités de l'aperçu technologique ne sont pas prises en charge par les accords de niveau de service (SLA) de production de Red Hat et peuvent ne pas être complètes sur le plan fonctionnel. Red Hat ne recommande pas de les utiliser en production. Ces fonctionnalités offrent un accès anticipé aux fonctionnalités des produits à venir, ce qui permet aux clients de tester les fonctionnalités et de fournir un retour d'information pendant le processus de développement.
Pour plus d'informations sur la portée de l'assistance des fonctionnalités de l'aperçu technologique de Red Hat, voir Portée de l'assistance des fonctionnalités de l'aperçu technologique.
Pour installer Red Hat OpenShift distributed tracing data collection, vous utilisez OperatorHub pour installer l'opérateur Red Hat OpenShift distributed tracing data collection.
Par défaut, l'opérateur est installé dans le projet openshift-operators
.
Conditions préalables
- Vous avez accès à la console web de OpenShift Container Platform.
-
Vous avez accès au cluster en tant qu'utilisateur avec le rôle
cluster-admin
. Si vous utilisez Red Hat OpenShift Dedicated, vous devez avoir un compte avec le rôlededicated-admin
.
N'installez pas les versions communautaires des opérateurs. Les opérateurs communautaires ne sont pas pris en charge.
Procédure
-
Connectez-vous à la console web de OpenShift Container Platform en tant qu'utilisateur avec le rôle
cluster-admin
. Si vous utilisez Red Hat OpenShift Dedicated, vous devez avoir un compte avec le rôlededicated-admin
. -
Naviguez jusqu'à Operators
OperatorHub. - Tapez distributed tracing data collection dans le filtre pour localiser l'opérateur de collecte de données de traçage distribué Red Hat OpenShift.
- Cliquez sur le site Red Hat OpenShift distributed tracing data collection Operator fourni par Red Hat pour afficher des informations sur l'opérateur.
- Cliquez sur Install.
- Sur la page Install Operator, acceptez le canal de mise à jour par défaut stable. Ce canal met automatiquement à jour votre opérateur au fur et à mesure que de nouvelles versions sont publiées.
-
Accepter le projet par défaut All namespaces on the cluster (default). L'opérateur est ainsi installé dans le projet par défaut
openshift-operators
et mis à la disposition de tous les projets du cluster. Accepter la stratégie d'approbation par défaut Automatic. En acceptant la stratégie par défaut, lorsqu'une nouvelle version de cet opérateur est disponible, Operator Lifecycle Manager (OLM) met automatiquement à niveau l'instance en cours d'exécution de votre opérateur sans intervention humaine. Si vous sélectionnez Manual updates, lorsqu'une nouvelle version d'un opérateur est disponible, OLM crée une demande de mise à jour. En tant qu'administrateur de cluster, vous devez alors approuver manuellement cette demande de mise à jour pour que l'opérateur soit mis à jour avec la nouvelle version.
NoteLa stratégie d'approbation Manual exige qu'un utilisateur disposant des informations d'identification appropriées approuve le processus d'installation et d'abonnement de l'opérateur.
- Cliquez sur Install.
-
Naviguez jusqu'à Operators
Installed Operators. -
Sur la page Installed Operators, sélectionnez le projet
openshift-operators
. Attendez de voir que l'opérateur de collecte de données de traçage distribué de Red Hat OpenShift affiche un état de "Réussi" avant de continuer.