06 Solución - Despliegue en Cloud Foundry

Desarrollo SAPUI5 en SAP BTP con SAP Business Application Studio
Despliegue en Cloud Foundry
Solución
Desarrollo SAPUI5 en SAP BTP con

SAP Business Application Studio
1
Contenido
1. YAML - File ............................................................................................................................ 3
2. MTA - Build ........................................................................................................................... 8
3. Archivo MTA - Deploy......................................................................................................... 14
4. App SAPUI5 – Ejecución en BAS ......................................................................................... 17
5. App SAPUI5 – Ejecución de Cloud ...................................................................................... 21
6. Cloud Foundry – Log de ejecución ..................................................................................... 22
2
1. YAML - File
En el proyecto llamado "demoApp" que hemos creado anteriormente

observamos que se han creado dos carpetas, una de ellas contiene el
módulo de la aplicación "appHTML" y la otra es el enrutador de aplicaciones
SAP "demoapp-approuter".
El enrutador de aplicaciones SAP (approuter) es la biblioteca Nodejs que

está disponible en NPM público. Representa un único punto de entrada a la
aplicación. Con esta arquitectura tenemos múltiples módulos de aplicación
y un solo punto de acceso a ellos (approuter).
En la raíz del proyecto contamos con un fichero "yaml" llamado "mta.yaml"

que es un archivo de descripción de la aplicación.
Los archivos "yaml" pueden ser nombrados con extensión "yaml" o "yml",
este archivo es importante ya que a partir de este archivo descriptor se
construye y posteriormente despliega la aplicación.
3
Los archivos "yaml" se jerarquizan por medio de espacios, como un árbol

de carpetas.
Al inicio del archivo encontramos las versiones y el ID que es igual al nombre

de la carpeta del proyecto.
4
Después de la versión tenemos dos secciones principales del archivo

descriptor, los módulos y recursos.
5
En la sección de los módulos encontramos al enrutador de aplicaciones.
Los módulos tienen la instrucción "requires", lo que quiere decir que

necesita de algún recurso que pueda encontrarse en la sección "resources".
6
Como tercer módulo se encuentra el directorio de la aplicación.
En la última parte de los recursos, tenemos un parámetro de construcción

que ejecuta el comando "npm install" antes de realizar la construcción de
la aplicación.
7
2. MTA - Build
Antes de realizar la construcción de la aplicación nos aseguramos de que en

el archivo "index.html" se encuentre el recurso "sap-ui-core.js" apuntando
a la ruta "https://sapui5.hana.ondemand.com/resources/sap-ui-core.js".
Continuamos con la configuración de construcción de la aplicación en el

archivo descriptor "MTA", en el apartado de los módulos agregamos la ruta
que va a alojar el resultado de la compilación.
8
build-parameters:
build-result: resources
Informamos la creación de la instancia destino en el apartado de módulos

y en el de recursos.
requires:
- name: demoapp_html_repo_runtime
- name: demoapp_dest
- name: demoapp_dest
type: org.cloudfoundry.managed-service
parameters:
service: destination
service-plan: lite
9
En la paleta de comandos seleccionamos “Build MTA” para generar el

archivo “.mtar”.
Se genera el paquete con el archivo “.mtar” que posteriormente

desplegaremos.
Si cambiamos la versión del archivo multi-target “mta.yaml” al momento de

realizar una nueva construcción de la aplicación se van generando los
archivos “.mtar” de acuerdo a la versión asignada en el archivo “mta.yaml”
dentro la carpeta “mta_archives”. Con estos archivos tenemos la
posibilidad de desplegar la aplicación según la versión que nos interese.
10
Antes de construir la segunda versión de la aplicación, informamos el

módulo de entrada para nuestro proyecto, para esto nos dirigimos al
archivo "manifest.json" que se encuentra dentro del módulo "apphtml".
Copiamos el "id" del módulo que está conformado por

"<namespace>.<module>".
11
Informamos la propiedad "welcomeFile" (debemos quitar el punto que

divide el "namespace" del nombre del módulo) en el archivo "xs-app.json"
que se encuentra dentro del enrutador de aplicaciones.
Construimos la segunda versión de la aplicación, otra forma de crear el

archivo ".mtar" es con clic derecho sobre el archivo "mta.yaml" y en el
menú contextual seleccionar "Build MTA".
12
En la carpeta "mta_archives" se van almacenando todas las versiones que

hemos construido de la aplicación.
Observamos que con la construcción de la aplicación también se creó la

carpeta "resources" que contiene el artefacto "appHTML-content.zip".
13
3. Archivo MTA - Deploy
En la paleta de comandos seleccionamos la opción de “Deploy MTA

archive”.
Si nuestra aplicación cuenta con dos o más versiones de archivos “.mtar” la

paleta de comandos nos pide seleccionar la versión que deseamos
desplegar, en este caso seleccionamos la versión “0.0.1.mtar”.
La terminal de comandos nos informa de un error por falta de autenticación

en Cloud Foundry y nos muestra el comando de CF para realizar el Deploy
de la aplicación.
14
Realizamos la autentificación en Cloud Foundry pulsando clic sobre la parte

inferior izquierda “Targeting Cloud Foundry” e informamos los datos que
nos solicita la paleta de comandos.
15
En la terminal podemos ver la finalización del proceso, tomamos la URL que

nos muestra para visualizar la aplicación desplegada.
Observamos que el enrutador nos lleva a la ruta que especificamos en la

propiedad "welcomeFile".
16
Podemos observar la aplicación desplegada dentro del entorno de Cloud

Foundry junto a los servicios generados.
4. App SAPUI5 – Ejecución en BAS
Dentro del Workspace del proyecto creado anteriormente nos dirigimos a

la opción de “Run Configurations” y seleccionamos la opción de “Create
Configuration” que abre la paleta de comandos donde informamos las
opciones del asistente como se muestra a continuación.
17
Al finalizar, nos muestra la creación del “Run Configuration” y lo

ejecutamos.
18
Nos dirige a la opción de “Debug” y en la parte inferior derecha nos muestra

un mensaje que nos informa el puerto donde está expuesta nuestra
aplicación, seleccionamos el botón de “Open in New Tab” y observamos
nuestra aplicación en ejecución.
Con la crea creación de una configuración de ejecución se crea un archivo

".env" que contiene los datos del destino que consume la aplicación.
19
Podemos observar el archivo "/.vscode/launch.js" con clic derecho sobre la

configuración de ejecución y en el menú contextual seleccionamos la
opción de "show in file".
En el archivo de ejecución "/.vscode/launch.json" observamos que cuando

se corre la aplicación se hace un llamado al módulo del "Repo Mock" que
se encuentra en el módulo de enrutamiento de la aplicación "Approuter",
se especifica la entrada de la aplicación "index.html" y la ubicación del
archivo donde está configurado el destino ".env1".
Para detener la aplicación seleccionamos el botón stop dentro de la opción

“Debug”.
20
5. App SAPUI5 – Ejecución de Cloud
Cuando realizamos el despliegue de una aplicación con el comando

“Deploy MTA Archive”, esta se muestra en el entorno de Cloud Foundry,
así que la seleccionamos.
Si navegamos dentro de la aplicación desplegada encontramos el

“Application Routes” que es el enlace para mostrar la aplicación.
21
6. Cloud Foundry – Log de ejecución
Cuando construimos o desplegamos una aplicación, se generan archivos log

de ejecución y la terminal nos ofrece la posibilidad de traer estos archivos
hacia nuestra aplicación con el comando “cf dmol -i <nombre de la carpeta
del log>”.
Desde una terminal ejecutamos la instrucción propuesta en el proceso

MTA.
22
Podemos seleccionar el archivo para consultarlo directamente en SAP

Business Application Studio o podemos darle clic derecho “Download” para
descargalo a nuestro equipo.
El enrutador de aplicaciones también cuenta con "logs" que se pueden

revisar directamente en Cloud Foundry.
23

06 Solución - Despliegue en Cloud Foundry

Cargado por

Copyright:

Formatos disponibles

06 Solución - Despliegue en Cloud Foundry

Cargado por

Información del documento

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

06 Solución - Despliegue en Cloud Foundry

Cargado por

Copyright:

Formatos disponibles

Desarrollo SAPUI5 en SAP BTP con SAP Business Application Studio

Despliegue en Cloud Foundry

Desarrollo SAPUI5 en SAP BTP con

En el proyecto llamado "demoApp" que hemos creado anteriormente

El enrutador de aplicaciones SAP (approuter) es la biblioteca Nodejs que

En la raíz del proyecto contamos con un fichero "yaml" llamado "mta.yaml"

Los archivos "yaml" se jerarquizan por medio de espacios, como un árbol

Al inicio del archivo encontramos las versiones y el ID que es igual al nombre

Después de la versión tenemos dos secciones principales del archivo

En la sección de los módulos encontramos al enrutador de aplicaciones.

Los módulos tienen la instrucción "requires", lo que quiere decir que

Como tercer módulo se encuentra el directorio de la aplicación.

En la última parte de los recursos, tenemos un parámetro de construcción

Antes de realizar la construcción de la aplicación nos aseguramos de que en

Continuamos con la configuración de construcción de la aplicación en el

Informamos la creación de la instancia destino en el apartado de módulos

En la paleta de comandos seleccionamos “Build MTA” para generar el

Se genera el paquete con el archivo “.mtar” que posteriormente

Si cambiamos la versión del archivo multi-target “mta.yaml” al momento de

Antes de construir la segunda versión de la aplicación, informamos el

Copiamos el "id" del módulo que está conformado por

Informamos la propiedad "welcomeFile" (debemos quitar el punto que

Construimos la segunda versión de la aplicación, otra forma de crear el

En la carpeta "mta_archives" se van almacenando todas las versiones que

Observamos que con la construcción de la aplicación también se creó la

3. Archivo MTA - Deploy

En la paleta de comandos seleccionamos la opción de “Deploy MTA

Si nuestra aplicación cuenta con dos o más versiones de archivos “.mtar” la

La terminal de comandos nos informa de un error por falta de autenticación

Realizamos la autentificación en Cloud Foundry pulsando clic sobre la parte

En la terminal podemos ver la finalización del proceso, tomamos la URL que

Observamos que el enrutador nos lleva a la ruta que especificamos en la

Podemos observar la aplicación desplegada dentro del entorno de Cloud

4. App SAPUI5 – Ejecución en BAS

Dentro del Workspace del proyecto creado anteriormente nos dirigimos a

Al finalizar, nos muestra la creación del “Run Configuration” y lo

Nos dirige a la opción de “Debug” y en la parte inferior derecha nos muestra

Con la crea creación de una configuración de ejecución se crea un archivo

Podemos observar el archivo "/.vscode/launch.js" con clic derecho sobre la

En el archivo de ejecución "/.vscode/launch.json" observamos que cuando

Para detener la aplicación seleccionamos el botón stop dentro de la opción

5. App SAPUI5 – Ejecución de Cloud

Cuando realizamos el despliegue de una aplicación con el comando

Si navegamos dentro de la aplicación desplegada encontramos el

6. Cloud Foundry – Log de ejecución

Cuando construimos o desplegamos una aplicación, se generan archivos log

Desde una terminal ejecutamos la instrucción propuesta en el proceso

Podemos seleccionar el archivo para consultarlo directamente en SAP

El enrutador de aplicaciones también cuenta con "logs" que se pueden

También podría gustarte