2.5. Installation de Service Mesh

Procédure

1. Connectez-vous à la console web de OpenShift Container Platform en tant qu'utilisateur ayant le rôle cluster-admin.

2. Créer un projet nommé istio-system.

   1. Naviguez jusqu'à Home Projects.
   2. Cliquez sur Create Project.
   3. Saisissez istio-system dans le champ Name.
   4. Cliquez sur Create.
3. Naviguez jusqu'à Operators Installed Operators.
4. Si nécessaire, sélectionnez istio-system dans le menu Projet. Il se peut que vous deviez attendre quelques instants pour que les opérateurs soient copiés dans le nouveau projet.

5. Cliquez sur l'opérateur Red Hat OpenShift Service Mesh. Sous Provided APIs, l'opérateur fournit des liens pour créer deux types de ressources :

   • Une ressource ServiceMeshControlPlane
   • Une ressource ServiceMeshMemberRoll
6. Sous Istio Service Mesh Control Plane, cliquez sur Create ServiceMeshControlPlane.

7. Sur la page Create Service Mesh Control Plane, modifiez le YAML du modèle par défaut ServiceMeshControlPlane si nécessaire.

   Note

   Pour plus d'informations sur la personnalisation du plan de contrôle, voir Personnaliser l'installation de Red Hat OpenShift Service Mesh. Pour la production, vous must modifiez le modèle Jaeger par défaut.

8. Cliquez sur Create pour créer le plan de contrôle. L'opérateur crée des pods, des services et des composants du plan de contrôle Service Mesh en fonction de vos paramètres de configuration.
9. Cliquez sur l'onglet Istio Service Mesh Control Plane.
10. Cliquez sur le nom du nouveau plan de contrôle.
11. Cliquez sur l'onglet Resources pour voir les ressources du plan de contrôle de Red Hat OpenShift Service Mesh que l'opérateur a créées et configurées.

Procédure

1. Connectez-vous au CLI de OpenShift Container Platform en tant qu'utilisateur ayant le rôle cluster-admin.

   $ oc login --username=<NAMEOFUSER> https://<HOSTNAME>:6443

2. Créer un projet nommé istio-system.

   $ oc new-project istio-system

3. Créez un fichier ServiceMeshControlPlane nommé istio-installation.yaml en utilisant l'exemple trouvé dans "Customize the Red Hat OpenShift Service Mesh installation". Vous pouvez personnaliser les valeurs en fonction de votre cas d'utilisation. Pour les déploiements de production, vous pouvez must modifier le modèle Jaeger par défaut.

4. Exécutez la commande suivante pour déployer le plan de contrôle :

   $ oc create -n istio-system -f istio-installation.yaml

5. Exécutez la commande suivante pour connaître l'état de l'installation du plan de contrôle.

   $ oc get smcp -n istio-system

   L'installation est terminée avec succès lorsque la colonne STATUS est ComponentsReady.

   NAME            READY   STATUS            PROFILES      VERSION   AGE
   basic-install   11/11   ComponentsReady   ["default"]   v1.1.18   4m25s

6. Exécutez la commande suivante pour observer la progression des modules pendant le processus d'installation :

   $ oc get pods -n istio-system -w

   Vous devriez obtenir un résultat similaire à celui qui suit :

   Exemple de sortie

   NAME                                     READY   STATUS             RESTARTS   AGE
   grafana-7bf5764d9d-2b2f6                 2/2     Running            0          28h
   istio-citadel-576b9c5bbd-z84z4           1/1     Running            0          28h
   istio-egressgateway-5476bc4656-r4zdv     1/1     Running            0          28h
   istio-galley-7d57b47bb7-lqdxv            1/1     Running            0          28h
   istio-ingressgateway-dbb8f7f46-ct6n5     1/1     Running            0          28h
   istio-pilot-546bf69578-ccg5x             2/2     Running            0          28h
   istio-policy-77fd498655-7pvjw            2/2     Running            0          28h
   istio-sidecar-injector-df45bd899-ctxdt   1/1     Running            0          28h
   istio-telemetry-66f697d6d5-cj28l         2/2     Running            0          28h
   jaeger-896945cbc-7lqrr                   2/2     Running            0          11h
   kiali-78d9c5b87c-snjzh                   1/1     Running            0          22h
   prometheus-6dff867c97-gr2n5              2/2     Running            0          28h

Procédure

1. Connectez-vous à la console web de OpenShift Container Platform.

2. Si vous n'avez pas encore de services pour votre maillage, ou si vous partez de zéro, créez un projet pour vos applications. Ce projet doit être différent de celui où vous avez installé le plan de contrôle Service Mesh.

   1. Naviguez jusqu'à Home Projects.
   2. Saisissez un nom dans le champ Name.
   3. Cliquez sur Create.
3. Naviguez jusqu'à Operators Installed Operators.
4. Cliquez sur le menu Project et choisissez dans la liste le projet dans lequel votre ressource ServiceMeshControlPlane est déployée, par exemple istio-system.
5. Cliquez sur l'opérateur Red Hat OpenShift Service Mesh.
6. Cliquez sur l'onglet Istio Service Mesh Member Roll.
7. Cliquez sur Create ServiceMeshMemberRoll
8. Cliquez sur Members, puis saisissez le nom de votre projet dans le champ Value. Vous pouvez ajouter autant de projets que vous le souhaitez, mais un projet ne peut appartenir qu'à la ressource one ServiceMeshMemberRoll .
9. Cliquez sur Create.

Procédure

1. Connectez-vous au CLI de OpenShift Container Platform.

   $ oc login --username=<NAMEOFUSER> https://<HOSTNAME>:6443

2. Si vous n'avez pas encore de services pour votre maillage, ou si vous partez de zéro, créez un projet pour vos applications. Ce projet doit être différent de celui où vous avez installé le plan de contrôle Service Mesh.

   oc new-project <your-project> $ oc new-project <your-project>

3. Pour ajouter vos projets en tant que membres, modifiez l'exemple YAML suivant. Vous pouvez ajouter autant de projets que vous le souhaitez, mais un projet ne peut appartenir qu'à la ressource one ServiceMeshMemberRoll . Dans cet exemple, istio-system est le nom du projet de plan de contrôle Service Mesh.

   Exemple servicemeshmemberroll-default.yaml

   apiVersion: maistra.io/v1
   kind: ServiceMeshMemberRoll
   metadata:
     name: default
     namespace: istio-system
   spec:
     members:
       # a list of projects joined into the service mesh
       - your-project-name
       - another-project-name

4. Exécutez la commande suivante pour télécharger et créer la ressource ServiceMeshMemberRoll dans l'espace de noms istio-system.

   $ oc create -n istio-system -f servicemeshmemberroll-default.yaml

5. Exécutez la commande suivante pour vérifier que le site ServiceMeshMemberRoll a été créé avec succès.

   $ oc get smmr -n istio-system default

   L'installation est terminée avec succès lorsque la colonne STATUS est Configured.

Procédure

1. Connectez-vous à la console web de OpenShift Container Platform.
2. Naviguez jusqu'à Operators Installed Operators.
3. Cliquez sur le menu Project et choisissez dans la liste le projet dans lequel votre ressource ServiceMeshControlPlane est déployée, par exemple istio-system.
4. Cliquez sur l'opérateur Red Hat OpenShift Service Mesh.
5. Cliquez sur l'onglet Istio Service Mesh Member Roll.
6. Cliquez sur le lien default.
7. Cliquez sur l'onglet YAML.
8. Modifiez le YAML pour ajouter ou supprimer des projets en tant que membres. Vous pouvez ajouter autant de projets que vous le souhaitez, mais un projet ne peut appartenir qu'à la ressource one ServiceMeshMemberRoll .
9. Cliquez sur Save.
10. Cliquez sur Reload.

Procédure

1. Connectez-vous au CLI de OpenShift Container Platform.

2. Modifier la ressource ServiceMeshMemberRoll.

   $ oc edit smmr -n <controlplane-namespace>

3. Modifiez le YAML pour ajouter ou supprimer des projets en tant que membres. Vous pouvez ajouter autant de projets que vous le souhaitez, mais un projet ne peut appartenir qu'à la ressource one ServiceMeshMemberRoll .

   Exemple servicemeshmemberroll-default.yaml

   apiVersion: maistra.io/v1
   kind: ServiceMeshMemberRoll
   metadata:
     name: default
     namespace: istio-system #control plane project
   spec:
     members:
       # a list of projects joined into the service mesh
       - your-project-name
       - another-project-name