Installation et configuration du service Mesh

Installez et configurez Istio Service Mesh pour Automation Suite sur EKS/AKS.

Important :

Les autorisations d'installation ne sont pertinentes que si vous ne pouvez pas fournir de privilèges d'administrateur au programme d'installation d'Automation Suite. Si vous pouvez fournir les privilèges d'administrateur requis au programme d'installation, vous n'avez pas besoin de suivre les instructions de cette section.

Automation Suite requiert le service Mesh Istio pour l'entrée et la mise en réseau.

L’installation et la configuration de Service Mesh sont des processus en plusieurs étapes. Laquelle des étapes que vous devez effectuer dépend de la capacité ou non d'accorder l'administrateur du programme d'installation d'Automation Suite sur votre cluster. Pour de plus amples informations, consultez le tableau suivant:

Étape	Privilèges d'administrateur	Aucun privilège d’administrateur
Étape 1 : installation du service Mesh	Étape non requise	Étapes requises
Étape 2 : configuration d'Istio et installation du plug-in WASM pour le routage	Étape non requise	Étapes requises

Étape 1 : installation du service Mesh

Pour installer Istio, consultez la documentation officielle d'Istio.

Remarque :

Automation Suite ne nécessite pas d'applications telles que Kiali et Jueger. Cependant, vous pouvez les utiliser à votre discrétion.

Fourniture de la configuration Istio

Pour fournir la configuration Istio, vous devez définir les paramètres suivants dans le fichier input.json :

"ingress": {
  "gateway_selector": {
    "istio": "ingressgateway"
  },
  "ingress_gateway_secret": "istio-ingressgateway-certs",
  "namespace": "<istio-system>",
  "istio_gateway_service_name": "istio-ingressgateway"
},

Le tableau suivant décrit les paramètres de configuration d'Istio:

Paramètre	Valeur (Value)
ingress.gateway_selector.istio	Il s'agit du libellé par défaut utilisé en interne par Automation Suite. Cependant, votre environnement peut utiliser un libellé différent pour la passerelle d'entrée Istio en fonction de la configuration du cluster. La valeur par défaut est ingressgateway.
ingress.ingress_gateway_secret	Nom de la clé secrète contenant les fichiers de certificat. La valeur par défaut est istio-ingressgateway-certs.
ingress.namespace	L'espace de noms où vous avez installé le service Mesh.
ingress.istio_gateway_service_name*	Nom du service de passerelle d’entrée Istio. La valeur par défaut est istio-ingressgateway.

* Disponible à partir d'Automation Suite 2.2510.2.

Pour vérifier le libellé utilisé par votre passerelle d'entrée Istio, exécutez la commande suivante:

kubectl -n <istio-system> get deploy istio-ingressgateway -o jsonpath="{.metadata.labels.istio}"; echo

Étape 2 : configuration d'Istio et installation du plug-in WASM pour le routage

Vue d'ensemble (Overview)

Important :

Cette étape nécessite des privilèges d'administrateur pour l'installation dans l'espace de noms Istio.

Il existe deux manières d'effectuer l'installation :

• Option A : si vous ne pouvez pas fournir les autorisations requises par le programme d'installation d'Automation Suite, vous devez effectuer cette étape avant l'installation d'Automation Suite.
• Option B: During the Automation Suite installation. This method requires the Kubeconfig file that you use during the Automation Suite installation to have the necessary permissions. To review the permissions, refer to the Granting installation permissions section. If you can provide all the necessary permissions, then skip this step.

Configuration et installation

Pour configurer Istio et installer le plug-in WASM pour le routage, procédez comme suit :

1. Créez un imagepullsecret dans l'espace de noms où vous avez installé le service Mesh. Pour créer imagepullsecret, utilisez votre workflow standard ou procédez comme suit :

   registry= <registry_url> #provide the registry where the UiPath images are hosted
   username= <user_name> #provide the username which will be used for the authentication
   password= <password> #provide the password which will be used for the authentication
   namespace= <namespace> #namespace where you want to create a secret
   
   kubectl create secret docker-registry uipathpullsecret --namespace=${namespace} \
     --docker-server=${registry} --docker-username=${username} \
     --docker-password=${password} --dry-run=client -o yaml \
     | kubectl apply -f -
   

2. Extrayez le graphique helm vers un répertoire local, <uipath-istio-configure>:

   helm pull oci://<docker-registry>/helm/istio-configure --version <istio-configure-version> \
   --untar --untardir <uipath-istio-configure>
   

   L'exemple suivant montre la commande une fois que vous avez remplacé les espaces réservés par des valeurs réelles :

   helm pull oci://registry.mycompany.com/helm/istio-configure --version 2.2510.0 \
   --untar --untardir uipath-istio-configure
   

3. Créez un fichier de valeurs de paramètre à appliquer lors de l'installation Helm de istio-configure. Utilisez l'exemple suivant comme modèle pour le fichier et remplacez les espaces réservés <fqdn>, <cluster_type>, <pullsecret>, <registry> et <uipath_namespace> par les valeurs appropriées :

   fqdn: <fqdn>    #the FQDN of the Automation Suite
   gateway:
     selector:
       istio: ingressgateway
   global:
     cluster_type: <cluster_type>    # REQUIRED. Example: eks, aks, openshift
     kubernetesDistribution: <cluster_type>  # REQUIRED. Example: eks, aks, openshift
     imagePullSecret:
       name: <pullsecret>    #name of pull secret which you had create earlier
   minProtocolVersion: TLSV1_2   #TLS versions
   uipath:
     registry: <registry>    #registry url without the protocol 
   uipathServiceNamespace: <uipath_namespace>   #namespace where the uipath application is deployed
   patchIstioService: false
   istioGatewayServiceName: "istio-ingressgateway"
   wasm:
     image:
       pullSecret: <pullsecret>    #name of pull secret which you had create earlier
       registry: oci://<registry>   #registry url without the protocol
   

4. Installez istio-configure dans l'espace de noms Istio à l'aide de Helm. Dans la commande suivante, remplacez l'espace réservé <istio_namespace> par l'espace de noms où Istio est installé et le <path_to_the_values_yaml> par l'emplacement du fichier YAML contenant les valeurs des paramètres :

   helm upgrade --debug --install --wait custom-istio-configure \
     uipath-istio-configure/istio-configure --version 2.2510.0 \
     --namespace <istio_namespace> -f <path_to_the_values.yaml>
   

5. Si vous utilisez un registre qui n'est pas signé par une autorité connue, vous devez ajouter la variable d'environnement WASM_INSECURE_REGISTRIES au déploiement istio-ingressgateway , afin qu'Istio puisse extraire l'image utilisée par le plug-in WASM. Pour ajouter la variable d'environnement, exécutez la commande suivante :

   kubectl -n <istio-system> patch deployment istio-ingressgateway --type json -p='[{"op": "add", "path": "/spec/template/spec/containers/0/env", "value": [{"name": "WASM_INSECURE_REGISTRIES", "value": "registry.mycompany.com"}]}]'
   

6. Add istio-configure to the exclude_components section in your input.json file. For details, refer to Configuring input.json.

7. Créez des clés secrètes de certificat en utilisant le nom fourni dans ingress.ingress_gateway_secret dans l'espace de noms <istio-system> .

Important :

Si vous mettez à jour le nom de domaine complet après l'installation, vous devez reconfigurer Istio et le plug-in WASM, sauf si le programme d'installation d'Automation Suite dispose de privilèges d'administration. Pour reconfigurer, vous devez suivre les étapes suivantes :

1. Update the parameter values file mentioned in Step 3 with the new FQDN.
2. Répétez toutes les étapes de configuration d'Istio et d'installation du plug-in WASM pour le routage.