Servidores

3 min de lectura

Un servidor es la máquina de tu infraestructura donde se ejecutan los agentes asignados. Puede ser un VPS, un servidor propio o una máquina de tu red. Tú mantienes el control de esa infraestructura; Kujira conecta en ella el supervisor que inicia y vigila los contenedores de tus agentes.

Conectar un servidor

Desde Organización → Servidores, registra la máquina y ejecuta en ella el comando de instalación que genera el panel. El token de aprovisionamiento se muestra una sola vez y vincula ese supervisor con tu organización.

Cuando el supervisor se conecta, el panel actualiza automáticamente su estado, la dirección detectada y sus especificaciones. A partir de ese momento puedes asignar agentes a ese servidor.

Protege el token de aprovisionamiento

Trátalo como una credencial temporal: no lo compartas en chats, repositorios o capturas. Si no has podido usarlo o necesitas reinstalar la máquina, genera uno nuevo; el anterior queda invalidado.

Qué puedes supervisar

Disponibilidad

Consulta si el supervisor está conectado, pendiente de aprovisionamiento o sin conexión, así como la última vez que informó al panel.

Recursos

Revisa CPU, memoria RAM y carga media reportadas por la máquina para detectar presión de recursos o dimensionar mejor la infraestructura.

Agentes asignados

Ve cuántos agentes dependen de cada servidor y accede a su configuración desde la misma vista.

La capacidad estimada no es la carga instantánea: calcula el escenario en el que todos los agentes asignados trabajan a la vez. Si supera el 100 %, la máquina puede quedarse sin margen durante los picos, aunque en ese momento la carga observada sea baja.

Límites y alertas de recursos

Puedes definir límites predeterminados de CPU y memoria para los contenedores de los agentes de un servidor. Son un punto de partida para proteger la máquina; un agente puede tener límites específicos si su carga lo requiere.

Activa las alertas de recursos para recibir avisos cuando la carga, la memoria o el almacenamiento requieran atención. Antes de concentrar más agentes en un servidor, comprueba tanto su carga actual como la capacidad estimada.

Operaciones de mantenimiento

Operación	Cuándo usarla
Actualizar supervisor	Cuando el panel indique una versión disponible. La actualización se inicia desde Kujira, sin abrir una sesión SSH manual.
Regenerar instalación	Si vas a reinstalar o sustituir la máquina. Genera un token nuevo e invalida el anterior.
Eliminar servidor	Cuando ya no tenga agentes asignados y no vayas a volver a conectarlo.

Antes de retirar una máquina, reasigna o detén los agentes que dependen de ella. Kujira no permite eliminar un servidor que todavía tenga agentes vinculados.

Actualizar el supervisor

Si una función nueva te dice que el supervisor de un servidor es anterior a ella, actualízalo desde una terminal en esa máquina:

sudo kujira update

Descarga la última versión y vuelve a crear el contenedor del supervisor con la misma configuración. Tus agentes siguen funcionando mientras tanto: son contenedores aparte. Cuando termine, sudo kujira status confirma que ha vuelto a conectarse.

Si la máquina dice que update no existe, su copia del comando es anterior a junio de 2026. Descarga la actual y repite:

sudo curl -fsSL https://api.kujira.so/kujira -o /usr/local/bin/kujira && sudo chmod +x /usr/local/bin/kujira

Cuándo usar varios servidores

Un único servidor es suficiente para empezar. Añade más cuando necesites separar entornos, clientes o redes, reservar recursos para agentes exigentes o reducir el impacto de una incidencia en una sola máquina.

Cada agente se ejecuta en el servidor que tiene asignado. Repartirlos te da control sobre dónde viven sus contenedores, credenciales y conexiones locales. El número de servidores disponibles acompaña al número de agentes contratados; consulta Planes y límites para conocer el marco de tu organización.

Permisos

Acción	Permiso
Consultar servidores y su estado	server.view
Registrar un servidor	server.create
Editar límites, alertas o instalación	server.edit
Eliminar un servidor sin agentes	server.delete