Mise à jour de la configuration d'Orchestrator

Mettez à jour la configuration d'Orchestrator. Assurez-vous de revoir les éléments suivants :

• Configuration personnalisée de UiPath.Orchestrator.dll.config
• Tous les paramètres web.config.
• Stockage (packages, supports d'exécution et données de compartiments) : principalement applicable à Storage.Type=FileSystem
• Cibles NLog personnalisées.
• Magasins d'identifiants personnalisés.
• Clé de chiffrement par configuration de locataire.

Vous pouvez simplifier la plupart des étapes suivantes à l'aide de l'outil Orchestrator Configurator fourni.

L'outil bash orchestrator_configurator.sh peut mettre à jour le mappage de configuration personnalisé d'Orchestrator et télécharger des fichiers vers les emplacements de stockage Blob connus d'Orchestrator. Utilisez le paramètre -y pour ignorer la confirmation des actions proposées.

Configuration de web.config

Modifiez la carte de configuration orchestrator-customconfig à l'aide d'un outil tel que Lens ou kubectl.

Configurez la limite de requêtes dans le fichier values.json. Le déploiement d'Orchestrator devrait redémarrer automatiquement après ce changement de configuration.

{
  "Kestrel": {
    "Limits": {
      "MaxRequestBodySize": 314572800
    }
  }

Configuration des paramètres d'application

Le fichier appSettings.custom.json modifié dans les étapes de pré-migration contient maintenant toute la personnalisation nécessaire dans la section appSettings. Vous devez placer ce fichier .json dans la carte de configuration orchestrator-customconfig, dans le fichier values.json, sous la clé appSettings.

{
    "ExampleSetting.Enabled": true,
    "ExampleSetting.Type": "BasicExample",
    "ExampleSetting.Count": 3
}

L'outil Orchestrator Configurator peut fusionner les clés dans les paramètres de l'application personnalisés avec les clés déjà présentes dans la carte de configuration. Vous pouvez importer les paramètres de l'application à l'aide du paramètre -c|--app-settings :

./orchestrator-configurator.sh -c appSettings.custom.json

Si vous utilisez l'outil de configuration, suivez toutes les étapes pour rassembler tous les remplacements des paramètres de l'application requis, puis exécutez une fois le script à la fin de la procédure.

Configuration du stockage

Si vous passez du stockage FileSystem au fournisseur de stockage d’Orchestrator, utilisez l’Outil de configuration d’Orchestrator afin de transférer le contenu du stockage.

Chargez les fichiers à l’aide du paramètre -s|--storage-folder dans l’outil de configuration d’Orchestrator, dans lequel path désigne le dossier parent. Remplacez le chemin par l’emplacement du dossier où vos fichiers sont stockés. Pour déterminer le chemin, vérifiez le paramètre Storage.Path dans UiPath.Orchestrator.dll.config.

Afin de garantir que le dossier est correct, la hiérarchie suivante doit être respectée :

• Un dossier nommé Orchestrator-Host\Libraries.

• Un dossier pour chaque locataire, nommé Orchestrator-[tenantKey].

./orchestrator-configurator.sh -s path

La commande va charger le contenu du dossier de chemin au fournisseur de stockage configuré.

Remarque :

• L’Outil de configuration d’Orchestrator prend uniquement en charge CEPH, S3 (ou compatible) et Azure Blob Storage. Pour tout autre stockage, veuillez copier manuellement le contenu vers le nouvel emplacement.

Pour utiliser le réseau FileStore, modifiez les paramètres de l'application Orchestrator ArgoCD et définissez les éléments suivants :

• storage.type = smb
• storage.smb.domain
• storage.smb.password
• storage.smb.source
• storage.smb.username
• storage.smb.size

Pour configurer d'autres options de stockage, modifiez les paramètres de l'application Orchestrator ArgoCD et définissez les éléments suivants :

• storage.type au fournisseur souhaité. La valeur est sensible à la casse. Les valeurs possibles sont : Azure, AWS, Minio.
• storage.connectionString

Présentation des paramètres de stockage de l'application Orchestrator :

Configurer un compartiment pour stocker tous les locataires

Si vous utilisez des compartiments de stockage externes, vous pouvez demander à Orchestrator de stocker des données dans un seul compartiment externe sans lui attribuer d'autorisations d'administration au compte de stockage externe à l'aide de l'indicateur --use-external-storage .

Configuration des compartiments de stockage Azure/Amazon S3

L’accès du navigateur Web Orchestrator aux compartiments de stockage Amazon et Azure peut être restreint en raison de la politique de même origine côté fournisseur. Pour accéder avec succès au contenu d’un tel compartiment, vous devez configurer le fournisseur concerné pour autoriser les requêtes d’origine croisée générées depuis Orchestrator.

Consultez les instructions sur la façon de configurer chaque fournisseur pour autoriser les requêtes d’origine croisée depuis Orchestrator.

Configuration de NLog

Pour installer les extensions NLog, celles-ci doivent être copiées dans Ceph, dans le compartiment uipath. Le pod Orchestrator pourra alors les charger au démarrage. Vous devez également placer la configuration dans orchestrator-customconfig dans le fichier nlog.json.

Le configurateur peut le faire avec les paramètres -n|--nlog-extensions-folder et -l|--nlog-config-file.

./orchestrator-configurator.sh -n nlogextensions -l nlog.custom.json

Les plug-ins seront disponibles dans le pod Orchestrator sous le chemin local /var/orchestrator/plugins/nlog. Le configurateur met automatiquement à jour les chemins d'assemblyFile en y ajoutant le chemin des plugins.

Configuration des magasins d'informations d'identification

Les modifications de configuration des magasins d'identifiants sont incluses dans appsettings.custom.json ; il n'y a donc plus de mises à jour de configuration requises.

Pour effectuer les modifications manuellement, placez-les dans le fichier values.json de orchestrator-customconfig sous la section appSettings.

Si des assemblages de magasins sécurisés sont également requis, vous devez les placer dans n'importe quel pod Orchestrator sur le chemin /var/orchestrator/plugins/securestore/.

L'outil de configuration d'Orchestrator peut le faire à l'aide du paramètre -p|--securestore-plugins-folder :

./orchestrator-configurator.sh -p securestoreplugins

Configuration de la clé de chiffrement

Pour configurer la clé de chiffrement, remplacez-la dans la clé secrète Kubernetes orchestrator-generated-secrets en écrasant la valeur de APPSETTINGS__EncryptionKey. Pour ce faire, exécutez la commande suivante :

ENCRYPT_KEY=$(echo <key>|base64 -w 0)
kubectl -n uipath patch secret orchestrator-generated-secrets --type='json' \
-p="[{'op': 'replace', 'path': '/data/APPSETTINGS__EncryptionKey', 'value':'$ENCRYPT_KEY'}]"

Remarque : Assurez-vous de remplacer <key> par la valeur de la clé extraite de UiPath.Orchestrator.dll.config.

Configuration de la clé de chiffrement par locataire

Pour migrer la clé de chiffrement par locataire, procédez comme suit :

1. Ajoutez les paramètres AzureKeyVault et le certificat dans l'interface utilisateur ArgoCD, en tant que paramètres de remplacement pour l'application Orchestrator.
   • encryptionKeyPerTenant.certificateBase64
   • encryptionKeyPerTenant.certificatePassword
   • encryptionKeyPerTenant.clientId
   • encryptionKeyPerTenant.directoryId
   • encryptionKeyPerTenant.vaultAddress
   1. Utilisez les valeurs des clés de configuration suivantes (référencées dans les étapes de préparation) :
      • Azure.KeyVault.VaultAddress
      • Azure.KeyVault.ClientId

      • Azure.KeyVault.DirectoryId

   2. b. Convertissez le certificat en base64 et utilisez-le comme remplacement de paramètre. Pour le convertir, utilisez la commande suivante :

      PowerShell :

      [convert]::ToBase64String((Get-Content -path "path_to_certificate" -Encoding byte))

      Shell :

      base64 [_path_to_certificate_]

2. Appliquez les remplacements de paramètre de l'application Orchestrator ArgoCD, puis exécutez l'outil Orchestrator Configurator.
3. Une fois la nouvelle configuration reflétée dans ArgoCD, attendez que l'application soit à nouveau synchronisée.
4. Activez la fonctionnalité EncryptionKeyPerTenant comme suit :
   • utilisez les deux paramètres placés dans appSettings.custom.json et exécutez l'outil Orchestrator Configurator ;
   • ou manuellement dans le orchestrator-customconfig, dans la section appConfig du fichier values.json.

   "EncryptionKeyPerTenant.Enabled": "true", "EncryptionKeyPerTenant.KeyProvider": "AzureKeyVault",

5. Redémarrez le déploiement d'Orchestrator Automation Suite à partir du cluster pour que les modifications prennent effet.
   Remarque : Les paramètres SMTP dans Identity Server ne sont pas chiffrés avec la clé par locataire. Une fois la migration terminée, assurez-vous de saisir à nouveau le mot de passe SMTP dans le portail Automation Suite.