Creación y configuración de pipelines y trabajos de creación de despliegue

Para desplegar extensiones en otras instancias de Oracle Cloud Applications, puede utilizar la página Gestionar ciclo de vida de extensiones. Si prefiere utilizar un pipeline de integración y despliegue continuos para el despliegue, deberá configurar o crear un trabajo de empaquetado, uno o más trabajos de despliegue y un pipeline. Concretamente:

  • Un trabajo de empaquetado empaqueta la extensión y crea un artefacto de creación. En lugar de crear nuevos trabajos de empaquetado, puede utilizar el trabajo extensionName-Paquete que se creó con el proyecto. (Si ha creado este proyecto manualmente, el trabajo de paquete se denomina Application-Extension-Package). Este trabajo empaqueta la extensión y crea un artefacto de creación de la misma rama que los miembros del equipo han utilizado para desplegar en la instancia principal de Oracle Cloud Applications Development. Recuerde que este trabajo de empaquetado está configurado para disparar una compilación en cada confirmación de SCM.
  • Cree un trabajo de despliegue para cada instancia de Oracle Cloud Applications en la que desee desplegar. También necesitará las credenciales de un usuario que pueda desplegar en cada instancia de Oracle Cloud Applications. Para crear el trabajo, consulte Creación de un trabajo de creación de despliegue.
  • Después de crear trabajos de despliegue, cree pipelines para ejecutar el trabajo de paquete y los trabajos de despliegue en secuencia. Puede crear cualquiera de estos pipelines:
    • Pipeline para desplegar la extensión en la instancia principal y en otras instancias de Oracle Cloud Applications.

      En lugar de crear un nuevo pipeline, configure el pipeline extensionName-Paquete y despliegue existente para desplegarlo también en otras instancias. (Si ha creado este proyecto manualmente, el nombre de este pipeline es Application-Extension Package and Deploy). Consulte Configuración del pipeline por defecto para desplegar en otras instancias de Oracle Cloud Applications. Recuerde que el pipeline por defecto se ejecuta automáticamente cuando se transfiere un cambio de código a la rama main. Después de configurar el pipeline, despliega la extensión en todas las instancias de desarrollo y prueba de cada confirmación de SCM en la rama main.

      Después de crear este pipeline, tendrá un pipeline en el proyecto que se despliega en todas las instancias de DEV y TEST.

      A continuación, se muestra un ejemplo de cómo podría ser este pipeline:

    • Pipeline para desplegar la extensión en otras instancias de DEV y probar Oracle Cloud Applications manualmente. Consulte Creación y configuración de un pipeline para desplegar en otras instancias de Oracle Cloud Applications.

      Cree este pipeline si no desea desplegar la extensión en otras instancias en cada confirmación de SCM, pero solo después de que los miembros del equipo hayan validado la extensión en la instancia de desarrollo principal.

      Después de crear este pipeline, tendrá dos pipelines en el proyecto: 1) el pipeline principal, que se despliega en la instancia de desarrollo principal, y 2) este pipeline, que se despliega en otras instancias de DEV y TEST.

      A continuación, se muestra un ejemplo de cómo podrían ser estos pipelines:

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

El trabajo de despliegue despliega el artefacto de la extensión que se generó en el trabajo de empaquetado por defecto en la instancia de la aplicación de Oracle Cloud. Antes de crear el trabajo, asegúrese de que tiene credenciales que VB Studio puede utilizar para acceder a la instancia.

  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. Seleccione la casilla de control Copiar de existente.
  6. En la lista desplegable Copiar de, seleccione el trabajo de despliegue que desea copiar.
  7. En Plantilla, asegúrese de que la plantilla Valor por defecto del sistema OL7 para Visual Builder esté seleccionada.
  8. Haga clic en Crear.
  9. En la página Configuración de trabajo, haga clic en el separador Pasos.
    Se muestra la sección Despliegue de extensión de aplicación.
  10. En Instancia de destino, seleccione el entorno con la instancia de Oracle Cloud Applications de destino.
  11. 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 a la instancia de Oracle Cloud Applications de su entorno. Haga clic en Autorizar e introduzca credenciales para acceder a la instancia de Oracle Cloud Applications. 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 Oracle Cloud Applications en Nombre de usuario y Contraseña. Estas credenciales deben ser las de un usuario local, no una identidad federada, y no deben requerir autenticación multifactor.

    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).

  12. El campo Artefacto de creación debe mostrar el mismo nombre de artefacto que se ha utilizado en el paso de creación de empaquetado. Confirme este valor, especialmente si el trabajo de empaquetado ha utilizado un nombre de artefacto distinto del valor por defecto, extension.vx.
  13. Haga clic en Guardar.

Configuración del pipeline por defecto para desplegarlo en otras instancias de Oracle Cloud Applications

Si desea desplegar en otras instancias de DEV y TEST junto con la instancia principal de Oracle Cloud Applications, puede configurar el pipeline por defecto para desplegarlo también en otras instancias.

  1. En el navegador de la izquierda, haga clic en Compilaciones Creaciones.
  2. Haga clic en el separador Pipelines.
  3. En la fila de pipeline extensionName-- Paquete y despliegue, haga clic en el menú Acciones y seleccione Configurar pipeline. (Si ha creado el proyecto manualmente, el nombre del pipeline es Ampliación de aplicación - Paquete y despliegue).
  4. Haga clic con el botón derecho en el trabajo extensionName-Paquete y seleccione Agregar y, a continuación, Agregar nuevos trabajos correctos en.
  5. Haga clic en el campo Seleccionar nuevos trabajos correctos, seleccione los trabajos que desea agregar de la lista y haga clic en Guardar.
  6. Haga clic en Guardar.

Creación y configuración de un pipeline para desplegar en otras instancias de Oracle Cloud Applications

  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. Anule la selección de la casilla de control Iniciar automáticamente al crear trabajos de pipeline externamente.
  6. Haga clic en Crear.
  7. 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.
  8. Haga clic en el campo Seleccionar nuevos trabajos correctos, seleccione extensionName-Paquete y haga clic en Guardar.
  9. Haga clic con el botón derecho en el trabajo extensionName-Paquete y seleccione Agregar y, a continuación, Agregar nuevos trabajos correctos en.
  10. Haga clic en el campo Seleccionar nuevos trabajos correctos, seleccione los trabajos que desea agregar de la lista y haga clic en Guardar.
    A continuación, se muestra un ejemplo de un pipeline terminado:
  11. Haga clic en Guardar.

Desplegar cambios desde una rama diferente

En algún momento, es probable que desee crear una rama independiente para alojar su nuevo trabajo de desarrollo de funciones. Puede empaquetar esos cambios desde la nueva rama y desplegarlos en una instancia de Oracle Cloud Applications para realizar pruebas.

Para desplegar en la instancia de Oracle Cloud Applications en el entorno asociado a su espacio de trabajo, puede seleccionar la nueva rama cuando publique los cambios. O bien, si los cambios ya existen en la nueva rama, puede utilizar la opción Desplegar en el diseñador. Consulte Despliegue de cambios desde la rama remota en Ampliación de Oracle Cloud Applications con Visual Builder Studio.

Para desplegar en una instancia de Oracle Cloud Applications diferente, como TEST o PROD, necesitará configurar algunos trabajos de creación y un pipeline de integración y despliegue continuos.

Consejo:

VB Studio puede crear los trabajos de creación y el pipeline, si lo prefiere. En el editor de configuración de la extensión, en Creación y publicación, seleccione la nueva rama y, a continuación, cree y active un pipeline de integración y despliegue continuos para la rama. (Si está desplegando en una instancia diferente que no sea la asociada a su espacio de trabajo, deberá cambiar el entorno de destino en el trabajo de despliegue, una vez creado). Consulte Establecimiento de configuración de nivel de extensión en Ampliación de Oracle Cloud Applications con Visual Builder Studio.

Creación de un trabajo de empaquetado para la nueva sucursal

Cree un trabajo de empaquetado siguiendo los mismos pasos para crear un trabajo de creación de empaquetado de producción, pero al configurar el trabajo, seleccione la nueva rama en lugar de la rama main por defecto:

  1. En el navegador de la izquierda, haga clic en Compilaciones Creaciones.
  2. Cree un trabajo mediante la plantilla Valor por defecto del sistema OL7 para Visual Builder.
  3. Haga clic en Configurar Configurar.
  4. Haga clic en el separador Git.
  5. En la lista Agregar Git, seleccione Git.
  6. En Repositorio, seleccione el repositorio de Git. En Sucursal o etiqueta, seleccione la nueva rama.

Termine de configurar el trabajo de empaquetado como de costumbre. Consulte Creación del trabajo de creación de empaquetado de producción.

Creación de un trabajo de despliegue

Cree un trabajo de despliegue siguiendo los mismos pasos para crear un trabajo de creación de despliegue de producción, pero al configurar el trabajo, seleccione el trabajo de empaquetado que acaba de crear.

Creación y Configuración de un Pipeline para la Nueva Rama

Después de crear los trabajos de empaquetado y despliegue para la nueva rama, cree un pipeline para ejecutar el trabajo de empaquetado y los trabajos de despliegue en secuencia. Consulte Creación y configuración de un pipeline para desplegar en otras instancias de Oracle Cloud Applications.