resources/views/pages/frontend/docs/arquitectura-lxc.md
Última modificación: 27 Oct, 2026

Arquitectura en Linux Containers / Incus (Ubuntu 26.04)

El despliegue de Mañuti mediante Incus (la evolución moderna de LXC/LXD) permite aprovisionar entornos Ubuntu 26.04 completos con aislamiento total y acceso directo a la red física (macvlan) en cuestión de segundos.

Gracias al uso de un dispositivo de red tipo macvlan vinculado a la tarjeta física del host (parent=eno1), la instancia obtiene su propia dirección IP dentro del segmento LAN local, comportándose exactamente igual que un servidor físico independiente.


1. Creación y Aprovisionamiento de la Instancia con Incus

Ejecuta los siguientes comandos desde tu servidor anfitrión (Host):

# 1. Crear la instancia Ubuntu 26.04 llamada 'manuti'
incus create images:ubuntu/26.04 manuti --vm

# 2. Asignar tarjeta de red macvlan conectada a la interfaz física (eno1)
#    Esto permite que la instancia obtenga su propia IP directamente en tu LAN
incus config device add manuti eth0 nic nictype=macvlan parent=eno1

# 3. Iniciar la instancia (si no ha iniciado) e instalar el servidor OpenSSH
incus start manuti
incus exec manuti -- apt update && incus exec manuti -- apt install -y openssh-server

# 4. Habilitar y arrancar el demonio SSH inmediatamente
incus exec manuti -- systemctl enable --now ssh

2. Configuración de Acceso SSH Interno

Ingresa a la consola de la instancia recién creada para configurar las credenciales de acceso y habilitar la administración remota:

# 1. Entrar al shell de la instancia
incus shell manuti

# 2. Definir la contraseña del usuario root (o crear tu usuario de despliegue)
sudo passwd root

# 3. Configurar permisos de acceso en el demonio SSH
sudo nano /etc/ssh/sshd_config

Dentro de /etc/ssh/sshd_config, verifica o descomenta la directiva según tus políticas de laboratorio o aprovisionamiento:

#PermitRootLogin yes

Reinicia el servicio SSH para aplicar los cambios:

sudo systemctl restart ssh

3. Elección de Topología: ¿Monolítico o Bare Metal Distribuido?

Una vez que tu instancia (o conjunto de instancias) en Incus responde por SSH en tu red local, el sistema operativo interno es 100% idéntico a un servidor dedicado. A partir de este punto, continúa con cualquiera de nuestras dos guías maestras según el objetivo de tu despliegue:

Opción A: Despliegue en una Sola Instancia (Monolítico)

Si creaste una única instancia manuti para alojar todos los motores (Nginx, PHP 8.5, MariaDB, MongoDB, Redis, MinIO, Horizon y Reverb):

Opción B: Despliegue en Múltiples Instancias (Clúster Distribuido)

Si creaste múltiples instancias con Incus (ej. manuti-lb, manuti-web01, manuti-web02, manuti-worker, manuti-reverb, manuti-sql, manuti-mongo, manuti-redis):

Edita este documento en >> arquitectura-lxc.md
← Volver a la Landing Page