Ejemplo de implementación de una aplicación en contenedor

Este ejemplo muestra el proceso completo para implementar una aplicación en contenedor mediante versiones en un dispositivo JelinaOS y puede utilizarse como plantilla para la entrega de proyectos.

Escenario

Implementar un servicio web en un dispositivo de borde con administración mediante versiones, inicio automático, recuperación de fallos y persistencia de datos.

Paso 1: preparar el sistema

1. Instala JelinaOS siguiendo Instalar el sistema;
2. Completa la configuración básica según Primer arranque y configuración;
3. Conecta el dispositivo a JelinaCloud y completa su registro;
4. Comprueba que el entorno de ejecución de contenedores está disponible con docker version.

Paso 2: compilar y enviar la imagen

Compila la imagen de la aplicación en el entorno de desarrollo y envíala al registro de imágenes:

docker build -t registry.example.com/webapp:1.0.0 .
docker push registry.example.com/webapp:1.0.0

Paso 3: crear una versión

Crea una versión en JelinaCloud y añade la aplicación en contenedor, incluidos la imagen, política de reinicio, variables de entorno, puertos y volúmenes. Para obtener instrucciones detalladas, incluida la carga de paquetes, consulta Crear una Release en JelinaCloud.

Paso 4: implementar en el dispositivo

Implementa la versión en la flota de destino; el agente la aplica automáticamente. Comprueba el resultado en el dispositivo:

docker ps                # El contenedor está ejecutándose
curl http://localhost:8080   # El servicio es accesible
docker logs webapp       # Los registros son normales

Paso 5: comprobar la supervisión

• Recuperación automática: después de simular un fallo, el agente reinicia y recupera la aplicación;
• Inicio automático: después de reiniciar el dispositivo, la aplicación vuelve a ejecutarse automáticamente;
• Persistencia de datos: después de actualizar y recrear el contenedor, los datos de la partición de datos permanecen intactos.

Paso 6: publicar una nueva versión (opcional)

1. Compila y envía la imagen de la nueva versión;
2. Crea una nueva versión en la nube y actualiza la versión de la imagen;
3. Impleméntala en el dispositivo para que se actualice automáticamente;
4. Si aparecen problemas, selecciona de nuevo la versión anterior para revertir.

Resultado

Requisito	Cómo se cumple
Administración mediante versiones	La aplicación se define en una versión y el agente la implementa de forma centralizada
Inicio automático	La política de reinicio de la versión permite recuperar la aplicación al arrancar el sistema
Recuperación automática	El agente reinicia las aplicaciones que fallan
Persistencia de datos	Los datos se montan en la partición de datos
Actualización de versiones	Se implementa una nueva versión con posibilidad de reversión

Documentación relacionada

• Aplicaciones en contenedores — configuración
• Implementación de aplicaciones desde la nube y OTA — proceso de publicación y actualización
• Administración de aplicaciones — descripción del sistema de versiones