Creación y configuración de trabajos de creación de producción

Debe configurar algunos trabajos de empaquetado y despliegue para poder desplegar aplicaciones visuales en la instancia de producción de Visual Builder. En este tema, se explica cómo hacerlo.

Consejo:

Si lo prefiere, VB Studio puede crear y activar los trabajos de creación y el pipeline. En el editor de configuración de la aplicación visual, en Creación y publicación, seleccione la rama de producción y, a continuación, haga clic en Crear pipeline de integración y despliegue continuos. A continuación, puede modificar los trabajos de creación recién creados según sea necesario (consulte la guía a continuación para obtener más pasos de configuración). Por ejemplo, en el trabajo de despliegue, el destino de despliegue siempre es el entorno asociado al espacio de trabajo, por lo que tendrá que cambiar la instancia de destino por la instancia de producción.

Antes de configurar trabajos de creación de producción, anote lo siguiente:

  • En el trabajo de empaquetado de producción, utilice la rama de producción del repositorio de Git para generar artefactos de producción.
  • En el trabajo de empaquetado de desarrollo, si ha cambiado los nombres de archivo por defecto de los archivos de artefacto de archivo, obtenga los nuevos nombres y sus rutas. Los necesitará cuando configure el trabajo de empaquetado de producción.
  • Si ha configurado el trabajo de empaquetado de desarrollo para sobrescribir la versión de la aplicación definida en visual-application.json, obtenga la nueva versión. La necesitará cuando configure el trabajo de empaquetado de producción.
  • Al configurar trabajos de creación de despliegue, especifique si desea incluir la versión de la aplicación en su URL. Una aplicación visual sin la versión en su URL se denomina aplicación activa. Normalmente, despliega una aplicación activa en una instancia de producción.
  • Si despliega una versión de una aplicación visual que nunca se ha desplegado, VB Studio sobrescribe la última versión desplegada con la nueva versión.

    VB Studio no anula el despliegue de la versión desplegada anteriormente de la instancia de producción. Sigue estando en la instancia de destino, pero no se puede acceder a ella.

  • Si desea volver a desplegar una aplicación activa o una versión desplegada anteriormente, anule el despliegue primero; de lo contrario, la compilación de despliegue fallará. Para anular el despliegue de una versión de aplicación visual desplegada anteriormente, configure un trabajo de creación de anulación de despliegue y ejecútelo. No puede anular el despliegue manualmente desde la página Entornos.
  • Si está desplegando una aplicación en una URL personalizada, debe configurar el trabajo de despliegue para desplegarla en el entorno que aloja la URL personalizada. Solo puede desplegar la aplicación mediante la autenticación de autenticación básica, por lo que deberá confirmar que las credenciales necesarias para conectarse y desplegar en el entorno son correctas.
  • Si ha creado un perfil de aplicación para producción, obtenga su nombre. La necesitará cuando configure el trabajo de despliegue de producción.

Crear un trabajo de creación de empaquetado de producción

El trabajo de empaquetado de producción genera un artefacto de aplicación visual que está listo para desplegar.

  1. En el navegador de la izquierda, haga clic en Compilaciones Creaciones.
  2. En el separador Trabajos, haga clic en + Crear trabajo.
  3. En el cuadro de diálogo Nuevo trabajo, en Nombre, introduzca un nombre único.
  4. En Descripción, introduzca la descripción del trabajo.
  5. En Plantilla, seleccione la plantilla Valor por defecto del sistema OL7 para Visual Builder.
  6. Haga clic en Crear.
  7. Haga clic en Configurar Creaciones.
  8. Haga clic en el separador Git.
  9. En la lista Agregar Git, seleccione Git.
  10. En Repositorio, seleccione el repositorio de Git. En Rama o etiqueta, seleccione la rama de producción.
  11. Haga clic en el separador Pasos.
  12. En Agregar paso, seleccione Aplicación visual y, a continuación, seleccione Paquete.
  13. Por defecto, los trabajos de creación minimizan el código fuente de la aplicación antes de ejecutar la creación. Si no desea minimizar los archivos de origen, anule la selección de la casilla de control Optimizar aplicación.
    La minificación es un proceso para eliminar los caracteres innecesarios (como espacios en blanco, nuevas líneas y comentarios) del código fuente y reducir el tamaño de los archivos, haciendo que la transferencia de archivos consuma menos ancho de banda y almacenamiento.
  14. Si desea cambiar los nombres por defecto de los archivos de almacenamiento, en Nombres de archivo, seleccione Usar nombres de archivo personalizados.
    En Orígenes, especifique el nombre y la ruta del archivo de almacenamiento de origen de la aplicación visual. En Artefacto de compilación, especifique el nombre y la ruta del archivo de almacenamiento del artefacto de compilación.

    Necesitará ambos archivos de almacenamiento para desplegar la aplicación visual.

  15. Haga clic en el separador Después de la creación.
  16. En Agregar después de acción de creación, seleccione Archivador de artefactos.
  17. En Archivos para archivar, introduzca el nombre del artefacto de creación. También puede utilizar caracteres comodín. Por ejemplo, *.zip.
  18. Si desea desechar los artefactos antiguos de la compilación, haga clic en Configuración el icono de engranaje. En el separador General, seleccione la casilla de control Desechar compilaciones antiguas y especifique las opciones de desecho.
  19. Haga clic en Guardar.

Creación de un trabajo de creación de despliegue de producción

El trabajo de despliegue de producción despliega el artefacto de la aplicación visual que se generó en el trabajo de empaquetado de producción en la instancia de producción de Visual Builder. Antes de crear el trabajo, obtenga las credenciales de acceso de un usuario que pueda conectarse y desplegar en la instancia de producción de Visual Builder.

  1. En el navegador de la izquierda, haga clic en Compilaciones Creaciones.
  2. En el separador Trabajos, haga clic en + Crear trabajo.
  3. En el cuadro de diálogo Nuevo trabajo, en Nombre, introduzca un nombre único.
  4. En Descripción, introduzca la descripción del trabajo.
  5. En Plantilla, seleccione la plantilla Valor por defecto del sistema OL7 para Visual Builder.
  6. Haga clic en Crear.
  7. Haga clic en Configurar Creaciones.
  8. Haga clic en el separador Antes de crear.
  9. En Agregar antes de acción de creación, seleccione Copiar artefactos.
  10. En De trabajo, seleccione el trabajo de empaquetado de producción que ha generado el artefacto de la aplicación visual.
  11. En Qué compilación, seleccione Última compilación correcta.
  12. Deje los demás campos con sus valores por defecto o vacíos.
  13. Haga clic en el separador Pasos.
  14. En Agregar paso, seleccione Aplicación visual y, a continuación, seleccione Desplegar.
  15. En Instancia de destino, seleccione la instancia de producción de Visual Builder.
  16. En la sección Autorización, especifique el tipo de autorización para ejecutar este paso de creación. Con Usar OAuth seleccionado por defecto, verá el mensaje Authorization is required, que indica que este paso de compilación necesita una autorización única para manejar las solicitudes OAuth en la instancia de Visual Builder de su entorno. Haga clic en Autorizar e introduzca credenciales para acceder a la instancia de Visual Builder; también puede ejecutar el trabajo manualmente e introducir las credenciales cuando se le solicite.

    De cualquier manera, se recomienda autorizar la conexión OAuth durante la configuración inicial. Si omite este paso, no podrá publicar los cambios desde el diseñador y deberá completar la autorización necesaria antes de intentar desplegar los cambios.

    Una vez autorizado, se muestra el mensaje Authorization has been provided.

    Nota

    OAuth es el tipo de autorización recomendado. Utilice la autenticación básica solo si tiene problemas con la configuración de una conexión OAuth. Para utilizar la autenticación básica, seleccione Usar básico y, a continuación, introduzca las credenciales de un usuario que pueda acceder a la instancia de Visual Builder en Nombre de usuario y Contraseña.

    Los tokens OAuth (acceso y refrescamiento) se sincronizan durante el uso normal. Se utiliza un token de refrescamiento para obtener un token de acceso cada vez que un usuario accede a la instancia de destino. Este token de refrescamiento suele ser válido durante siete días. (El tiempo de caducidad del token se define en la aplicación de recursos de IDCS y puede ser diferente según los requisitos de seguridad). Si el usuario se autentica con la instancia de destino en el período de siete días, el token de refrescamiento activo genera un nuevo token de acceso y un nuevo token de refrescamiento. Este ciclo continúa indefinidamente mientras el token de refrescamiento siga siendo válido. Si el token de refrescamiento caduca durante períodos prolongados de inactividad (por ejemplo, cuando esté de vacaciones), haga clic en Renovar autorización (o ejecute el trabajo manualmente, por lo que se le pedirá que autorice cualquier token OAuth caducado).

  17. En el trabajo de empaquetado de producción, si ha cambiado los nombres de archivo por defecto de los archivos de artefacto de archivo, en Nombres de archivo, seleccione Usar nombres de archivo personalizados.
    En Orígenes y Crear artefacto, introduzca los mismos nombres de archivo (con ruta) especificados en el trabajo de empaquetado.

    Si no ha cambiado los nombres de archivo, utilice la opción predeterminada.

  18. (Opcional) Si ha configurado el trabajo de despliegue de desarrollo para sobrescribir la versión por defecto de la aplicación, especifique la misma versión en Versión de la aplicación. Déjelo vacío para utilizar la versión definida en el archivo visual-application.json de la aplicación.
    Si la versión ya está desplegada, anule el despliegue en primer lugar.
  19. Anule la selección de la casilla de control Incluir la versión de aplicación en la URL.
    Al realizar el despliegue en una instancia de producción, no incluya la versión de la aplicación en la URL de la aplicación desplegada.
  20. (Opcional) En Perfil de aplicación, especifique el perfil de aplicación de producción. Déjelo vacío para utilizar el perfil por defecto de la aplicación.

    La aplicación visual accede a los datos de diferentes servidores para servicios REST y puede que necesite una configuración de seguridad diferente para distintos entornos, como de desarrollo y producción. Con los perfiles de aplicación, puede definir diferentes combinaciones de servidores y valores de seguridad para cada uno de los entornos y utilizarlos al desplegar la aplicación en un entorno. Esto simplifica la gestión de la aplicación visual a medida que pasa del desarrollo a la producción. Para obtener más información, consulte Acerca de los perfiles de aplicación.

  21. Para utilizar una base de datos limpia para la aplicación, en Gestión de datos, seleccione Usar base de datos limpia.
  22. Haga clic en Guardar.

Configuración de la configuración de privacidad de un trabajo de producción

Marcar un trabajo como privado para restringir quién puede ver o editar la configuración de un trabajo o ejecutar su creación.

Un trabajo privado se debe ejecutar manualmente. No se ejecutará si un usuario no autorizado intenta ejecutar el trabajo directamente, mediante un disparador de SCM/periódico o un pipeline.
  1. En el navegador de la izquierda, haga clic en Administración de proyectos Administración de Proyectos.
  2. Haga clic en Compilaciones.
  3. Haga clic en el separador Protección de puesto.
  4. En la lista de trabajos, seleccione un trabajo de producción.
  5. Seleccione la opción Privado.
  6. En Usuarios autorizados, agréguese.
    A continuación, para agregar otros usuarios, selecciónelos individualmente o, en Grupos, seleccione un grupo (o grupos) de usuarios.
  7. Repita los pasos 4-6 para el trabajo de producción de despliegue.
  8. Haga clic en Guardar.

Un trabajo privado muestra un icono Bloquear Bloquear en la lista de trabajos de la parte derecha de la página Protección de trabajos, en el separador Trabajos de la página Compilaciones y en los pipelines.

Creación y configuración de un pipeline

Para garantizar que el trabajo de despliegue de producción se ejecute automáticamente después del trabajo de empaquetado de producción, cree un pipeline y defina la dependencia.

  1. En el navegador de la izquierda, haga clic en Compilaciones Creaciones.
  2. Haga clic en el separador Pipelines.
  3. Haga clic en + Crear pipeline.
  4. En el cuadro de diálogo Crear pipeline, en Nombre y Descripción, introduzca un nombre y una descripción únicos.
  5. Haga clic en Crear.
  6. En la página Configuración de pipeline, haga clic con el botón derecho en el nodo Iniciar y seleccione los trabajos Agregar nuevo inicio.
  7. Haga clic en el campo Seleccionar nuevos trabajos correctos, seleccione el trabajo de empaquetado y haga clic en Guardar.
  8. Haga clic con el botón derecho en el trabajo de empaquetado y seleccione Agregar y, a continuación, Agregar nuevos trabajos correctos.
  9. Haga clic en el campo Seleccionar nuevos trabajos correctos, seleccione el trabajo de despliegue y haga clic en Guardar.

    A continuación, se muestra un ejemplo del pipeline finalizado:

  10. Haga clic en Guardar.

Ejecutar el pipeline

Cuando esté listo para desplegar la aplicación visual en la instancia de producción, ejecute el pipeline de producción.

  1. En el navegador de la izquierda, haga clic en Compilaciones Creaciones.
  2. Haga clic en el separador Pipelines.
  3. En la fila del pipeline de desarrollo, haga clic en el menú Acciones Acciones y seleccione Ejecutar pipeline.

Después de una compilación correcta, encontrará el enlace de la aplicación desplegada en el separador Despliegues de la página Entornos.

Para ver el último log de compilación de un trabajo, abra la página Compilaciones, haga clic en el nombre del trabajo y, a continuación, haga clic en Log de compilación.