Автоматизация локальной установки среды выполнения интеграции с помощью локальных сценариев PowerShell

Чтобы автоматизировать установку локальной среды выполнения интеграции на локальных компьютерах (кроме виртуальных машин Azure, где можно использовать шаблон Resource Manager), можно использовать локальные скрипты PowerShell. В этой статье представлены два сценария, которые можно использовать.

Необходимые условия

  • Запустите PowerShell на локальном компьютере. Чтобы запустить скрипты, необходимо выбрать команду "Запуск от имени администратора".
  • Скачайте локальное программное обеспечение среды выполнения интеграции. Скопируйте путь, в котором находится скачанный файл.
  • Вам также нужен ключ проверки подлинности для регистрации локальной среды выполнения интеграции.
  • Для автоматизации обновлений вручную необходимо иметь предварительно настроенную локальную среду выполнения интеграции.

Общие сведения о скриптах

Замечание

Эти скрипты создаются с помощью задокументированной служебной программы командной строки в самостоятельно размещенной среде выполнения интеграции. При необходимости можно настроить эти скрипты соответствующим образом в соответствии с потребностями службы автоматизации. Скрипты должны применяться для каждого узла, поэтому обязательно запустите его на всех узлах в случае установки высокой доступности (2 или более узлов).

  • Для автоматизации установки: установите и зарегистрируйте новый узел локальной среды выполнения интеграции с помощью InstallGatewayOnLocalMachine.ps1 . Сценарий можно использовать для установки узла локальной среды выполнения интеграции и регистрации его с помощью ключа проверки подлинности. Скрипт принимает два аргумента, в первую очередь указывая расположение локальной среды выполнения интеграции на локальном диске, второе указание ключа проверки подлинности (для регистрации локального узла IR).

  • Для автоматизации обновлений вручную: обновите локальный узел IR с определенной версией или до последней версии script-update-gateway.ps1 . Это также поддерживается, если вы отключили автоматическое обновление или хотите иметь больше контроля над обновлениями. Скрипт можно использовать для обновления узла локальной среды выполнения интеграции до последней версии или до указанной более поздней версии (более ранняя версия не работает). Он принимает аргумент для указания номера версии (например, -version 3.13.6942.1). Если версия не указана, она всегда обновляет локальную среду IR до последней версии, найденной в скачиваемых файлах.

    Замечание

    Можно указать только последние 3 версии. В идеале это используется для обновления существующего узла до последней версии. ПРЕДПОЛАГАЕТСЯ, ЧТО У ВАС ЕСТЬ ЗАРЕГИСТРИРОВАННАЯ САМОСТОЯТЕЛЬНО РАЗВЁРНУТАЯ IR.

Примеры использования

Для автоматизации установки

  1. Скачайте локальную среду IR.

  2. Укажите путь, по которому указан выше скачанный MSI-файл SHIR (файл установки). Например, если путь C:\Users\username\Downloads\IntegrationRuntime_4.7.7368.1.msi, можно использовать следующий пример командной строки PowerShell для этой задачи:

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

    Замечание

    Замените [ключ] на ключ аутентификации для регистрации вашего IR. Замените "username" на ваше имя пользователя. Укажите расположение файла "InstallGatewayOnLocalMachine.ps1" при выполнении скрипта. В этом примере мы сохранили его на рабочем столе.

  3. Если на компьютере есть одна предварительно установленная самостоятельно размещённая среда IR, скрипт автоматически удаляет её, а затем настраивает новую. Появится следующее окно: настройка среды выполнения интеграции

  4. После завершения установки и регистрации ключей вы увидите результаты успешной установки шлюза и успешной регистрации шлюза в локальной среде PowerShell. Результат выполнения скрипта 1

Для автоматизации ручных обновлений

Этот скрипт используется для обновления и установки и регистрации последней локальной среды выполнения интеграции. Выполнение скрипта выполняет следующие действия.

  1. Проверка текущей локальной версии IR
  2. Получение последней версии или указанной версии из аргумента
  3. Если существует более новая версия, чем текущая версия:
    • скачать самостоятельно размещенный IR msi
    • обновите его

Ниже приведен пример командной строки для использования этого скрипта:

  • Скачайте и установите последнюю версию шлюза:

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

  • Скачайте и установите шлюз указанной версии:

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

    Если текущая версия уже является последней, вы увидите следующий результат, предполагая, что обновление не требуется. [результат выполнения сценария 2](media/self-hosted-integration-runtime-automation-scripts/script-2-run-result.png)

  • Last updated on