Configuración y ajustes

Configuración

Configuración

Configuración es el área reservada a administradores para ajustar esta instancia de lazyit. Se accede desde la navegación principal y está limitada al rol Administrador: los Miembros y los Lectores no la ven. Todo lo que un operador configura sobre la instancia vive aquí o se enlaza desde aquí.

Cómo moverte

Cada página de Configuración lleva un menú lateral (en un teléfono o una ventana angosta se convierte en un selector de página arriba), agrupado según lo que estés haciendo. Resumen, arriba de todo, vuelve al inicio de Configuración, que muestra las mismas páginas como tarjetas y en los mismos grupos.

Inventario

  • Taxonomías — gestiona las categorías que clasifican activos, aplicaciones, consumibles y artículos de la base de conocimiento, además de los modelos de activo que los activos referencian. Consulta Taxonomías.
  • Ubicaciones — el registro de los lugares donde físicamente residen tus activos (oficinas, centros de datos, racks, almacenamiento). Es un registro de poco tráfico, por eso se llega desde Configuración y no desde la navegación principal; abre la página completa de Ubicaciones.
  • Etiquetas de activos — el esquema de etiquetas de activos y la herramienta que etiqueta los activos existentes. Consulta Esquema de etiquetas de activos.
  • Importaciones — la importación masiva guiada (solo la ve quien puede ejecutar importaciones). Consulta Importación masiva.

Acceso

  • Roles y permisos — una sola matriz de lo que puede hacer cada rol, con cuántas personas tienen cada uno. Consulta Configuración de permisos. El rol de una persona se cambia desde la sección Usuarios.
  • Cuentas de servicio — crea y gestiona credenciales de API no humanas para CI, scripts e integraciones, acotadas por permiso y revocables.

Integraciones

  • Correo — el correo saliente a través de tu relay SMTP. Consulta Correo y SMTP.
  • Directorio AD/LDAP — importación de solo lectura de personas desde Active Directory o LDAP. Consulta Sincronización de directorio AD / LDAP.
  • Agentes de inventario — la política que ejecuta cada agente de lazyit de este parque: cada cuánto informan los hosts, qué recolectores se ejecutan y qué dejar afuera, más los ámbitos que pueden sobrescribir el predeterminado y un enlace a las reglas de confirmación automática. Ver Agente de reporte.
  • Asistente IA — el asistente de IA opcional (proveedor, modelo y clave, límites, búsqueda web) y el interruptor que permite que agentes de IA externos como Claude Code se conecten por MCP. Todo empieza desactivado. Mirá Asistente de IA — configuración.
  • Tareas — la bandeja de tareas manuales entre aplicaciones para los flujos de aprovisionamiento. La automatización de cada aplicación se configura en su propia pestaña de Automatización.

Sistema

  • General y versión — la versión en uso y las actualizaciones guiadas, y cómo está configurada esta instancia.

Cómo se lee una página de Configuración

Las páginas de Configuración mantienen el texto corto a propósito. Cada sección muestra un título, una línea que dice qué hace y, si lo tiene, su estado — Activado, Desactivado o Configurado — junto al título. La explicación larga de una sección o de un campo está tras el ? que tiene al lado: pasa el puntero por encima, o haz clic o tócalo para dejarlo abierto (también enlaza a la página del Manual correspondiente cuando la hay). Un recuadro de aviso aparece solo cuando algo tiene un riesgo real.

Los formularios se guardan con su botón Guardar al pie de la sección, que además indica si tienes cambios sin guardar. Un interruptor que va solo — como Comprobar actualizaciones semanalmente — se guarda en cuanto lo cambias.

General y versión

General y versión (antes se llamaba Instancia) muestra cómo está montada lazyit. Su sección Instancia es de solo lectura: refleja el estado actual, no lo cambia. Muestra:

  • Configurada — si la configuración inicial está completa (existe un administrador). Una instalación nueva muestra Configuración pendiente hasta que se crea el primer administrador.
  • Proveedor de identidad — la postura de inicio de sesión: Cuentas locales u OIDC genérico (usa el tuyo).
  • Administradores — cuántas cuentas de administrador tiene la instancia.
  • Postura de ejecución — Desarrollo o Producción.
  • Versión — la versión exacta que ejecuta esta instancia, fijada al construir sus imágenes. Un despliegue de una versión publicada muestra la etiqueta de la versión (por ejemplo, v1.4.2); una compilación hecha entre versiones muestra, con honestidad, la forma extendida v1.4.2-3-gabc1234 (la versión publicada más cercana más el commit desde el que se construyó); una ejecución local de desarrollo muestra dev. Cita este valor en los reportes de errores y antes de actualizar.

Estos valores los define el entorno en el que corre la instancia, no un formulario. Los operadores cambian el proveedor de identidad y la postura de ejecución mediante variables de entorno al desplegar (consulta Autoalojamiento); la página hace que el estado resultante sea visible dentro de la aplicación. Usa Actualizar para volver a leerlo.

Versión y actualizaciones

La primera sección de la página General y versión es Versión y actualizaciones. Muestra la versión que ejecutas y, si te suscribes, si hay una versión más nueva disponible — y te da una forma guiada de actualizar.

Comprobar actualizaciones (opcional)

La comprobación de actualizaciones está desactivada por defecto. Activa Comprobar actualizaciones semanalmente y lazyit, aproximadamente una vez por semana, hará una única consulta anónima a GitHub para ver si existe una versión más nueva. Es sin baliza: nunca sale del host ninguna información sobre tu instancia — es el mismo tipo de consulta que comprobar un espejo de software. Si la consulta está bloqueada (un host de egreso restringido o aislado), simplemente falla en silencio y la sección vuelve a mostrar tu versión actual. “No se pudo comprobar” nunca se interpreta como “actualizado”.

Cuando se ve por primera vez una versión más nueva, los administradores reciben una notificación al respecto (y un correo, si el correo saliente está configurado — consulta Correo y SMTP). Se te avisa una vez por cada versión nueva, no cada semana, para que el aviso siga siendo significativo.

Los agentes de reporte reciben una línea, no un correo propio. Los agentes instalados se quedan atrás precisamente porque la instancia avanzó, así que cuando alguno está una versión MAYOR completa por detrás de la instancia en ejecución, esa misma notificación añade una frase — “12 agentes de reporte están una versión MAYOR por detrás”. Eso es todo, deliberadamente: no hay un correo aparte para los agentes, ni una programación propia, ni nunca un mensaje por host. Si ningún agente está una MAYOR por detrás — o si lazyit no puede determinar qué versión ejecutan — la línea sencillamente no aparece, y la notificación es exactamente la que siempre fue.

Las versiones de seguridad destacan. Cuando una versión del intervalo es una corrección de seguridad, la insignia de estado se vuelve roja (N versiones por detrás — seguridad), aparece un aviso distintivo Actualización de seguridad disponible y el correo se marca como actualización de seguridad en el asunto — para que una corrección que conviene aplicar esta noche no se pierda entre subidas de versión rutinarias. Si una versión de la que ya te avisaron se publica después como corrección de seguridad, recibes un correo más para que no se te pase; tras eso deja de insistir.

La sección muestra una insignia de estado junto a su título (Actualizado, N versiones por detrás, Comprobación desactivada, No se pudo comprobar o la variante roja de seguridad), y luego tu versión actual, la última versión con un enlace a sus notas, y cuándo fue la última comprobación.

Actualizar (guiado, no de un solo clic)

Actualizar lazyit es una acción guiada del lado del host — deliberadamente no un botón de un solo clic dentro de la app. La aplicación nunca se actualiza a sí misma; una persona ejecuta la actualización en el servidor. Es una decisión de seguridad: cualquier cosa capaz de actualizar la app en su sitio necesitaría control con permisos de root sobre tu servidor, algo que la app está diseñada para no tener nunca.

Cuando estás por detrás, la sección muestra un único botón Actualizar a vX.Y.Z. Pulsarlo no actualiza nada — registra la solicitud y te muestra el comando exacto para ejecutar en el host:

./infra/update.sh vX.Y.Z

Ejecuta ese comando en el servidor (por SSH). El script es cuidadoso y no destructivo. En orden:

  1. Respalda ambas bases de datos (la de la app y la de identidad) y verifica que cada respaldo se pueda restaurar. Si el respaldo falla, la actualización se aborta — no hay forma de forzarla.
  2. Comprueba que la versión sea una publicación real de lazyit y la descarga. La obtiene del origin de tu repositorio por HTTPS o SSH y solo la acepta si es una etiqueta de versión publicada (vX.Y.Z) en la línea principal de publicaciones. Si la versión trae una firma, una firma inválida detiene la actualización; la mayoría de las versiones no van firmadas, y es lo esperado. Un remoto http:// o git:// sin cifrar se rechaza — cámbialo antes a HTTPS o SSH.
  3. Comprueba si hay ajustes nuevos requeridos. Si la nueva versión necesita una variable de entorno que aún no tienes, se detiene y te dice exactamente qué añadir — nunca edita por ti tu archivo de secretos.
  4. Compila la nueva versión mientras la actual sigue sirviendo, luego cambia a ella (una breve interrupción de ~1 minuto) y confirma que la nueva versión está sana.

Mientras una actualización se ejecuta, la sección muestra la etapa real (respaldando, migrando, compilando, reiniciando, verificando) — no una barra de progreso falsa — y se reconecta con discreción cuando la app vuelve.

Si actualizas desde v2.0.0 o anterior: haz a mano la actualización a v2.1.0. Hasta v2.0.0 el script de actualización se detenía en su comprobación de la versión en todas las versiones (después del respaldo, sin cambiar nada). La corrección llega en v2.1.0, pero el script que se ejecuta es siempre el de la versión desde la que actualizas. Así que, solo para esta actualización, respalda primero (ver Copias de seguridad y restauración) y ejecuta en el servidor:

git fetch --tags && git checkout v2.1.0 && ./infra/start.sh

A partir de v2.1.0, ./infra/update.sh vX.Y.Z funciona como se describe arriba.

Cancelar una actualización solicitada

Si pulsaste Actualizar pero aún no ejecutaste el comando en el host, la sección muestra un botón Cancelar esta actualización junto al comando. Cancelar descarta la solicitud pendiente para que la sección vuelva a su estado normal de “comprobar actualizaciones” y puedas iniciar una nueva más tarde. Solo puedes cancelar mientras sigue solicitada — una vez que el script del host ya empezó (respaldando en adelante), el botón desaparece y esa actualización debe terminar o reconciliarse, porque interrumpirla a mitad podría dejar las bases de datos y los respaldos desincronizados. La solicitud cancelada se conserva en el historial de actualizaciones como registro.

No hace falta cancelar primero para actualizar a otra versión. Si ejecutas update.sh en el host para otra versión mientras una solicitud sigue pendiente, el script reemplaza esa solicitud: queda marcada como fallida con la nota “Superseded by an operator-run update”, se conserva en el historial, y la sección sigue la actualización que realmente ejecutaste.

Si una actualización falla — el punto de restauración

El respaldo previo a la actualización es un punto de restauración, no un deshacer mágico. Si la actualización falla antes de migrar la base de datos, el script revierte automáticamente y no se pierde nada. Si falla después de que corriera una migración, no hay reversión automática: volver atrás implica restaurar el respaldo previo, lo que descarta todo lo escrito desde que se tomó el respaldo (unos minutos). El script nunca hace esto en silencio — se detiene e imprime los comandos de restauración exactos para que los ejecutes tú, y la versión anterior, sus imágenes y los respaldos se conservan hasta que confirmes que la nueva versión está sana. El procedimiento completo está en el runbook de respaldos.

Correo, directorio y etiquetas de activos

Antes compartían la página Instancia y ahora cada uno tiene su propia página en Configuración: Correo y SMTP (Configuración → Correo), Sincronización de directorio AD / LDAP (Configuración → Directorio AD/LDAP) y Esquema de etiquetas de activos (Configuración → Etiquetas de activos). No cambió nada de cómo funcionan — solo dónde están.

Qué se configura en otro sitio

No todo ajuste de la instancia es un formulario en Configuración. Varios se controlan a propósito desde el entorno y no desde la interfaz, porque son cuestiones de despliegue que el operador gestiona:

  • Proveedor de identidad y postura de ejecución — variables de entorno (visibles en solo lectura en la página General y versión).
  • Zona horaria de visualización — la variable NEXT_PUBLIC_DEFAULT_TIME_ZONE. Consulta Zona horaria y formatos.
  • Conexión del motor de búsqueda y reindexación — entorno más un script de mantenimiento. Consulta Índice de búsqueda.
  • La clave que cifra la clave de API del proveedor de IA — la variable AI_SECRET_KEY. Mirá Asistente de IA — configuración.

Esta separación es deliberada: la clasificación y el acceso del día a día viven en la interfaz, mientras que los ajustes de postura e infraestructura viven con el despliegue para que estén versionados y sean reproducibles.