Automatisation de l’installation du runtime d’intégration auto-hébergé à l’aide de scripts PowerShell locaux

  • Article

Pour automatiser l’installation du runtime d’intégration auto-hébergé sur des ordinateurs locaux (autres que des machines virtuelles Azure pour lesquelles nous pouvons tirer parti du modèle Resource Manager), vous pouvez utiliser des scripts PowerShell locaux. Cet article présente deux scripts que vous pouvez utiliser.

Prérequis

  • Lancez PowerShell sur votre ordinateur local. Pour exécuter les scripts, vous devez choisir Exécuter en tant qu’administrateur.
  • Téléchargez le logiciel du runtime d'intégration auto-hébergé. Copiez le chemin d’accès où se trouve le fichier téléchargé.
  • Vous avez également besoin d’une clé d’authentification pour inscrire le runtime d’intégration auto-hébergé.
  • Pour automatiser les mises à jour manuelles, vous devez disposer d’un runtime d’intégration auto-hébergé préconfiguré.

Introduction aux scripts

Notes

Ces scripts sont créés à l’aide de l’utilitaire de ligne de commande documenté dans le runtime d’intégration auto-hébergé. Si nécessaire, vous pouvez personnaliser ces scripts en conséquence pour répondre à leurs besoins d’automatisation. Les scripts doivent être appliqués par nœud. Veillez donc à les exécuter sur tous les nœuds en cas de configuration à haute disponibilité (deux nœuds ou plus).

  • Pour l’automatisation de l’installation : Installez et inscrivez un nouveau nœud de runtime d’intégration auto-hébergé à l’aide de InstallGatewayOnLocalMachine.ps1 - Le script peut être utilisé pour installer le nœud du runtime d’intégration auto-hébergé et l’inscrire avec une clé d’authentification. Le script accepte deux arguments, le premier spécifiant l’emplacement du runtime d’intégration auto-hébergé sur un disque local, le deuxième spécifiant la clé d’authentification (pour l’inscription du nœud du runtime d’intégration auto-hébergé).

  • Pour automatiser les mises à jour manuelles : Mettez à jour le nœud du runtime d’intégration auto-hébergé avec une version spécifique ou la version la plus récente script-update-gateway.ps1 - Cette option est également prise en charge si vous avez désactivé la mise à jour automatique ou si vous souhaitez avoir davantage de contrôle sur les mises à jour. Le script peut être utilisé pour mettre à jour le nœud du runtime d’intégration auto-hébergé vers la version la plus récente ou vers une version supérieure spécifiée (il n’est pas possible de passer à une version antérieure). Il accepte un argument pour spécifier le numéro de version (exemple : version 3.13.6942.1). Si aucune version n’est spécifiée, il met toujours à jour le runtime d’intégration auto-hébergé avec la dernière version trouvée dans les téléchargements.

    Notes

    Seules les 3 dernières versions peuvent être spécifiées. Dans l’idéal, il est utilisé pour mettre à jour un nœud existant vers la dernière version. IL PART DU PRINCIPE QUE VOUS DISPOSEZ D’UN RUNTIME D'INTÉGRATION AUTO-HÉBERGÉ ENREGISTRÉ.

Exemples d'utilisation

Pour l’automatisation de l’installation

  1. Téléchargez le runtime d’intégration auto-hébergé.

  2. Spécifiez le chemin d’accès vers le fichier SHIR MSI (fichier d’installation) téléchargé précédemment. Par exemple, si le chemin d’accès est C:\Users\username\Downloads\IntegrationRuntime_4.7.7368.1.msi, vous pouvez utiliser l’exemple de ligne de commande PowerShell suivant pour cette tâche :

    PS C:\windows\system32> C:\Users\username\Desktop\InstallGatewayOnLocalMachine.ps1 -path "C:\Users\username\Downloads\IntegrationRuntime_4.7.7368.1.msi" -authKey "[key]"

    Notes

    Remplacez [key] par la clé d’authentification pour inscrire votre runtime d'intégration. Remplacez « username » par votre nom d’utilisateur. Spécifiez l’emplacement du fichier « InstallGatewayOnLocalMachine.ps1 » lors de l’exécution du script. Dans cet exemple, nous l’avons stocké sur le bureau.

  3. Si un runtime d’intégration auto-hébergé est préinstallé sur votre ordinateur, le script le désinstalle automatiquement, puis en configure un nouveau. Vous verrez la fenêtre suivante apparaître : configurer le runtime d’intégration

  4. Une fois l’installation et l’inscription de la clé terminées, vous verrez les résultats Réussite de l’installation de la passerelle et Réussite de l’inscription la passerelle dans votre PowerShell local. résultat de l’exécution du script 1

Pour automatiser les mises à jour manuelles

Ce script est utilisé pour mettre à jour/installer + inscrire le dernier runtime d’intégration auto-hébergé. L’exécution du script effectue les étapes suivantes :

  1. Vérifier la version actuelle du runtime d’intégration auto-hébergé
  2. Obtenir la version la plus récente ou la version spécifiée à partir de l’argument
  3. S’il existe une version plus récente que la version actuelle :
    • télécharger le fichier msi du runtime d'intégration auto-hébergé
    • le mettre à niveau

Vous pouvez suivre l’exemple de ligne de commande ci-dessous pour utiliser ce script :

  • Télécharger et installer la passerelle la plus récente :

    PS C:\windows\system32> C:\Users\username\Desktop\script-update-gateway.ps1

  • Télécharger et installer la passerelle de la version spécifiée :

    PS C:\windows\system32> C:\Users\username\Desktop\script-update-gateway.ps1 -version 3.13.6942.1

    Si votre version actuelle est déjà la plus récente, vous verrez le résultat suivant, car aucune mise à jour n’est requise. [résultat de l’exécution du script 2](media/self-hosted-integration-runtime-automation-scripts/script-2-run-result.png)