Transferir (migrar) un proyecto a un entorno en Jitterbit Integration Studio

Introducción

La transferencia de proyectos mueve proyectos entre entornos dentro de una sola organización de Harmony. Esta función te ayuda a promover cambios de diseño a través de tu ciclo de vida de desarrollo. Utiliza la transferencia de proyectos para mantener entornos de desarrollo, pruebas y producción separados. La transferencia de proyectos asegura un despliegue controlado de cambios.

La transferencia de proyectos proporciona un despliegue controlado al mover proyectos o componentes a través de etapas de desarrollo de manera planificada. Mantiene el aislamiento del entorno al mantener separados el desarrollo, las pruebas y la producción. La transferencia de proyectos crea un registro de auditoría para rastrear el historial de transferencias con fines de cumplimiento.

Puedes utilizar la transferencia de proyectos para lograr lo siguiente:

• Mover proyectos o componentes entre entornos en la misma organización.
• Promover cambios a través de las etapas de desarrollo.
• Mantener configuraciones específicas del entorno.
• Preservar el historial de transferencias y dependencias.

Puedes transferir proyectos utilizando cualquiera de estas dos opciones:

1. Transferencia de proyecto completo: Transfiere todo el proyecto a un entorno. (Esta opción aparece como Migrar en la interfaz actual.)

2. Transferencia selectiva (Beta): Transfiere solo componentes especificados a un entorno.

La siguiente tabla compara las características clave de cada opción de transferencia:

Prerrequisitos

Antes de transferir un proyecto o componente de proyecto, completa estos requisitos:

• Asegúrate de tener el acceso apropiado en ambos entornos, el de origen y el de destino.

• Verifica que el entorno de destino tenga el tipo de agente necesario (en la nube o privado) si utilizas características que están limitadas a un cierto tipo de agente.

Cadenas de transferencia

Una cadena de transferencia es una secuencia vinculada de entornos a través de los cuales un proyecto se mueve durante su ciclo de vida. Una vez establecidas, estas cadenas crean dependencias que debes gestionar cuidadosamente.

Flujo de transferencia típico

Un flujo de trabajo típico implica estos pasos:

[Desarrollo] → [QA/Pruebas] → [Producción]
     ↓               ↓               ↓
  (Crear)      (Probar/Corregir)      (Entrar en Vivo)

1. Crea un proyecto en un entorno de desarrollo.
2. Transfiere a un entorno de QA (Aseguramiento de Calidad) para pruebas.
3. Corrige cualquier problema en el entorno de desarrollo.
4. Transfiere al entorno de QA nuevamente para volver a probar.
5. Transfiere de QA a producción cuando esté listo.
6. Repite los pasos 3-5 para cambios continuos.

Las transferencias de proyectos se basan en IDs internos, no en nombres, por lo que los proyectos renombrados mantienen sus relaciones de transferencia.

Dependencias de cadena

La transferencia de proyectos crea estas dependencias permanentes entre proyectos:

• No se pueden eliminar proyectos si existen proyectos dependientes aguas abajo.

• Las cadenas no se pueden romper sin eliminar proyectos aguas abajo.

• Renombrar proyectos no afecta las relaciones de cadena.

Un proyecto transferido tiene una dependencia del proyecto del cual fue transferido. No puedes eliminar un proyecto al inicio de una cadena de transferencia hasta que elimines todos los proyectos más abajo en la cadena. Para más información, consulta Eliminar un proyecto en Creación y configuración de proyectos.

Solo puedes romper una cadena de transferencia eliminando proyectos más abajo en la cadena o exportando e importando el proyecto. Para más información, consulta Exportaciones e importaciones de proyectos. Renombrar un proyecto transferido no rompe la cadena.

Mejores prácticas

Recomendamos estas mejores prácticas al diseñar una cadena de transferencia:

• Realiza cambios de diseño solo en el primer entorno de la cadena. En el ejemplo de flujo de transferencia típico, este es el entorno de desarrollo. En entornos posteriores, recomendamos que solo cambies los valores de las variables del proyecto. Realiza estos cambios dentro de la aplicación Integration Studio para que aparezcan en el historial del proyecto. Los cambios en los valores de las variables del proyecto realizados desde la página Proyectos de la Consola de Administración no aparecen en el historial del proyecto. Durante la transferencia del proyecto, puedes seleccionar si transferir todos los valores de las variables del proyecto o solo los valores de variables del proyecto seleccionados (descrito en la siguiente sección).

• Haz que el primer entorno de la cadena sea accesible para aquellos que puedan necesitar hacer cambios en el proyecto con el tiempo. Recomendamos no permitir que un solo desarrollador diseñe el proyecto en una organización personal. Si esto sucede, primero exporta el proyecto original y luego impórtalo en el entorno que iniciará la cadena. Realiza futuros cambios en el proyecto en el entorno que inicia la cadena.

Transferencia de proyectos

Se pueden transferir proyectos utilizando cualquiera de estas dos opciones:

1. Transferencia completa del proyecto: Transfiere todo el proyecto a un entorno. (Esta opción aparece como Migrar en la interfaz actual.)
2. Transferencia selectiva (Beta): Transfiere solo los componentes especificados a un entorno.

Transferir un proyecto completo

Cuando se transfiere un proyecto completo utilizando la opción Migrar, se transfieren todos los componentes del proyecto y los metadatos del proyecto.

La opción Migrar es accesible desde estas ubicaciones:

• La barra de herramientas del proyecto. Para más información, consulte el menú de acciones del proyecto en la barra de herramientas del proyecto.
• El lienzo de diseño. Para más información, consulte el menú de acciones de desplegar/migrar en el lienzo de diseño.

Cuando seleccionas Migrar, se abre una pantalla de configuración. Puedes elegir el entorno de destino y si deseas transferir los valores de las variables del proyecto:

• Organización y Proyecto: La organización de Harmony donde reside el proyecto y el nombre del proyecto que se va a transferir, separados por una coma.

• Entorno actual y Entorno de destino: Se enumeran el entorno actual donde reside el proyecto y el entorno de destino al que se transferirá el proyecto, junto con su tipo de grupo de agentes asociado (agente en la nube o agente privado).

  Cuando se transfiere el proyecto, el proyecto existente en el entorno actual permanece sin cambios. Si el proyecto ya ha sido transferido al entorno de destino, el proyecto del entorno de destino se sobrescribe utilizando las selecciones para los valores de las variables del proyecto a continuación.

  Precaución

  Si el proyecto de origen utiliza conectores que están disponibles solo en agentes privados, no puedes transferirlo a un entorno asociado con un grupo de agentes en la nube. Estos entornos aún aparecen en el menú desplegable de Entorno de destino, pero no se pueden seleccionar.

• Nombre de la etiqueta del historial del proyecto: Ingresa una etiqueta para etiquetar el evento de transferencia. La etiqueta aparece como una etiqueta en el evento de transferencia y se registra en los detalles de implementación accesibles desde el historial del proyecto. Se recomienda ingresar una etiqueta única, pero no es obligatorio.

• Puntos finales globales: Se enumeran los puntos finales globales utilizados por el proyecto que se está transfiriendo y que no existen en el entorno de destino. Cuando se transfiere el proyecto, el punto final global se agrega a ese entorno y necesita configuración después de la transferencia.

• Migrar todos los valores de las variables: Selecciona esta opción para transferir todos los valores de las variables del proyecto. Si el proyecto ya existe en el entorno de destino, los valores de todas las variables del proyecto se sobrescriben. La primera vez que se transfiere un proyecto, esta opción está seleccionada por defecto. Las transferencias posteriores se predeterminan a Seleccionar valores de variables para migrar.

• Seleccionar valores de variables para migrar: Seleccione esta opción para transferir todos los componentes del proyecto y los metadatos del proyecto, excepto los valores de las variables del proyecto listadas bajo Excluir. Si el proyecto ya existe en el entorno de destino, todos los componentes del proyecto, incluidos los valores de las variables del proyecto listadas bajo Incluir, se sobrescriben.

  Cuando se selecciona Seleccionar valores de variables para migrar, no se seleccionan variables del proyecto para la transferencia por defecto, a menos que el proyecto ya exista en el entorno de destino. Cuando el proyecto ya ha sido transferido, las variables del proyecto recién añadidas o renombradas se seleccionan para la transferencia por defecto, pero las variables cuyos valores han sido cambiados se excluyen.

  • Buscar: Ingrese cualquier parte del nombre de una variable del proyecto para filtrar la lista de variables del proyecto en el entorno actual.
  • Entorno actual: Seleccione las variables del proyecto cuyos valores desea transferir al entorno de destino. A medida que selecciona variables del proyecto, aparecen bajo Incluir. Los enlaces Seleccionar todo y Deseleccionar todo añaden o eliminan todas las selecciones de variables del proyecto a la vez.
  • Excluir: Variables del proyecto cuyos valores están excluidos de la transferencia. Si el proyecto ya existe en el entorno de destino y ya contiene la variable del proyecto, su valor existente en el entorno de destino se mantiene. Si la variable del proyecto no existe ya, entonces el componente de la variable del proyecto se transfiere pero no se le asigna ningún valor.
  • Incluir: Variables del proyecto cuyos valores están incluidos en la transferencia. Si el proyecto ya existe en el entorno de destino y ya contiene la variable del proyecto, su valor existente en el entorno de destino se sobrescribe.

• Migrar: Haga clic para transferir el proyecto al entorno seleccionado. Si el proyecto ya ha sido transferido al entorno de destino, un mensaje le pide que confirme que desea transferir. Esta transferencia sobrescribe el proyecto existente en el entorno de destino utilizando las selecciones para los valores de las variables del proyecto anteriores.

  Texto del diálogo

  Confirmar Migración
  Ya existe un proyecto con el mismo nombre en el entorno de destino. ¿Está seguro de que desea sobrescribirlo?

  Cuando haga clic en Continuar, si la transferencia al entorno de destino tiene éxito, el proyecto transferido se abrirá en el diseñador de proyectos.

Transferir componentes de un proyecto (Beta)

La transferencia selectiva le permite transferir solo los componentes especificados de un proyecto. Esta función le ayuda a evitar interferir con el trabajo que otros colaboradores están realizando en el mismo proyecto y entorno. Utilice la transferencia selectiva cuando desee promover sus cambios sin sobrescribir el trabajo de otros usuarios en el entorno de destino.

Para transferir solo los componentes especificados de un proyecto, utilice el menú de acciones del proyecto o el menú de acciones de la operación en un proyecto y haga clic en Transferencia Selectiva:

En la pantalla de configuración, selecciona el entorno de destino y los componentes a transferir:

Selección de componentes

Puede seleccionar componentes individuales según sus necesidades. Cuando selecciona componentes para transferir, el sistema incluye automáticamente las dependencias requeridas, excepto por los horarios. Debe seleccionar manualmente los horarios si desea transferirlos.

El sistema agrupa los componentes según su estado en los entornos de origen y destino:

• Crear: Componentes que existen en el proyecto de origen pero no en el proyecto de destino. Cuando se seleccionan, estos componentes se crean en el proyecto de destino.

• Sobrescribir: Componentes que existen en ambos proyectos pero tienen contenido diferente según la fecha de última modificación y la comparación de usuarios. Cuando se seleccionan, estos componentes se sobrescriben en el proyecto de destino.

• Eliminar: Componentes que existen en el proyecto de destino pero no en el proyecto de origen. Cuando se seleccionan, estos componentes se eliminan del proyecto de destino.

• Sin cambios: Componentes que existen en ambos proyectos y tienen el mismo contenido según la fecha de última modificación y la comparación de usuarios. Estos componentes no se pueden seleccionar.

Puedes seleccionar o deseleccionar componentes en las categorías Crear, Sobrescribir y Eliminar para configurar tu transferencia.

Opciones de configuración

• Entorno de destino: Elige el entorno donde deseas transferir los componentes seleccionados.

  Advertencia

  Si ya existe un proyecto no relacionado con el mismo nombre en el entorno de destino (no parte de la cadena de transferencia), la transferencia no puede continuar. Verás una pantalla vacía. En este caso, debes renombrar uno de los proyectos antes de intentar la transferencia.

• Nombre de etiqueta del historial del proyecto: Ingresa una etiqueta para etiquetar el evento de transferencia para su seguimiento en el historial del proyecto. En transferencias posteriores, los componentes se muestran con el nombre de la etiqueta del historial del proyecto. Esto te ayuda a identificar de qué versión proviene cada componente al decidir si sobrescribir durante futuras transferencias.

• Puntos finales globales: Los puntos finales globales que no están en el entorno de destino se agregan automáticamente durante la transferencia. Se utilizan las mismas configuraciones que en el entorno actual.

• Variables del proyecto y Incluir valores: Cuando seleccionas una variable del proyecto para incluir en la transferencia, puedes decidir qué valores de variables del proyecto incluir o excluir de la transferencia utilizando su casilla de verificación Incluir valor. Tus selecciones se guardan para transferencias posteriores al mismo entorno de destino.

• Mostrar: Mostrar datos ocultos para Última Modificación. Haga clic para mostrar esta información.

• Ocultar: Ocultar datos visibles para Última Modificación. Haga clic para ocultar esta información.

• Transferir: Iniciar el proceso de transferencia con los componentes y la configuración seleccionados. Cuando la transferencia esté completa, aparecerá un cuadro de diálogo de confirmación con una opción para abrir el proyecto en el entorno de destino.

• Cancelar: Cancelar la transferencia y regresar al proyecto.