Hoy vamos a ver un post básico sobre cómo lanzar y desplegar una aplicación en un WSO2 Micro Integrator, MI. La idea es crear un ejemplo básico sobre el cual podremos construir ejemplos más complejos en un futuros posts.
El Micro Integrator es la evolución del Enterprise Integrator de WSO2. Es la solución que plantean para acercar el mundo de los Enterprise Service Bus hacía los microservicios. Permitiendo el despliegue de integraciones con contenedores en un tiempo mínimo, una huella de memoria baja y de forma ágil.
Para el ejemplo utilizaremos:
Lo primero será crear nuestra aplicación que para este ejemplo será un simple mock. Si no tienes mucha experiencia con WSO2 lo mejor es utilizar el
Integration Studio. El cual es un eclipse embebido pero con múltiples cualidades:
- Motor gráfico que te ayuda en la creación de integraciones.
- Templates para realizar determinadas acciones.
- Guías paso a paso para realizar la configuración de determinados componentes.
- Permite seleccionar los artefactos a desplegar de forma sencilla.
Mi opinión personal sobre el Integration Studio es que ha mejorado mucho con los años y que si no tienes experiencia te puede ayudar muchísimo. Pero si tienes experiencia y un buen arquetipo Maven, que puedes hacerte tú mismo, con un simple editor de texto puedes conseguir lo mismo de forma más rápida y ágil.
Es por eso que cuando pongamos código relativo a integraciones WSO2 lo haremos siempre mostrando el código XML y no los gráficos propios del Integration Studio.
Con el vamos a crear una simple API que tenga dos recursos que nos permitan devolver siempre el mismo resultado:
<?xml version="1.0" encoding="UTF-8"?>
<api context="/book" name="basicExample_v1_book_api" xmlns="http://ws.apache.org/ns/synapse">
<resource methods="GET">
<inSequence/>
<outSequence/>
<faultSequence/>
</resource>
<resource methods="GET" uri-template="/mock/">
<inSequence>
<log level="custom">
<property name="MSG" value="basicExample_v1_book_api - get - /mock/ - init"/>
</log>
<payloadFactory media-type="json">
<format>
[{
"id" : 1, "author":"Frank Herbert", "name":"Dune"
},{
"id" : 2, "author":"Alfred Bester", "name":"The starts my destination"
},{
"id" : 3, "author":"Frederik Pohl","name":"Gateway"
}]
</format>
<args/>
</payloadFactory>
<log level="custom">
<property name="MSG" value="basicExample_v1_book_api - get - /mock/ - end"/>
</log>
<respond/>
</inSequence>
<outSequence/>
<faultSequence/>
</resource>
<resource methods="GET" uri-template="/mock/{id}">
<inSequence>
<log level="custom">
<property name="MSG" value="basicExample_v1_book_api - get - /mock/{id} - init"/>
</log>
<payloadFactory media-type="json">
<format>
{ "id" : $1, "author":"Frank Herbert", "name":"Dune"}
</format>
<args>
<arg evaluator="xml" expression="$ctx:uri.var.id"/>
</args>
</payloadFactory>
<log level="custom">
<property name="MSG" value="basicExample_v1_book_api - get - /mock/{id} - end"/>
</log>
<respond/>
</inSequence>
<outSequence/>
<faultSequence/>
</resource>
</api>
Esta API, la incluiremos en un CAR que es el formato de paquete para las integraciones de WSO2.
A continuación veremos cómo desplegarlo en una imagen docker. Pero para poder bajarnos la imagen del MI, necesitaremos una cuenta de WSO2, gratuita, y logarnos en su docker hub.
docker login docker.wso2.com -u youraccount@example.com
Esta imagen la incluiremos en un docker-compose básico en el cual podremos incluirle otras dependencias en futuros posts.
version: '3.7'
networks:
wso2-net:
ipam:
driver: default
config:
- subnet: "172.16.238.0/24"
services:
wso2mi:
mem_limit: 1G
image: wso2/wso2mi:4.0.0
hostname: wso2mi
container_name: wso2mi
ports:
- 8290:8290
- 8253:8253
- 9164:9164
networks:
wso2-net:
ipv4_address: 172.16.238.10
environment:
JAVA_OPTS: "-DenableManagementApi=true -Duser.timezone=Europe/Madrid"
volumes:
- ./conf/deployment.toml:/home/wso2carbon/wso2mi-4.0.0/conf/deployment.toml
Un par de apuntes sobre este fichero:
- Con el parámetro enableManagementApi podemos habilitar la API de gestión.
- El fichero deployment.toml es el fichero de configuración del Micro Integrator. Nosotros para este caso no hemos hecho ningún cambio sobre el fichero de por defecto, pero es normal modificarlo y por eso lo hemos añadido en un volumen.
Ahora con este docker-compose veremos distintas formas de poder desplegar el CAR.
1. Configurar un volumen donde se encuentren el desplegable
Nos permite indicar en el momento del arranque las integraciones que queremos desplegar.
volumes:
- ./conf/deployment.toml:/home/wso2carbon/wso2mi-4.0.0/conf/deployment.toml
- ./apps/wso2-basic-example_1.0.0.car:/home/wso2carbon/wso2mi-4.0.0/repository/deployment/server/carbonapps/wso2-basic-example_1.0.0.car
2. Arrancar el MI y pasarle el desplegable
Similar al paso anterior, pero nos permite desplegar aplicaciones con el MI ya en marcha. Esto es especialmente util cuando estamos desarrollando.
docker cp wso2-basic-example_1.0.0.car wso2mi:/home/wso2carbon/wso2mi-4.0.0/repository/deployment/server/carbonapps/
3. Crear un Dockerfile con el CAR.
Esta opción será la ideal cuando tengamos nuestra integración estable y la querremos desplegar en entornos productivos.
Primero construimos el Dockerfile
FROM wso2/wso2mi:4.0.0
COPY wso2-basic-example_1.0.0.car /home/wso2carbon/wso2mi-4.0.0/repository/deployment/server/carbonapps/
Luego construimos la imagen
docker build -t deesebc/book-api-mi .
Y por último arrancamos un contenedor
docker run -it -p 8290:8290 -p 8253:8253 -p 9164:9164 --name micro-integrator deesebc/book-api-mi
4. API Management
A pesar de estar indicado en la documentación como una posibilidad, a 03/2022 es solo posible como actualización de pago del MI.
Una vez que lo hemos arrancado ya podremos consultar nuestra API
curl --location --request GET 'http://localhost:8290/book/mock'
curl --location --request GET 'https://localhost:8253/book/mock'
El otro puerto habilitado, 9164, será el que nos da acceso a través de HTTPS a la API de gestión.
Espero que haya sido de utilidad, y como siempre si queréis el código completo podéis verlo aquí.
