Docker

¿Qué permite hacer?

Docker en ArduMaker tiene dos partes: el daemon, que es una capacidad del VPS, y las apps Docker, cada una un proyecto Compose propio que la plataforma escribe, levanta, observa y da de baja.

• Instalar el daemon con un clic (o dejar que lo instale la primera app que lo necesite).
• Desplegar una imagen pública, una imagen de un registro privado con token, o un repo de GitHub con Dockerfile.
• Desplegar un Compose avanzado (como objeto JSON) con varios servicios.
• Iniciar, detener y reiniciar el proyecto, y publicarlo con HTTPS si expone un puerto web.
• Desde la pestaña Docker del VPS: listar contenedores, ver sus logs, detenerlos, reiniciarlos o borrarlos, y ver imágenes, volúmenes y redes.

¿Cuándo conviene usarlo?

• Una aplicación ya empaquetada como imagen (un panel, una herramienta interna, un servicio de terceros).
• Varios servicios que se levantan juntos con Compose.
• Para código propio en GitHub con un proceso que no es Docker conviene el deploy desde GitHub.

¿Cómo funciona en ArduMaker?

El daemon

Los VPS nuevos nacen con los permisos de contenedor que Docker necesita, sin ser privilegiados. Un VPS viejo que no los tiene los recibe al instalar Docker y necesita un reinicio (el preflight avisa con requiere_reinicio_vps). El daemon se instala con el paquete docker.io y fuse-overlayfs, con userns-remap activado: los procesos de los contenedores no corren como el root real del VPS.

Una app Docker

1. Se valida la configuración y el preflight (función del sistema, Docker posible en el host, memoria y disco).
2. Si el daemon falta, se instala; si otra instalación está en curso, la operación espera y se reintenta.
3. Se escribe /opt/ardumaker-apps/app<id>/docker-compose.yml (con copia del anterior) y se valida con docker compose config; si no valida, se restaura el anterior.
4. Se corre docker compose -p app<id> up -d --remove-orphans como paso largo, así una descarga pesada no corta por tiempo.
5. Si hay port, se publica con HTTPS y se verifica el enlace.

Todos los contenedores llevan la etiqueta ardumaker.app_id y el proyecto se llama app<id>: el nombre no lo elige el usuario y la plataforma nunca toca nada fuera de él. Repetir el despliegue es idempotente: el mismo archivo y up -d no recrean lo que no cambió.

¿Qué cambia realmente?

Configuración de una app Docker

• image, compose y repo_id son excluyentes.
• port es el puerto del VPS (desde 1024 y nunca uno protegido); con port hace falta container_port. "auto" toma uno libre.
• Los puertos se publican solo en 127.0.0.1: un contenedor nunca queda abierto directo a internet.
• En env no se aceptan nombres de secreto (*_PASSWORD, *_TOKEN…): la configuración no guarda secretos.

Qué se rechaza en un Compose

Cada servicio admite una lista blanca de claves (image, command, entrypoint, environment, ports, volumes, restart, depends_on, healthcheck, working_dir, user, expose, networks, mem_limit, cpus, labels, tmpfs, stop_grace_period, read_only, init). Se rechaza con un código por ruta (compose.services.<servicio>.<clave>):

Tampoco se aceptan build, container_name, env_file, configs, secrets, extends ni name, ni etiquetas com.docker.* o ardumaker.*.

Desinstalar y datos

La baja corre docker compose down --remove-orphans, fuerza el borrado de los contenedores con la etiqueta del proyecto y borra el archivo Compose. Los volúmenes y la carpeta ./datos quedan, salvo que se pida borrar datos: entonces corre down -v y borra la carpeta del proyecto. Nada fuera de app<id> se toca.

Esquema

Resultado esperado

La app aparece en Apps con su estado observado: running si todos sus contenedores corren, stopped si todos están parados, degraded si hay mezcla y missing si no queda ninguno. Con port, la URL HTTPS aparece solo cuando el enlace respondió sin error 5xx.

docker compose -p app<id> ps
docker ps --filter label=com.docker.compose.project=app<id>

Errores y resolución

Relación con MCP

Las apps Docker se operan por MCP con las herramientas de Apps; la referencia está en /mcp/docs y /mcp/servicios.

• Lectura: ver_catalogo_apps, ver_preflight_app (valida la config exacta antes de instalar), listar_apps_empresa, ver_app, ver_operacion_app.
• Modifican: instalar_app con app_type: docker (exige idempotency_key), controlar_app (start, stop, restart), reintentar_operacion_app, refrescar_apps.
• Destructiva: desinstalar_app (solo admin, confirm=true; los volúmenes se borran solo con delete_data y confirm_delete_data).

Funciones relacionadas

• Servidores VPS
• n8n
• Deploy desde GitHub
• Nginx
• Certificados SSL