1.18. Connexion des mailles de service

1. Connectez-vous à la console web d'OpenShift Container Platform en tant qu'utilisateur ayant le rôle d'administrateur de cluster.
2. Naviguez jusqu'à Operators Installed Operators.
3. Cliquez sur le menu Project et sélectionnez le projet dans lequel vous avez installé le plan de contrôle Service Mesh. Par exemple, red-mesh-system.
4. Cliquez sur l'opérateur Red Hat OpenShift Service Mesh.
5. Dans l'onglet Istio Service Mesh Control Plane, cliquez sur le nom de votre ServiceMeshControlPlane, par exemple red-mesh.
6. Sur la page Create ServiceMeshControlPlane Details, cliquez sur YAML pour modifier votre configuration.
7. Modifiez votre ServiceMeshControlPlane pour ajouter les passerelles d'entrée et de sortie de la fédération et pour spécifier le domaine de confiance.
8. Cliquez sur Save.

1. Connectez-vous au CLI de OpenShift Container Platform en tant qu'utilisateur ayant le rôle cluster-admin. Entrez la commande suivante. Saisissez ensuite votre nom d'utilisateur et votre mot de passe lorsque vous y êtes invité.

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

2. Accédez au projet dans lequel vous avez installé le plan de contrôle Service Mesh, par exemple red-mesh-system.

   $ oc project red-mesh-system

3. Modifiez le fichier ServiceMeshControlPlane pour ajouter les passerelles d'entrée et de sortie de la fédération et pour spécifier le domaine de confiance.

4. Exécutez la commande suivante pour modifier le plan de contrôle Service Mesh où red-mesh-system est l'espace de noms du système et red-mesh est le nom de l'objet ServiceMeshControlPlane:

   $ oc edit -n red-mesh-system smcp red-mesh

5. Entrez la commande suivante, où red-mesh-system est l'espace de noms du système, pour voir l'état de l'installation du plan de contrôle Service Mesh.

   $ oc get smcp -n red-mesh-system

   L'installation est terminée avec succès lorsque la colonne READY indique que tous les composants sont prêts.

   NAME       READY   STATUS            PROFILES      VERSION   AGE
   red-mesh   10/10   ComponentsReady   ["default"]   2.1.0     4m25s

1. Connectez-vous au CLI de OpenShift Container Platform en tant qu'utilisateur ayant le rôle cluster-admin. Entrez la commande suivante. Saisissez ensuite votre nom d'utilisateur et votre mot de passe lorsque vous y êtes invité.

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

2. Accédez au projet dans lequel vous avez installé le plan de contrôle, par exemple, red-mesh-system.

   $ oc project red-mesh-system

3. Créez un fichier ServiceMeshPeer basé sur l'exemple suivant pour les deux maillages que vous souhaitez fédérer.

   Exemple de ressource ServiceMeshPeer pour le maillage rouge vers le maillage vert

   kind: ServiceMeshPeer
   apiVersion: federation.maistra.io/v1
   metadata:
     name: green-mesh
     namespace: red-mesh-system
   spec:
     remote:
       addresses:
       - ingress-red-mesh.green-mesh-system.apps.domain.com
     gateways:
       ingress:
         name: ingress-green-mesh
       egress:
         name: egress-green-mesh
     security:
       trustDomain: green-mesh.local
       clientID: green-mesh.local/ns/green-mesh-system/sa/egress-red-mesh-service-account
       certificateChain:
         kind: ConfigMap
         name: green-mesh-ca-root-cert

4. Exécutez la commande suivante pour déployer la ressource, où red-mesh-system est l'espace de noms du système et servicemeshpeer.yaml inclut un chemin complet vers le fichier que vous avez modifié :

   $ oc create -n red-mesh-system -f servicemeshpeer.yaml

5. Pour confirmer que la connexion entre la maille rouge et la maille verte est établie, vérifiez l'état de la maille verte ServiceMeshPeer dans l'espace de noms du système de la maille rouge :

   $ oc -n red-mesh-system get servicemeshpeer green-mesh -o yaml

   Exemple de connexion ServiceMeshPeer entre la maille rouge et la maille verte

   status:
     discoveryStatus:
       active:
       - pod: istiod-red-mesh-b65457658-9wq5j
         remotes:
         - connected: true
           lastConnected: "2021-10-05T13:02:25Z"
           lastFullSync: "2021-10-05T13:02:25Z"
           source: 10.128.2.149
         watch:
           connected: true
           lastConnected: "2021-10-05T13:02:55Z"
           lastDisconnectStatus: 503 Service Unavailable
           lastFullSync: "2021-10-05T13:05:43Z"

   Le champ status.discoveryStatus.active.remotes indique que l'istiod de la maille homologue (dans cet exemple, la maille verte) est connecté à l'istiod de la maille courante (dans cet exemple, la maille rouge).

   Le champ status.discoveryStatus.active.watch indique qu'istiod dans le maillage actuel est connecté à istiod dans le maillage homologue.

   Si vous consultez le site servicemeshpeer nommé red-mesh dans green-mesh-system, vous trouverez des informations sur les deux mêmes connexions du point de vue de la maille verte.

   Lorsque la connexion entre deux mailles n'est pas établie, le statut ServiceMeshPeer l'indique dans le champ status.discoveryStatus.inactive.

   Pour plus d'informations sur la raison de l'échec d'une tentative de connexion, consultez le journal Istiod, le journal d'accès de la passerelle de sortie gérant le trafic de sortie pour le pair et la passerelle d'entrée gérant le trafic d'entrée pour le maillage actuel dans le maillage du pair.

   Par exemple, si la maille rouge ne peut pas se connecter à la maille verte, vérifiez les journaux suivants :

   • istiod-red-mesh dans red-mesh-system
   • egress-green-mesh in red-mesh-system
   • ingress-red-mesh in green-mesh-system

1. Connectez-vous au CLI de OpenShift Container Platform en tant qu'utilisateur ayant le rôle cluster-admin. Entrez la commande suivante. Saisissez ensuite votre nom d'utilisateur et votre mot de passe lorsque vous y êtes invité.

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

2. Accédez au projet dans lequel vous avez installé le plan de contrôle Service Mesh ; par exemple, red-mesh-system.

   $ oc project red-mesh-system

3. Créez un fichier ExportedServiceSet basé sur l'exemple suivant où red-mesh exporte des services vers green-mesh.

   Exemple de ressource ExportedServiceSet de la maille rouge à la maille verte

   apiVersion: federation.maistra.io/v1
   kind: ExportedServiceSet
   metadata:
     name: green-mesh
     namespace: red-mesh-system
   spec:
     exportRules:
     - type: NameSelector
       nameSelector:
         namespace: red-mesh-info
         name: ratings
         alias:
           namespace: info
           name: red-ratings
     - type: NameSelector
       nameSelector:
         namespace: red-mesh-info
         name: reviews

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

   $ oc create -n <ControlPlaneNamespace> -f <ExportedServiceSet.yaml>

   Par exemple :

   $ oc create -n red-mesh-system -f export-to-green-mesh.yaml

5. Créez des ExportedServiceSets supplémentaires si nécessaire pour chaque pair de maillage dans votre maillage fédéré.

6. Pour valider les services que vous avez exportés de red-mesh pour les partager avec green-mesh, exécutez la commande suivante :

   $ oc get exportedserviceset <PeerMeshExportedTo> -o yaml

   Par exemple :

   $ oc get exportedserviceset green-mesh -o yaml

7. Exécutez la commande suivante pour valider les services que red-mesh exporte pour les partager avec green-mesh :

   $ oc get exportedserviceset <PeerMeshExportedTo> -o yaml

   Par exemple :

   $ oc -n red-mesh-system get exportedserviceset green-mesh -o yaml

   Exemple de validation des services exportés de la maille rouge qui sont partagés avec la maille verte.

     status:
       exportedServices:
       - exportedName: red-ratings.info.svc.green-mesh-exports.local
         localService:
           hostname: ratings.red-mesh-info.svc.cluster.local
           name: ratings
           namespace: red-mesh-info
       - exportedName: reviews.red-mesh-info.svc.green-mesh-exports.local
         localService:
           hostname: reviews.red-mesh-info.svc.cluster.local
           name: reviews
           namespace: red-mesh-info

   Le tableau status.exportedServices répertorie les services qui sont actuellement exportés (ces services correspondent aux règles d'exportation de ExportedServiceSet object). Chaque entrée du tableau indique le nom du service exporté et des détails sur le service local exporté.

   Si un service que vous vous attendiez à voir exporté est manquant, vérifiez que l'objet Service existe, que son nom ou ses étiquettes correspondent au exportRules défini dans l'objet ExportedServiceSet et que l'espace de noms de l'objet Service est configuré en tant que membre du maillage de services à l'aide de l'objet ServiceMeshMemberRoll ou ServiceMeshMember.

1. Connectez-vous au CLI de OpenShift Container Platform en tant qu'utilisateur ayant le rôle cluster-admin. Entrez la commande suivante. Saisissez ensuite votre nom d'utilisateur et votre mot de passe lorsque vous y êtes invité.

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

2. Accédez au projet dans lequel vous avez installé le plan de contrôle Service Mesh ; par exemple, green-mesh-system.

   $ oc project green-mesh-system

3. Créez un fichier ImportedServiceSet basé sur l'exemple suivant où green-mesh importe des services précédemment exportés par red-mesh.

   Exemple de ressource ImportedServiceSet de la maille rouge à la maille verte

   kind: ImportedServiceSet
   apiVersion: federation.maistra.io/v1
   metadata:
     name: red-mesh
     namespace: green-mesh-system
   spec:
     importRules:
     - type: NameSelector
       importAsLocal: false
       nameSelector:
         namespace: info
         name: red-ratings
         alias:
           namespace: info
           name: ratings

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

   $ oc create -n <ControlPlaneNamespace> -f <ImportedServiceSet.yaml>

   Par exemple :

   $ oc create -n green-mesh-system -f import-from-red-mesh.yaml

5. Créez des ressources ImportedServiceSet supplémentaires si nécessaire pour chaque pair de maillage dans votre maillage fédéré.

6. Pour valider les services que vous avez importés dans green-mesh, exécutez la commande suivante :

   $ oc get importedserviceset <PeerMeshImportedInto> -o yaml

   Par exemple :

   $ oc get importedserviceset green-mesh -o yaml

7. Exécutez la commande suivante pour valider les services importés dans un maillage.

   $ oc get importedserviceset <PeerMeshImportedInto> -o yaml

   Exemple de validation de l'importation dans la maille verte des services exportés de la maille rouge à l'aide de la section status de l'espace de noms importedserviceset/red-mesh' object in the 'green-mesh-system:

   $ oc -n green-mesh-system get importedserviceset/red-mesh -o yaml

   status:
     importedServices:
     - exportedName: red-ratings.info.svc.green-mesh-exports.local
       localService:
         hostname: ratings.info.svc.red-mesh-imports.local
         name: ratings
         namespace: info
     - exportedName: reviews.red-mesh-info.svc.green-mesh-exports.local
       localService:
         hostname: ""
         name: ""
         namespace: ""

   Dans l'exemple précédent, seul le service d'évaluation est importé, comme l'indiquent les champs remplis sous localService. Le service de critiques est disponible pour l'importation, mais il n'est pas importé pour l'instant parce qu'il ne correspond à aucun importRules dans l'objet ImportedServiceSet.

Procédure

1. Connectez-vous au CLI de OpenShift Container Platform en tant qu'utilisateur ayant le rôle cluster-admin et entrez la commande suivante :

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

2. Passez au projet dans lequel vous avez installé le plan de contrôle Service Mesh et entrez la commande suivante :

   oc project <smcp-system>

   Par exemple, green-mesh-system.

   $ oc project green-mesh-system

3. Modifiez le fichier ImportedServiceSet, où <ImportedServiceSet.yaml> comprend le chemin d'accès complet au fichier que vous souhaitez modifier, en entrant la commande suivante :

   $ oc edit -n <smcp-system> -f <ImportedServiceSet.yaml>

   Par exemple, si vous souhaitez modifier le fichier qui importe du système à mailles rouges vers le système à mailles vertes, comme indiqué dans l'exemple précédent ImportedServiceSet.

   $ oc edit -n green-mesh-system -f import-from-red-mesh.yaml

4. Modifier le fichier :

   1. Définir spec.importRules.importAsLocal à true.
   2. Définissez spec.locality comme étant region, zone, ou subzone.
   3. Enregistrez vos modifications.

Procédure

1. Connectez-vous au CLI de OpenShift Container Platform en tant qu'utilisateur ayant le rôle cluster-admin. Entrez la commande suivante. Saisissez ensuite votre nom d'utilisateur et votre mot de passe lorsque vous y êtes invité.

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

2. Passez au projet dans lequel vous avez installé le plan de contrôle Service Mesh.

   oc project <smcp-system>

   Par exemple, green-mesh-system.

   $ oc project green-mesh-system

3. Créez un fichier DestinationRule basé sur l'exemple suivant où, si green-mesh est indisponible, le trafic doit être acheminé depuis green-mesh dans la région us-east vers red-mesh dans us-west.

   Exemple DestinationRule

   apiVersion: networking.istio.io/v1beta1
   kind: DestinationRule
   metadata:
     name: default-failover
     namespace: info
   spec:
     host: "ratings.info.svc.cluster.local"
     trafficPolicy:
       loadBalancer:
         localityLbSetting:
           enabled: true
           failover:
             - from: us-east
               to: us-west
       outlierDetection:
         consecutive5xxErrors: 3
         interval: 10s
         baseEjectionTime: 1m

4. Déployez le fichier DestinationRule, où <DestinationRule> comprend le chemin complet de votre fichier, en entrant la commande suivante :

   oc create -n <application namespace> -f <DestinationRule.yaml>

   Par exemple :

   $ oc create -n info -f green-mesh-us-west-DestinationRule.yaml