Мастер пакетов интеграции

Статья
11/06/2024

Мастер пакетов интеграции (мастер IP-адресов) позволяет создать новый пакет интеграции из существующей сборки интеграции. Сборки интеграции можно создавать с помощью мастера действий командной строки (CLIActivityWizard) или с помощью пакета SDK Orchestrator. Мастер IP-адресов (IPWizard) упаковает сборки, зависимые файлы и необходимые метаданные в .OIP файл, который можно развернуть с помощью диспетчера развертывания Orchestrator. Вы можете создавать профессиональные пакеты интеграции с полной фирменной символикой и пользовательскими значками или просто упаковывать действия командной строки, чтобы их можно было проще развернуть с помощью мастера IP-адресов.

Решите, когда нужно создать пакет интеграции

Важно решить, следует ли использовать действия по отдельности с действиями пакета интеграции .NET набора средств или лучше создавать и развертывать все действия в пакете интеграции.

Если у вас есть только несколько действий или когда вы находитесь на этапе разработки и создаете много изменений в действии, следует просто использовать сборки с действиями пакета интеграции .NET для выполнения этих действий в Модулях Runbook. Упаковка, регистрация, развертывание, удаление и обновление пакетов интеграции повлечет за собой большие затраты в процессе разработки.

Если у вас есть группа действий для тестирования или вы еще больше работаете в цикле разработки и хотите протестировать весь комплексный процесс установки или обновления, то создание пакета интеграции является лучшим подходом. Пакет интеграции обеспечивает более удобный пользовательский интерфейс и полный интерфейс установки. Пакеты интеграции также позволяют развертывать действия на нескольких серверах Runbook или конструкторах Runbook в организации или для внешних клиентов.

Создание нового пакета интеграции

Мастер пакетов интеграции позволяет создавать пакеты интеграции из существующих сборок, совместимых с Orchestrator, и зависимых файлов. Если вы еще не создали сборку, совместимую с Orchestrator, см. мастер действий командной строки.

Примечание.

Набор средств интеграции больше не включает двоичные файлы для набора инструментов установщика Windows (WiX), который используется мастером IP-адресов для создания пользовательских пакетов интеграции. Установите последнюю версию (версии 3.11) набора инструментов WiX до использования мастера IP-адресов.

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

Запустите мастер интеграции пакета. Выберите мастер запуска > пакета интеграции Orchestrator. Откроется страница приветствия.
Если у вас есть существующий пакет интеграции, который вы хотите обновить, выберите "Импорт пакета интеграции". Дополнительные сведения см. в разделе "Обновление существующего пакета интеграции". Чтобы создать новый пакет интеграции, нажмите кнопку "Далее".

Внимание

Если вы хотите обновить существующий IP-адрес, необходимо выбрать импорт пакета интеграции. При нажатии кнопки "Далее" создаваемый IP-адрес будет иметь новый уникальный идентификатор продукта и новые уникальные идентификаторы для всех действий, даже если вы повторно используете предыдущую сборку и используете одинаковые имена продуктов и файлов.

На странице сведений о продукте введите или измените сведения, необходимые для настройки сведений о пакете интеграции. В таблице ниже описаны поля и их описания:

Имя поля	Description
Название продукта	Имя IP-адреса, отображаемого в Диспетчере развертывания
Название категории	Текст, отображающийся в качестве заголовка категории для IP-адреса в области действий конструктора Runbook
Company	Имя вашей компании. Эти сведения отображаются в разделе "Добавление и удаление программ" в разделе "Издатель"
Файл EULA	Текстовый файл с форматом RTF с расширением `.EULA` . EULA отображается пользователю во время регистрации с помощью диспетчера развертывания и требует принятия перед регистрацией.
Файл ресурсов	Сборка, содержащая значки и другие ресурсы, используемые для предоставления значков категории и действий. По умолчанию используется стандартный файл ресурсов Toolkit (Microsoft.SystemCenter.Orchestrator.Integration.Toolkit.Wizard.Images.dll)
Версия	Номер версии пакета интеграции, который будет отображаться в диспетчере развертывания и используется для определения того, является ли IP-адрес обновлением.
Включение обновления	Если вы импортировали существующий пакет интеграции, этот флажок выбран по умолчанию, что позволяет этому пакету интеграции обновить существующую установленную версию. Если этот флажок снят, для IP-адреса будут созданы новые идентификаторы продуктов и действий (она не будет обновлять существующую версию). Если вы хотите включить параллельное установку нескольких версий IP-адреса, снимите этот флажок.
Description	Подробное описание пакета интеграции
Значок категории	Отображается значок категории по умолчанию. Если вы хотите выбрать другой значок, нажмите кнопку "Изменить " и щелкните новый значок, а затем нажмите кнопку "ОК".

После ввода сведений о продукте нажмите кнопку "Далее". Отображается страница "Действия". Страница "Действия" содержит ссылку на сборку или сборки, содержащие действия, определенные с помощью мастера действий командной строки или созданного с помощью пакета SDK Orchestrator.
Чтобы добавить новое действие в IP-адрес, нажмите кнопку "Добавить".
Чтобы открыть и добавить файл сборки, нажмите кнопку с многоточием (...) справа от библиотеки. Перейдите к нужному файлу сборки, выберите его и нажмите кнопку "Открыть". Имя файла и путь отображаются в поле библиотеки.
Чтобы выбрать действие из сборки, щелкните стрелку раскрывающегося списка "Класс " и выберите соответствующее имя действия из списка. Имя и описание, определенные в действии, отображаются в полях отображаемого имени и описания .
При желании измените отображаемое имя и описание действия.
Значок действия по умолчанию отображается для действия. Если требуется другой значок, нажмите кнопку "Изменить", выберите другой значок в браузере и нажмите кнопку "ОК".
Нажмите кнопку "ОК ", чтобы сохранить определение действия. Имя и описание действия теперь отображаются в списке действий.
Продолжайте добавлять действия в список по мере необходимости. После завершения добавления действий нажмите кнопку "Далее". Откроется страница зависимостей и включенных файлов.
На этой странице можно определить список дополнительных файлов, которые требуется упаковать с помощью пакета интеграции. Эти файлы могут быть дополнительными сборками, необходимыми для действий, скриптов, документации или других файлов, которые вы хотите развернуть на серверах Runbook и конструкторах Runbook вместе с действиями. Выберите "Добавить", выберите нужные файлы и нажмите кнопку "ОК ", чтобы добавить файлы в список.
После добавления файлов в список нажмите кнопку "Далее". Откроется страница "Файл пакета интеграции Orchestrator".
В текстовом поле введите путь и имя файла создаваемого пакета интеграции. Если ввести имя файла, которое уже существует, он будет перезаписан. Убедитесь, что у вас достаточно доступа к записи в указанный путь или процесс завершится ошибкой. Если путь не указан, файл OIP будет создан в папке "Документы" (C:\users\<your username>\Documents). Нажмите кнопку "Рядом ", чтобы начать создание IP-адреса.

Внимание

Символы в имени файла должны быть допустимыми для языка, установленного в операционной системе.

Внимание

Укажите имя пакета интеграции, который не является общим, чтобы убедиться, что он не соответствует имени другого пакета интеграции. Orchestrator не может установить два пакета интеграции с одинаковым именем.
После успешного создания IP-адреса последняя страница мастера отобразит путь и имя файла нового файла OIP. Нажмите кнопку "Готово", чтобы выйти из мастера. Если возникла ошибка, можно выбрать "Назад " и повторить процесс сборки.

Сведения о развертывании пакета интеграции см. в статье о добавлении пакета интеграции.

Обновление существующего пакета интеграции

Мастер пакета интеграции Orchestrator позволяет импортировать существующий пакет интеграции, чтобы внести изменения и перепаковать его в качестве новой версии. Убедитесь, что установлен флажок "Включить обновление ", в противном случае новый IP-адрес будет создан вместо замены или обновления предыдущей установленной версии.

Полезные советы по обновлению IP-адресов

Обновление базовых сборок

При создании пакета интеграции метаданные об IP-адресе хранятся в пакете, чтобы его можно было считывать мастером во время последующих обновлений. При обновлении определенных элементов, таких как действия или базовые сборки для этих действий, необходимо перестроить IP-адрес. Однако если изменить параметры действия и выбрать новый файл сборки, он сбросит поля на странице сведений о действиях, требуя повторного ввода сведений.

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

Миграция пакета интеграции QIK

Если вы создали пакет интеграции с помощью мастера QIK Opalis, необходимо преобразовать его в совместимость с Orchestrator, прежде чем его можно импортировать и использовать Orchestrator.

Перед преобразованием IP-адреса необходимо выполнить следующие действия:

Если действия в IP-адресе были созданы с помощью мастера интерфейса командной строки QIK, необходимо выполнить действия, описанные в разделе "Миграция интерфейса командной строки QIK", чтобы обеспечить совместимость с Orchestrator. Если у вас нет отдельной копии сборки, содержащей действия, сначала необходимо установить IP-адрес на сервер Opalis 6.3, а затем найти сборку в следующем каталоге: C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions\Support\Quick Integration Kit 3
Если действия в IP-адресе были пользовательскими, разработанными в C# с помощью API Opalis, необходимо выполнить действия, описанные в разделе "Миграция пользовательских действий API QIK", чтобы сделать их совместимыми с Orchestrator.

Примечание.

Действия на основе Java с помощью API Opalis для Java больше не поддерживаются набором средств интеграции или Orchestrator.
Если IP-адрес содержит зависимые или другие включенные файлы, эти файлы должны быть доступны для перепаковки в новый IP-адрес. Если у вас нет отдельной копии этих файлов, сначала необходимо установить IP-адрес на сервер Opalis 6.3, а затем найти файлы в следующем каталоге: C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions\Support\Bin
Если IP-адрес содержит пользовательский файл ресурсов, используемый для значков действий и категорий, этот файл должен быть доступен для нового IP-адреса. Если у вас нет отдельной копии этого файла, сначала необходимо установить IP-адрес на сервер Opalis 6.3, а затем найти файл в следующем каталоге: C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions
Если IP-адрес использовал стандартные значки, предоставляемые QIK для значков категории или действий, и вы хотите продолжать использовать эти значки вместо использования новых значков, предоставленных в Orchestrator, вам потребуется получить Opalis.QIK.Wizard.Images.dll файл и использовать его в качестве пользовательского файла ресурсов. Если у вас нет отдельной копии этого файла, сначала необходимо установить IP-адрес на сервер Opalis 6.3, а затем найти файл в следующем каталоге: C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions

Примечание.

Для простого процесса преобразования необходимо разместить все эти файлы в расположениях, в которые они находились, когда IP-адрес был первоначально упаковирован перед запуском мастера IP-адресов. Мастер IP-адресов ссылается на эти файлы по их исходным путям. Выбор нового пути возможен для всех файлов, но выбор нового пути для сборок, содержащих действия, приведет к сбросу некоторых сведений о действии, требуя повторного ввода сведений. Используя исходные пути для файлов, существующие сведения просто повторно используются без повторного ввода.

Преобразование пакета интеграции, совместимого с Opalis

Запуск мастера пакета интеграции
Выберите пакет интеграции импорта.
Выберите существующий файл OIP и нажмите кнопку "Открыть".
Появится предупреждение, указывающее, что IP-адрес несовместим с Orchestrator. Нажмите ОК.
Измените сведения о продукте по мере необходимости, чтобы отразить любые изменения. Номер версии IP-адреса автоматически увеличивается, а флажок "Обновить" установлен. Выберите Далее.
На странице "Действия" просмотрите каждое действие и убедитесь, что информация завершена правильно. Если сборка для действия не была перенесена или не находится в том же расположении, что и при создании IP-адреса, поле класса будет пустым. Чтобы предотвратить повторное ввод сведений, перед запуском мастера необходимо заменить сборку.
После завершения действий по редактированию нажмите кнопку "Далее".
Убедитесь, что зависимые файлы по-прежнему находятся в том же расположении, что и показано, или удалите их и добавьте новые зависимые файлы. Выберите Далее.
Введите путь и имя файла для нового IP-файла. Не используйте то же имя, что и предыдущий IP-адрес, чтобы обеспечить сохранение копии предыдущего IP-адреса. Нажмите кнопку "Далее ", чтобы создать IP-адрес.

Теперь у вас есть IP-адрес, совместимый с Orchestrator и который можно зарегистрировать и развернуть с помощью Orchestrator Deployment Manager.

Пакеты интеграции — известные проблемы

Ограничение длины файла

При включении сборок в пакет интеграции они автоматически добавляются в реестр установщиком. Из-за ограничения длины имени раздела реестра объединенный путь и имя файла сборки не может превышать 234 символов. Учитывая путь по умолчанию, по которому размещаются сборки в IP-адресе, максимальная длина имени файла включенной сборки не может превышать 80 символов. Если сборка с именем файла, превышающей 80 символов, включена в установку, установка завершится ошибкой.

Ресурсы Orchestrator

Помимо этой ссылки в Интернете, предоставленной для System Center Orchestrator, существует множество ресурсов, которые могут предоставить дополнительные сведения о создании модулей Runbook, используя набор средств интеграции и рекомендации.

Поделиться через