Cómo crear un paquete de lanzamiento en Jitterbit App Builder

En esta página se muestra cómo crear un paquete de lanzamiento, que es una colección seleccionada de aplicaciones, fuentes de datos y otros componentes, empaquetados juntos para su despliegue. Este proceso se utiliza al trasladar una aplicación de un ambiente a otro, por ejemplo, al trasladar una aplicación de un ambiente de desarrollo a un ambiente de control de calidad y, de allí, a un ambiente de producción.

Crear un lanzamiento

La creación de una versión en un paquete y luego la instalación de un paquete en un nuevo ambiente se lleva a cabo en el área Desplegar, a la que se accede desde App Builder IDE. Durante este proceso, pasará del lado izquierdo de la pantalla Generador de plantillas de lanzamiento al lado derecho, a medida que recorre todos los pasos que se describen aquí:

1. Seleccione Cajón de acción > IDE.

2. Seleccione Desplegar > Crear lanzamiento.

3. Para iniciar una compilación, puedes seleccionar una modelo existente (si estás actualizando una actualización de una aplicación existente) o hacer clic en + Liberar para crear una nueva modelo.

4. Si utiliza una modelo existente, haga clic en el botón Plantilla para el registro de modelo existente.

5. Actualice los campos Nombre, Versión y Desarrollador en la pantalla Detalles de la versión para reflejar la compilación que está creando:

   

6. Haga clic en el botón Siguiente.

7. En la pantalla Objetos de la solución, elija lo que va en el paquete de lanzamiento. Las opciones son las siguientes:

   • Aplicación
   • Ensamblaje
   • Paquete
   • Colección
   • Origen de datos
   • Función
   • Tipo de datos lógicos
   • Página
   • Regla
   • Objeto SQL
   • Widget

   Para agregar cualquiera de estos, haga clic en el botón + Objeto, seleccione el tipo en el menú y luego haga clic en el botón Guardar:

   

   Notas

   Los siguientes puntos se aplican a los paquetes de lanzamiento:

   • Cuando agrega un objeto de aplicación, el paquete de la aplicación y la fuente de datos se agregan automáticamente al paquete de lanzamiento.

   • El paquete de lanzamiento no incluye grupos de instancias, proveedores de seguridad de instancias ni credenciales de servidor.

   • Los objetos recientemente admitidos (como funciones y tipos de datos lógicos) no se agregan automáticamente a las plantillas preexistentes. Debe agregarlos usted mismo.

8. Haga clic en el botón Siguiente.

9. La pantalla Configurar fuentes de datos enumera todas las fuentes de datos relevantes para la compilación de lanzamiento. (Si no hay fuentes de datos, se omite este paso). Para cada fuente de datos que se muestra, verifique la columna Incluir y asegúrese de que esté configurada como desea para la compilación. Según el tipo de fuente de datos, está disponible cualquiera de las siguientes opciones:

   • Solo modelo lógico: Úselo cuando desee empaquetar solo los datos que se crearon y existen en App Builder en sí. Ejemplos: datos y objetos comerciales, subconsultas, CRUD, flujo de trabajo, puentes. Esta opción se utiliza generalmente para fuentes de datos que no son de su propiedad o que no se mantienen a través de App Builder (fuentes de datos externas, fuentes de datos API, etc.).

   • Solo modelo físico: Úselo cuando desee empaquetar solo las estructuras de las tablas y columnas de la fuente de datos, sin los datos.

   • Modelo lógico y tablas físicas: Úselo cuando desee traer todos los datos existentes en App Builder en sí, así como las estructuras de columnas y tablas de fuentes de datos subyacentes. Aquí, físico se refiere a App Builder Mantener o realizar actualizaciones en la capa de base de datos actual. Si mueve un modelo físico, eso significa que cualquier cambio que se haga en el desarrollo de la base de datos también se realizará en la base de datos de control de calidad/producción al mover el modelo físico. Esta opción se usa generalmente para las fuentes de datos que administra.

   • No incluir: Use esta opción si no desea incluir esta fuente de datos en esta versión.

   Importante

   Si tiene cambios en la base de datos que deben confirmarse, debe mover Logical y Physical para esa base de datos. El proceso de administración de versiones admite la importación de tablas. Si importa tablas a una fuente de datos, esas tablas importadas se crearán en el sistema de destino si son parte del primer conjunto de cambios físicos.

10. Haga clic en el botón Siguiente.

11. Si tiene traducciones en su aplicación, aparecerá la pantalla Paquetes de soluciones. De lo contrario, aparecerá la pantalla Notas de lanzamiento con información general sobre el paquete de la versión:

    

    • Nombre: El nombre de su aplicación.

    • Versión: El número de versión del paquete que se está creando.

    • Fecha de lanzamiento: La fecha en la que quieres que aparezca el lanzamiento (esta es una fecha flexible y puede ser diferente de la fecha de lanzamiento real).

    • Fecha de compilación: La fecha en la que confirmó el paquete.

    • Fecha de publicación: La fecha en la que lanzó el paquete.

    • Descripción de la plantilla: Una descripción de texto de lo que hace su aplicación o suite.

12. Haga clic en el botón Siguiente.

13. Revise la información en la pantalla Publicar, luego haga clic en el botón Finalizar.

    Ahora debería volver a la pantalla Generador de plantillas de lanzamiento con la columna Listo con una marca de verificación verde.

14. Haga clic en el botón Cambios en la base de datos y sabrá que tiene cambios sin confirmar para revisar y confirmar si ve que aparece una marca de verificación roja en la columna DB en la pantalla Generador de plantillas de versiones. La pantalla Solicitudes de gestión de cambios enumera todos los cambios relacionados con la fuente de datos que formarán parte del paquete. Si ve algún cambio enumerado con una marca de verificación roja en la columna Estado, deberá hacer clic manualmente en él para revisarlo y aprobarlo.

    Al hacer clic en Revisar, accederá a la pantalla Solicitud de gestión de cambios. Aquí, el campo Número de parche se completa automáticamente con un valor e indica qué iteración refleja esta actualización del paquete. Asegúrese de revisar todas las entradas que aparecen en el panel Cambios para asegurarse de que esta información sea la que espera que se traslade con el paquete. En esta pantalla, debe ingresar lo siguiente:

    • Número de referencia: Puede reflejar el valor del número de parche, ser una referencia de ticket de JIRA o AHA, o utilizar un valor de numeración de cliente.

    • Descripción breve: Proporcione una descripción textual del paquete. Si lo desea, ingrese información adicional en el campo Comentarios.

15. Haga clic en el botón Guardar y, si está listo para continuar, haga clic en el botón Cerrar esta solicitud.

16. Cierre las pantallas restantes para ver la pantalla Generador de plantillas de versiones. Ahora verá aparecer una marca de verificación verde en la columna DB.

17. La Configuración de datos es opcional y solo se utiliza si está moviendo Datos lógicos y Datos físicos con el paquete. Desde la pantalla Configuración de datos, verá los elementos de línea de todas las fuentes de datos, las tablas para la fuente de datos, junto con el Tipo de propietario que se le ha asignado junto con la acción correspondiente que ocurre cuando la tabla se mueve a ese ambiente. Los diferentes Tipos de propietario son los siguientes:

    • Datos de usuario: No se transferirá ningún dato. Los usuarios de cada ambiente son responsables de completar esa tabla. Por ejemplo: Clientes o Pedidos, que son tablas transaccionales.

    • Compartir datos: Inserta los nuevos registros solo en el siguiente ambiente. Por ejemplo: Plantillas de Correo, que es una tabla en la que desea que el usuario personalice los cambios.

    • Datos del desarrollador: Trunca la tabla en QA e inserta todos los registros del paquete. Esto se suele utilizar siempre que se tienen tablas de búsqueda o tablas que forman parte de una configuración. Por ejemplo: CustomerType, EmployeeType.

18. La información se puede anular manualmente para Tipos de propietarios y configurar para el paquete específico, o simplemente puede hacer clic en Confirmar configuración. Esto marca este proceso como completo y regresa a la pantalla Generador de plantillas de versiones. Tenga en cuenta que la práctica recomendada de la metodología Jitterbit es siempre configurar el valor de Opción de instalación en el nivel de tabla, que se asigna a Tipo de propietario en la pantalla Generador de plantillas de versiones. Las Opciones de instalación son Datos de usuario, Datos compartidos y Datos de desarrollador. Si los valores se configuran en el nivel de tabla, estas configuraciones se transferirán al paquete de versión. Configurar esta información en el nivel de tabla es útil para proyectos con varios miembros del equipo.

19. El área SQL Config le permite seleccionar la base de datos y ver si hay objetos (vistas o procedimientos almacenados) almacenados en la base de datos en la capa SQL nativa. Esto le permitirá mover vistas o procedimientos almacenados. Esta información no se completará automáticamente en la pantalla Code resultante y deberá hacer clic manualmente en el botón Create y agregarlos. Este paso generalmente solo se utiliza en situaciones avanzadas y no es un paso obligatorio.

20. El paso Build mostrará la versión de este lanzamiento y te permitirá agregar notas específicas para este lanzamiento. Cuando estructuras tus notas de lanzamiento, debes usar un formato como la siguiente captura de pantalla. Es importante seguir un proceso consistente para nombrar tus notas de lanzamiento a lo largo del tiempo, especialmente si tu proyecto es uno en el que trabajan varias personas. Esto se convierte en un registro en ejecución de las notas de lanzamiento de la aplicación.

21. Haga clic en el botón Crear paquete, que inicia un trabajo en segundo plano que crea el paquete. No hay ninguna notificación que le permita saber cuándo el paquete está terminado o falla. Para verificar el estado del proceso, debe ir a App Builder IDE, Administrar servidores y programaciones y verificar el panel Trabajos en ejecución de instancias.

22. El botón Restablecer borrará toda la información asociada con la modelo del paquete y le permitirá comenzar desde cero para la creación de su paquete.

23. Haga clic en El icono Paquetes lo lleva a la pantalla de Versiones de la solución, que contiene el archivo LP descargable creado para el próximo ambiente. Este es el archivo que necesitará para instalar en el próximo ambiente. Desde esta pantalla, descargue el archivo del paquete y guárdelo localmente en su computadora.

24. Con el archivo LP disponible, vaya al siguiente ambiente donde lo instalará (QA o Prod). Desde allí, vaya a Desplegar su aplicación desde el App Builder IDE y haga clic en el botón Instalar versión.

    Sugerencia

    Para ver el contenido del paquete antes de instalarlo, haga clic en el Botón Manifestar.

25. Haga clic en el botón Crear y en Explorar para localizar el archivo del paquete y haga clic en Guardar. Al guardar, verá que el panel Solución a la derecha muestra la información del paquete sobre el nombre, la versión, el desarrollador, la fecha de lanzamiento, la descripción y las Notas de lanzamiento.

26. Haga clic en el botón Instalar después de confirmar que este es el paquete que desea instalar. Este proceso se ejecuta en primer plano. Si se ejecuta correctamente, recibirá un mensaje de confirmación. Si falla, vaya a Registros > Registros rápidos del servidor de aplicaciones y verá información de error específica sobre el motivo del error de instalación.

Horarios y paquetes de lanzamiento

Los cronogramas se incluirán en un paquete de lanzamiento (o LP) a menos que se eliminen manualmente al crear el paquete. Por diseño, los cronogramas que se han implementado en un ambiente de producción están "sellados" o se les impide realizar ciertas modificaciones en la información del cronograma. Esto evita que alguien realice cambios de desarrollo accidentalmente en un ambiente abajo en la cadena, lo que podría generar varios problemas al intentar desplegar la aplicación en el futuro. Los cronogramas son parte de una aplicación, por lo que están "sellados" en estos ambientes abajo en la cadena. Puede activar o desactivar los cronogramas o ajustar el tiempo, pero no puede cambiar el tipo de ejecución de un cronograma.

Existen algunos escenarios en los que puede configurar un Schedule en Dev pero, una vez que se encuentra en Production, el Dev Schedule se desactiva. Por ejemplo, al interactuar con una API. Es posible que solo desee interactuar con una API desde el ambiente de Production, por lo que, una vez que Dev esté completo, puede desactivar el Schedule en el ambiente de Development.

Una vez que se haya agregado un cronograma a un LP, tenga en cuenta que no todos los cambios del cronograma se incluirán en compilaciones futuras de un paquete. Si agrega o elimina eventos asociados con un cronograma, estos cambios se reflejarán en una nueva compilación. Otros cambios en una definición de cronograma no se incluirán en compilaciones futuras.

Para realizar cambios en un programa de producción sellado, puede crear un nuevo programa que luego se incluirá en el próximo LP. Este proceso garantizará que el programa se cree correctamente y que las nuevas configuraciones se reflejen en los ambientes abajo en la cadena.