✒️SAP BTPFIORI / El despliegue de la aplicación SAPUI5 en SAP Cloud Foundry Por Jose Baz Suarez

El despliegue de la aplicación SAPUI5 en SAP Cloud Foundry

---

1. Introducción

En esta lección aprenderás a subir (deploy) una aplicación SAPUI5 al entorno SAP Cloud Foundry (CF) utilizando SAP Business Application Studio (BAS).
El despliegue es el paso final del ciclo de desarrollo, en el cual la aplicación pasa de un entorno de desarrollo local a un entorno Cloud, donde podrá ser ejecutada, compartida y accedida por los usuarios desde cualquier dispositivo.

SAP Cloud Foundry forma parte de la SAP Business Technology Platform (BTP) y ofrece una infraestructura escalable para ejecutar aplicaciones Fiori de manera segura, modular y centralizada.

---

2. ¿Qué es SAP Cloud Foundry?

Cloud Foundry es un entorno PaaS (Platform as a Service) que permite ejecutar aplicaciones en la nube dentro de SAP BTP.
Cada aplicación desplegada se ejecuta dentro de un “space” y utiliza los recursos del subaccount donde se realiza el deploy.

📘 Conceptos clave:

• Org (Organization): representa una empresa o entorno principal.

• Space: entorno de trabajo dentro de la organización (por ejemplo: dev, test, prod).

• App: la aplicación desplegada (en este caso, nuestra app SAPUI5).

• Service Instance: componentes adicionales (destinos, bases de datos, launchpad, etc.).

---

3. Preparación del entorno

Antes del despliegue, es necesario contar con:

1. Cuenta activa en SAP BTP Trial.

2. Espacio de desarrollo en BAS configurado en el entorno Cloud Foundry.

3. CLI de Cloud Foundry (cf) integrada en BAS (ya incluida por defecto).

Verificación del entorno:
En la terminal de BAS se puede validar la conexión con el comando:

Luego, se ingresan:

• URL de la API

• Correo electrónico y contraseña

• Organización y espacio de trabajo

💡 Si todo está correcto, el sistema mostrará la confirmación:
API endpoint: https://api.cf.<region>.hana.ondemand.com

---

4. Estructura del proyecto para el deploy

Una aplicación SAPUI5 lista para desplegar en CF debe contener:

• manifest.json → descriptor principal de la aplicación.

• mta.yaml → archivo clave del despliegue que define los módulos y recursos.

• webapp/ → carpeta con los archivos fuente (vistas, controladores, i18n, modelos, etc.).

📘 El archivo mta.yaml indica qué partes del proyecto deben ser empaquetadas y cómo se deben desplegar dentro del entorno CF.

---

5. Creación del archivo mta.yaml

Ejemplo básico de un archivo mta.yaml:

💡 Explicación:

• ID: nombre único del proyecto.

• type: html5: indica que la app es una aplicación UI.

• path: ruta del código fuente.

• build-parameters: define las tareas necesarias para compilar el proyecto antes del deploy.

---

6. Compilación del proyecto (Build)

Antes del deploy, se debe construir el proyecto para empaquetar los archivos en formato ejecutable dentro de CF.

Desde BAS:

• Hacer clic derecho sobre mta.yaml → Build MTA Project.

• Se genera la carpeta mta_archives con un archivo .mtar (por ejemplo, miappui5_1.0.0.mtar).

📘 Este archivo .mtar es el paquete que se subirá a SAP Cloud Foundry.

---

7. Despliegue con el cliente CF

Una vez compilado, se realiza el deploy con el siguiente comando en la terminal:

Durante el proceso, CF crea los recursos necesarios y despliega la aplicación dentro del space seleccionado.

Si el despliegue es exitoso, se mostrará el mensaje:
Application "miappui5" started and available at <url>

💡 La URL que se muestra es el enlace público desde el cual se puede acceder a la aplicación SAPUI5.

---

8. Verificación del despliegue

Una vez finalizado el deploy, se puede verificar la aplicación desde BAS o directamente desde la consola CF con el comando:

Esto mostrará una lista de aplicaciones desplegadas con su estado, memoria y URL pública.

También se puede abrir el SAP BTP Cockpit, navegar hasta el space, y comprobar que la aplicación esté activa y en estado RUNNING.

---

9. Buenas prácticas

• Verificar que el mta.yaml esté correctamente configurado antes del build.

• Utilizar nombres claros y únicos para las aplicaciones (ID y module name).

• Evitar rutas relativas complejas dentro del proyecto.

• Realizar siempre el build antes del deploy.

• Mantener una estructura ordenada de carpetas (webapp, model, controller, view).

• Controlar los recursos del space (memoria y cuota asignada).

• Guardar la URL generada al finalizar el deploy para integrarla luego con el Launchpad Service.

---

10. Conclusión

El despliegue en SAP Cloud Foundry es un proceso fundamental para publicar las aplicaciones SAPUI5 en la nube, haciéndolas accesibles desde cualquier dispositivo mediante una URL pública y segura.

Gracias a las herramientas integradas en SAP Business Application Studio, el proceso se vuelve ágil, automatizado y compatible con las buenas prácticas de desarrollo Fiori.

El conocimiento de Cloud Foundry y el manejo del archivo mta.yaml son esenciales para cualquier consultor SAP Fiori que desee administrar aplicaciones dentro del ecosistema SAP BTP.

---

📘 Preguntas de repaso

1. ¿Qué archivo define los módulos y recursos que se desplegarán en SAP Cloud Foundry?
   → mta.yaml.

2. ¿Qué comando se utiliza para iniciar sesión en Cloud Foundry desde BAS?
   → cf login.

3. ¿Qué carpeta se genera luego de construir (build) el proyecto SAPUI5?
   → mta_archives.

4. ¿Qué comando se utiliza para desplegar el archivo empaquetado .mtar?
   → cf deploy <nombre>.mtar.

5. ¿Qué componente de SAP BTP permite ejecutar aplicaciones SAPUI5 en la nube?
   → Cloud Foundry.