Cómo federar archivos mediante montajes de contenido

Los montajes de contenido permiten que una instancia de conocimiento lea el contenido de artículos de la ruta local de una segunda instancia sin copiar archivos. La instancia lectora renderiza el contenido montado como si fuera nativo, con los wikilinks resolviéndose dentro de su gráfico de origen. Esta guía cubre la declaración de un montaje secundario en knowledge.toml, la verificación de que el montaje está activo y el acceso a artículos desde la fuente federada.

Para la arquitectura de federación, consulta federation-via-content-mounts. Para el motor de conocimiento que procesa las declaraciones de montaje, consulta app-mediakit-knowledge.

[edit]Antes de empezar

Necesitas:

Dos instancias de app-mediakit-knowledge en ejecución en el mismo servidor o en servidores con un sistema de archivos compartido (NFS o equivalente)
Acceso de lectura desde el usuario del proceso de la instancia principal al directorio de contenido de la instancia secundaria
Acceso de escritura a knowledge.toml en la instancia principal

[edit]Paso 1: Confirma la ruta de contenido de la instancia secundaria

En el servidor que ejecuta la instancia secundaria, localiza su directorio de contenido. La ruta es el valor content_root en el knowledge.toml de la instancia secundaria:

grep content_root /ruta/al/secundario/knowledge.toml
# ejemplo de salida: content_root = "/srv/wiki/media-knowledge-projects"

Confirma que el usuario del proceso de la instancia principal puede leer la ruta:

sudo -u <usuario-del-proceso-wiki> ls /srv/wiki/media-knowledge-projects

Si la ruta está en un servidor remoto, móntala antes de continuar. El motor lee las fuentes de montaje al iniciar; una ruta ausente en ese momento hace que el montaje se omita con una advertencia en el registro.

[edit]Paso 2: Declara el montaje en `knowledge.toml`

Abre el knowledge.toml de la instancia principal y agrega una entrada [[mount]]:

[[mount]]
source = "/srv/wiki/media-knowledge-projects"
prefix = "projects"

source es la ruta absoluta al directorio de contenido secundario. prefix es una cadena de espacio de nombres opcional que evita colisiones de slugs cuando ambas instancias definen artículos con el mismo slug. Con prefix = "projects", un artículo con slug topic-co-location-methodology en el archivo secundario se resuelve como projects/topic-co-location-methodology en el primario.

Omite prefix solo cuando estés seguro de que ningún slug aparece en ambas instancias.

[edit]Paso 3: Reinicia el motor wiki

Aplica la configuración reiniciando el servicio:

sudo systemctl restart app-mediakit-knowledge

El motor lee knowledge.toml una vez al iniciar. Una entrada [[mount]] agregada después del inicio inicial no tiene efecto hasta que el servicio reinicie.

[edit]Paso 4: Verifica que el montaje está activo

Comprueba el registro de inicio para la línea de confirmación del montaje:

journalctl -u app-mediakit-knowledge --since "1 minuto atrás" | grep -i mount
# esperado: Mounted secondary archive at prefix=projects (N articles)

Si la salida muestra 0 articles, confirma que la ruta source es legible y contiene archivos .md a la profundidad esperada. Si la ruta está ausente, el registro muestra Mount source not found — skipping en lugar de un error al iniciar.

[edit]Paso 5: Accede a los artículos montados

Navega la instancia principal para confirmar que los artículos del archivo secundario están disponibles. Con prefix = "projects" y un artículo secundario con slug topic-co-location-methodology, la URL es:

https://<dominio-primario>/how-to/projects/topic-co-location-methodology

Los wikilinks dentro de los artículos montados se resuelven en el gráfico de enlaces del archivo secundario, no del primario. Un enlace [[topic-regional-markets-system]] dentro de un artículo montado se resuelve en el gráfico secundario — los enlaces entre gráficos se renderizan como enlaces rojos.

[edit]Véase también

federation-via-content-mounts — la arquitectura de federación declarativa y el modelo de montaje
app-mediakit-knowledge — el motor wiki que procesa las declaraciones de montaje de knowledge.toml
build-a-colocation-map — consume datos de inteligencia de ubicación expuestos a través de un montaje
self-host-a-deployment — provisiona la instancia que servirá el contenido federado