Asistente para paquetes de integración

Artículo
11/06/2024

El Asistente para paquetes de integración (Asistente para IP) permite crear un nuevo paquete de integración a partir de un ensamblado de integración existente. Los ensamblados de integración se pueden crear mediante el Asistente para actividad de línea de comandos (CLIActivityWizard) o mediante el SDK de Orchestrator. El Asistente para IP (IPWizard) empaqueta los ensamblados, los archivos dependientes y los metadatos necesarios en un archivo .OIP que se puede implementar a través de Orchestrator Deployment Manager. Puedes crear paquetes de integración de aspecto profesional con iconos personalizados y de marca completos, o simplemente empaquetar actividades de línea de comandos para que se puedan implementar con más facilidad mediante el Asistente para IP.

Decidir cuándo crear un paquete de integración

Es importante decidir si es adecuado usar actividades individualmente con las actividades del Paquete de integración de .NET del kit de herramientas, o es mejor crear e implementar todas las actividades en un paquete de integración.

Cuando solo tienes pocas actividades o cuando te encuentras en la fase de desarrollo y creas muchos cambios en una actividad, solo debes usar los ensamblados con las actividades del paquete de integración de .NET del kit de herramientas para ejecutar esas actividades en Runbooks. El empaquetado, el registro, la implementación, la desinstalación y la actualización de los paquetes de integración conllevan una gran sobrecarga en el proceso de desarrollo.

Si tienes un grupo de actividades para probar o vas más allá en el ciclo de desarrollo y deseas probar todo el proceso de instalación o actualización, la creación de un paquete de integración es el mejor enfoque. El paquete de integración proporciona una experiencia más fácil de usar y una experiencia de instalación completa. Los paquetes de integración también permiten la implementación de las actividades en varios servidores de Runbook o Runbook Designer en toda la organización o en clientes externos.

Creación de un nuevo paquete de integración

El Asistente para paquetes de integración permite crear paquetes de integración a partir de los archivos dependientes y los ensamblados compatibles con Orchestrator existentes. Si aún no has creado un ensamblado compatible con Orchestrator, consulta el Asistente para actividad de línea de comandos.

Nota:

El kit de herramientas de integración ya no incluye los archivos binarios para el conjunto de herramientas XML (WiX) de Windows Installer, que usa el Asistente para IP para crear paquetes de integración personalizados. Instala la versión más reciente (v3.11) del conjunto de herramientas de WiX antes de usar el Asistente para IP.

Para crear un nuevo paquete de integración, siga estos pasos:

Inicia el Asistente para paquetes de integración. Selecciona Inicio > Orchestrator Integration Pack Wizard . Aparece la página principal.
Si tienes un paquete de integración existente que deseas actualizar, selecciona Import Integration Pack. Para obtener más información, consulta Actualización de un paquete de integración existente. Para crear un nuevo paquete de integración, selecciona Siguiente.

Importante

Si deseas actualizar una dirección IP existente, debes seleccionar Import Integration Pack. Si seleccionas Next, la dirección IP que crees tendrá un nuevo id. del producto único y nuevos id. únicos para todas las actividades, incluso si vuelves a usar un ensamblado anterior y usas el mismo producto y nombres de archivo.

En la página Detalles del producto, escribe o modifica la información según sea necesario para personalizar la información sobre el paquete de integración. En la tabla siguiente se enumeran los campos y su descripción:

Nombre del campo	Descripción
Nombre del producto	Nombre de la dirección IP que se muestra en Deployment Manager
Nombre de la categoría	Texto que se muestra como título de categoría para la dirección IP en el panel Actividades de Runbook Designer
Empresa	Nombre de tu empresa. Esta información se muestra en Agregar o quitar programas en "Publisher"
Archivo CLUF	Un archivo de texto con formato RTF con una extensión `.EULA`. El CLUF se muestra al usuario durante el registro mediante Deployment Manager y requiere la aceptación antes del registro.
Archivo de recursos	Ensamblado que contiene iconos y otros recursos usados para proporcionar los iconos de categoría y actividad. De forma predeterminada, se usa el archivo de recursos standard del kit de herramientas (Microsoft.SystemCenter.Orchestrator.Integration.Toolkit.Wizard.Images.dll)
Versión	Número de versión del paquete de integración, que se mostrará en Deployment Manager y se usará para determinar si la dirección IP es una actualización.
Habilitación de la actualización	Si has importado un paquete de integración existente, esta casilla está activada de forma predeterminada, lo que permite que el paquete de integración actualice una versión instalada existente. Si desactivas la casilla, se crearán nuevos identificadores de producto y actividad para la IP (no actualizará la versión existente). Si deseas habilitar la instalación en paralelo de varias versiones de la IP, desactiva la casilla.
Descripción	Una descripción detallada del paquete de integración
Icono de categoría	Se muestra el icono de categoría predeterminado. Si deseas elegir otro icono, selecciona el botón Modificar y elige uno nuevo. Después, selecciona Aceptar.

Cuando hayas terminado de escribir la información del producto, selecciona Siguiente. Se muestra la página Actividades. La página Actividades es donde harás referencia a los ensamblados que contienen las actividades que has definido mediante el Asistente para actividad de línea de comandos o creado mediante el SDK del orquestador.
Para agregar una nueva actividad a la IP, selecciona Agregar.
Para abrir y agregar el archivo de ensamblado, selecciona el botón de puntos suspensivos (...) situado a la derecha de Library. Ve al archivo de ensamblado deseado, selecciónalo y selecciona Open. El nombre de archivo y la ruta de acceso se muestran en el campo Biblioteca.
Para seleccionar una actividad del ensamblado, selecciona la flecha del elemento desplegable Clase y elige el nombre de actividad adecuado en la lista. El nombre y la descripción definidos en la actividad se muestran en los campos Nombre para mostrar y Descripción.
Si lo deseas, modifica el nombre para mostrar y la descripción de la actividad.
Se muestra el icono de actividad predeterminado para la actividad. Si se desea un icono diferente, selecciona Modificar, elige otro icono en el explorador y selecciona Aceptar.
Selecciona Aceptar para guardar la definición de la actividad. El nombre y la descripción de la actividad aparecen ahora en la lista Actividades.
Continúa agregando actividades a la lista según sea necesario. Cuando hayas terminado de agregar actividades, selecciona Siguiente. Se muestra la página Dependencias y archivos incluidos.
En esta página, puedes definir una lista de archivos adicionales que quieras empaquetar con el paquete de integración. Estos archivos pueden ser ensamblados adicionales requeridos por tus actividades, scripts, documentación u otros archivos que quieras implementar en Runbook Servers y Runbook Designers con tus actividades. Selecciona Agregar, elige los archivos que necesitas y, luego, selecciona Aceptar para agregar archivos a la lista.
Cuando hayas terminado de agregar archivos a la lista, selecciona Siguiente. Se muestra la página Archivo del paquete de integración del orquestador
En el cuadro de texto proporcionado, escribe la ruta de acceso y el nombre de archivo del paquete de integración que se va a crear. Si escribes un nombre de archivo que ya existe, se sobrescribirá. Asegúrate de que tienes acceso suficiente para escribir en la ruta de acceso especificada o se producirá un error en el proceso. Si no se especifica ninguna ruta de acceso, el archivo OIP se creará en la carpeta Documentos (C:\users\<your username>\Documents). Selecciona Siguiente para empezar a compilar la IP.

Importante

Los caracteres del nombre de archivo deben ser válidos para el idioma del sistema operativo.

Importante

Especifica un nombre para el paquete de integración que no sea habitual para asegurarte de que no coincide con el nombre de otro paquete de integración. El orquestador no puede instalar dos paquetes de integración con el mismo nombre.
Cuando la IP se haya compilado correctamente, la página final del asistente mostrará la ruta de acceso y el nombre de archivo del nuevo archivo OIP. Para salir del asistente, selecciona Finalizar. Si se produce un error, puedes seleccionar Atrás y volver a intentar el proceso de compilación.

Para obtener información sobre cómo implementar el paquete de integración, consulta el artículo Cómo agregar un paquete de integración.

Actualización de un paquete de integración existente

El Asistente para paquetes de integración del orquestador permite importar un paquete de integración existente para que puedas realizar cambios y volver a empaquetarlo como una nueva versión. Asegúrate de activar la casilla Habilitar actualización, de lo contrario, se creará una nueva IP en lugar de reemplazar o actualizar la versión anterior instalada.

Sugerencias útiles para la actualización de IP

Actualización de ensamblados subyacentes

Al crear un paquete de integración, los metadatos de la IP se almacenan en el paquete para que el asistente pueda leerlos durante las actualizaciones posteriores. Al actualizar determinados elementos, como las actividades o los ensamblados subyacentes para tales actividades, debes volver a generar la IP. Sin embargo, si modificas la configuración de actividad y seleccionas un nuevo archivo de ensamblado, este restablecerá los campos de la página Información de actividad, por lo que tendrás que volver a escribir la información.

Puedes conservar la configuración de IP al modificar solo el ensamblado. Guarda el nuevo ensamblado en la misma ruta de acceso y con el mismo nombre de archivo que el ensamblado anterior (que se muestra en el campo Biblioteca del cuadro de diálogo Información de actividad).

Migración del paquete de integración de QIK

Si has creado un paquete de integración mediante el Asistente de Opalis QIK, deberás convertirlo para que sea compatible con el orquestador para poder importarlo y usarlo.

Antes de convertir una IP, se deben completar los pasos siguientes:

Si las actividades de la IP se crearon mediante el Asistente para la CLI de QIK, debes seguir los pasos descritos en Migración de actividad de la CLI de QIK para que sean compatibles con el orquestador. Si no tienes una copia independiente del ensamblado que contiene las actividades, deberás instalar primero la IP en un servidor Opalis 6.3 y, luego, buscar el ensamblado en el siguiente directorio: C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions\Support\Quick Integration Kit 3.
Si las actividades de la IP se desarrollaron de forma personalizada en C# mediante la API de Opalis, debes seguir los pasos descritos en Migración de actividades personalizadas de la API de QIK para que sean compatibles con el orquestador.

Nota:

Las actividades basadas en Java que usan la API de Opalis para Java ya no son compatibles con Integration Toolkit ni con el orquestador.
Si la dirección IP contiene archivos dependientes u otros incluidos, estos deben estar disponibles para volver a empaquetar en la nueva IP. Si no tienes una copia independiente de estos archivos, deberás instalar primero la IP en un servidor Opalis 6.3 y, luego, buscar los archivos en el directorio siguiente: C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions\Support\Bin.
Si la IP contiene un archivo de recursos personalizado que se usa para los iconos de actividad y categoría, el archivo debe estar disponible para la nueva IP. Si no tienes una copia independiente de este archivo, deberás instalar primero la IP en un servidor Opalis 6.3 y, luego, buscar el archivo en el directorio siguiente: C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions.
Si la IP usó los iconos estándar proporcionados por QIK para los iconos de categoría o actividad y quieres seguir usándolos en lugar de los nuevos iconos proporcionados en el orquestador, deberás obtener el archivo Opalis.QIK.Wizard.Images.dll y usarlo como lo harías con un archivo de recursos personalizado. Si no tienes una copia independiente de este archivo, deberás instalar primero la IP en un servidor Opalis 6.3 y, luego, buscar el archivo en el directorio siguiente: C:\Program Files (x86)\Common Files\Opalis Software\Opalis Integration Server\Extensions.

Nota:

Para que el proceso de conversión resulte sencillo, debes colocar todos estos archivos en las ubicaciones en las que estaban cuando la IP se empaquetó originalmente antes de iniciar el Asistente para IP. El Asistente para IP se refiere a dichos archivos mediante sus rutas de acceso originales. Es posible seleccionar una nueva ruta de acceso para todos los archivos, pero al seleccionar una nueva ruta de acceso para los ensamblados que contienen las actividades, se restablecerán algunos de los detalles de la actividad, por lo que tendrás que volver a introducir la información. Mediante el uso de las rutas de acceso originales de los archivos, la información existente se reutiliza simplemente, sin tener que volver a escribirla.

Conversión de un paquete de integración compatible con Opalis

Inicia el Asistente para paquetes de integración
Selecciona el paquete de integración de importación.
Selecciona el archivo OIP existente y, luego, Abrir.
Verás un mensaje de advertencia que indica que la IP no es compatible con el orquestador. Seleccione Aceptar.
Modifica los detalles del producto según sea necesario para reflejar los cambios. El número de versión de la IP se incrementa automáticamente y la casilla "Actualizar" se activa. Seleccione Siguiente.
En la página Actividades, repasa todas las actividades y asegúrate de que la información se ha completado correctamente. Si el ensamblado de la actividad no se ha migrado o no está en la misma ubicación que cuando se creó la IP, el campo Clase estará vacío. Para evitar tener que volver a escribir cualquier información, debes reemplazar el ensamblado antes de iniciar el asistente.
Cuando hayas terminado de editar actividades, selecciona Siguiente.
Asegúrate de que los archivos dependientes siguen estando en la misma ubicación como se muestra, o quítalos y agrega archivos dependientes nuevos. Seleccione Siguiente.
Escribe una ruta de acceso y un nombre de archivo para el nuevo archivo IP. No uses el mismo nombre que la IP anterior para poder asegurarte de conservar una copia. Selecciona Siguiente para compilar la IP.

Ahora tienes una IP compatible con el orquestador y puedes registrarla e implementarla mediante el administrador de implementaciones del orquestador.

Paquetes de integración: problemas conocidos

Limitación de longitud del nombre de archivo

Al incluir ensamblados en el paquete de integración, el instalador los agrega automáticamente al registro. Debido a la limitación de la longitud del nombre de la clave del Registro, la ruta de acceso y el nombre de archivo de un ensamblado juntos no pueden superar los 234 caracteres. Dada la ruta de acceso predeterminada donde se colocan los ensamblados en una IP, la longitud máxima del nombre de archivo de un archivo de ensamblado incluido no puede superar los 80 caracteres. Si se incluye en la instalación un ensamblado con un nombre de archivo que supere los 80 caracteres, se producirá un error en la instalación.

Recursos de Orchestrator

Además de esta referencia en línea proporcionada para el orquestador de System Center, hay numerosos recursos que pueden proporcionar información adicional sobre la creación de runbooks, el uso del kit de herramientas de integración y los procedimientos recomendados.

Compartir a través de