jueves, 18 de febrero de 2021

Encapsulación microservicio Spring Boot en un servicio Linux

Vamos a desplegar un microservicio Spring Boot dentro de un servicio de Linux, para permitir su ejecución de manera independiente como un proceso. Para ello, partimos de que ya tenemos el código listo en su respectivo jar (en otra entrada explicaremos como hacer esta tarea apoyándonos en nuestro IDE con Maven):

1.) Accedemos a la máquina Linux con el usuario que tendrá permisos para lanzar el servicio.
 
2.) Subimos el fichero jar a nuestra máquina Linux, a un directorio donde tengamos permisos de escritura, por ejemplo en nuestro caso /var/microservice.
 
3.) Otorgamos permiso de ejecución al fichero jar:
    chmod 500 /var/microservice/app-microservice.jar 
 
4.) Creamos un script que creará el service para la máquina Linux:

        echo '[Unit]' >> /tmp/app-monitor.service
    echo 'Description=App monitoring Microservice' >> /tmp/app-monitor.service
    echo 'After=syslog.target' >> /tmp/app-monitor.service
    echo '' >> /tmp/app-monitor.service
    echo '[Service]' >> /tmp/app-monitor.service
    echo 'User=oracle' >> /tmp/app-monitor.service
    echo 'ExecStart=/usr/lib64/jvm/jre-1.8/jre1.8.0_281/bin/java -jar      /var/microservice/app-monitoring.jar' >> /tmp/app-monitor.service
    echo 'SuccessExitStatus=143' >> /tmp/app-monitor.service
    echo 'StandardOutput=syslog' >> /tmp/app-monitor.service
    echo 'StandardError=syslog' >> /tmp/app-monitor.service
    echo 'SyslogIdentifier=app-monitor' >> /tmp/app-monitor.service
    echo '' >> /tmp/app-monitor.service
    echo '[Install]' >> /tmp/app-monitor.service
    echo 'WantedBy=multi-user.target' >> /tmp/app-monitor.service
   
 
Viendo un poco el script en detalle, los puntos importantes son que creará un fichero service llamado app-monitor que dejará en la carpeta /tmp, y la línea de ejecucción del servicio usa la jre 1.8 ya que es la mínima necesaria para ejecutar Spring Boot y apunta a la ruta donde hemos dejado nuestro fichero jar. 
 
5.) Ejecutamos el script, que creará el fichero app-monitor.service en la carpeta /tmp.
 
6.) Copiamos el service a la ruta /etc/systemd/system, que es donde residen los servicios de nuestro servidor Linux.
 
7.) A partir de aquí manejaremos el servicio como otro cualquiera de Linux, apoyándonos en el comando systemctl.
     
    a) Habilitar el servicio => sudo systemctl enable app-monitor.service
    b) Arrancar/Parar el servicio => sudo systemctl start/stop app-monitor.service
    c) Estado/log => sudo systemctl -l status app-monitor.service