Cómo desplegar una instancia de conocimiento

Una instancia de conocimiento es un despliegue en ejecución de app-mediakit-knowledge — el servidor wiki que renderiza la documentación y los wikis de proyectos de la plataforma. Desplegar una instancia significa compilar el binario, escribir un archivo de configuración knowledge.toml que apunte a los repositorios de contenido e iniciar el servicio. Esta guía cubre el despliegue de un wiki de instancia única desde una ruta de contenido local.

Para el modelo de tres instancias (documentación, proyectos, corporativo), véase app-mediakit-knowledge. Para los montajes de contenido declarativos, véase use-knowledge-mounts.

[edit]Requisitos previos

• El binario app-mediakit-knowledge compilado desde el monorepo (véase install-toolchain)
• Uno o más clones del repositorio de contenido media-knowledge-* en el host de despliegue
• Un puerto de despliegue (p.ej., 9090) que no esté ocupado por otro servicio
• Una sesión de terminal en el host

[edit]Paso 1: Localizar el repositorio de contenido

El servidor wiki lee Markdown desde una ruta local. Identifique la ruta al repositorio de contenido que desea servir:

ls ~/Foundry/clones/project-editorial/media-knowledge-documentation/

El repositorio debe contener un index.md en la raíz y subdirectorios de categorías con páginas de aterrizaje _index.md. Si el contenido aún no ha sido clonado, clónelo primero:

git clone git@github.com:pointsav/media-knowledge-documentation.git

[edit]Paso 2: Escribir el archivo de configuración

Cree knowledge.toml en el directorio de despliegue:

[server]
port = 9090
bind = "0.0.0.0"

[content]
primary_path = "/ruta/a/media-knowledge-documentation"
instance_name = "documentation"

[search]
enabled = true
index_path = "/var/lib/knowledge/search-index"

[auth]
enabled = false   # establezca true + configure MBA si se necesita la UI del editor

primary_path debe ser una ruta absoluta a un clon media-knowledge-*. instance_name aparece en el encabezado renderizado y en los mensajes de registro — use un valor corto y descriptivo.

[edit]Paso 3: Compilar o localizar el binario

Si aún no ha compilado el binario, compílelo desde el monorepo:

cd ~/Foundry/clones/<su-archivo>/pointsav-monorepo
cargo build -p app-mediakit-knowledge --release

El binario aparece en target/release/app-mediakit-knowledge. Cópielo al host de despliegue si son máquinas diferentes.

[edit]Paso 4: Iniciar la instancia

Ejecute el binario con el archivo de configuración:

app-mediakit-knowledge --config knowledge.toml

O inícielo como un servicio systemd usando la plantilla de archivo de unidad proporcionada (si está disponible en el despliegue). El servicio registra mensajes de inicio: lee la ruta de contenido, construye el índice de búsqueda y comienza a escuchar en el puerto configurado.

[edit]Paso 5: Verificar que la instancia está sirviendo

Obtenga la página de inicio del wiki:

curl -s http://127.0.0.1:9090/ | head -20

La respuesta debe contener HTML para la página de inicio del wiki renderizada desde index.md. Obtenga una página de categoría para confirmar el enrutamiento de artículos:

curl -s http://127.0.0.1:9090/architecture/ | grep '<title>'

Si alguna página devuelve un 404, verifique que primary_path en knowledge.toml apunte a un directorio que contenga la carpeta de categoría esperada.

[edit]Puntos clave

• El servidor wiki lee el contenido directamente desde la ruta de archivo local — los cambios en el repositorio de contenido aparecen inmediatamente sin reiniciar el servicio
• instance_name en la configuración es la etiqueta usada en los registros y el encabezado renderizado
• El índice de búsqueda se construye al inicio y vive en index_path — cambiar esta ruta requiere limpiar el directorio del índice antiguo
• Tres instancias separadas con tres rutas de contenido sirven los wikis de documentación, proyectos y corporativo de forma independiente

[edit]Véase también

• app-mediakit-knowledge — la arquitectura del servidor wiki y el modelo de tres instancias
• use-knowledge-mounts — montar contenido de múltiples repositorios en una instancia
• install-toolchain — compilar el binario desde el código fuente del monorepo
• self-host-a-deployment — el procedimiento de despliegue más amplio del que este es un componente
• federate-archives-via-content-mounts — cómo servir contenido de múltiples archivos en una instancia