Saltar al contenido principal

​
config.yaml

ipmideck lee sus ajustes de data/config.yaml, escrito con valores predeterminados sensatos en el primer arranque. Puedes editar el archivo directamente, o sobrescribir cualquier valor en tiempo de ejecución con una variable de entorno (práctico para Docker, mira abajo). 
# data/config.yaml (auto-generated on first run)
server:
  host: "0.0.0.0"
  port: 3000
  https: false
auth:
  enabled: true
  session_expiry: "24h"
  max_login_attempts: 5
ipmi:
  poll_interval: 30
  power_poll_interval: 30
  command_timeout: 30
data:
  retention_days: 365
  cleanup_interval: "24h"
logging:
  level: "info"
modules:
  sensors:
    enabled: true
  fanpilot:
    enabled: true
  power:
    enabled: true
  sel:
    enabled: true
  fru:
    enabled: true
Las claves de arriba son las claves anidadas reales, sin prefijo, que ipmideck escribe en config.yaml. Las sobrescrituras por variable de entorno usan un prefijo IPMIDECK_ aparte y nunca aparecen dentro del propio archivo YAML.

​
Sobrescrituras de entorno

Cada ajuste puede sobrescribirse en tiempo de ejecución con una variable de entorno con prefijo IPMIDECK_. Esta es la forma más fácil de configurar ipmideck en Docker, donde no quieres editar un archivo dentro del contenedor.
Variable de entornoDescripción
IPMIDECK_SERVER_HOSTHost/interfaz al que se enlaza el panel (predeterminado 0.0.0.0).
IPMIDECK_SERVER_PORTPuerto HTTP al que se enlaza el panel (predeterminado 3000).
IPMIDECK_AUTH_ENABLEDHabilita o deshabilita el inicio de sesión integrado (predeterminado true).
IPMIDECK_AUTH_SESSION_EXPIRYCuánto tiempo sigue válida una sesión de inicio de sesión (predeterminado 24h).
IPMIDECK_IPMI_POLL_INTERVALSegundos entre sondeos de sensores del BMC (predeterminado 30).
IPMIDECK_IPMI_POWER_POLL_INTERVALSegundos entre sondeos de estado de energía (predeterminado 30).
IPMIDECK_DATA_RETENTION_DAYSDías de historial de sensores a conservar antes de la limpieza (predeterminado 365).
IPMIDECK_DATA_DB_PATHRuta absoluta al archivo de base de datos SQLite.
IPMIDECK_LOGGING_LEVELVerbosidad de registro: debug, info, warning o error (predeterminado info).
IPMIDECK_DEMOEjecutar contra hardware simulado en lugar de BMC reales (predeterminado false).
Otras dos variables controlan ubicaciones de archivos en lugar de un valor de config.yaml: IPMIDECK_DATA_DIR (el directorio de datos, mira abajo) y IPMIDECK_CONFIG_PATH (una ruta explícita a un config.yaml a cargar).
Las variables de entorno tienen prioridad sobre los valores en config.yaml. Defínelas en tu comando docker run (-e IPMIDECK_SERVER_PORT=8080) o en tu docker-compose.yml.

​
Dónde reside la configuración

ipmideck resuelve su directorio de datos desde IPMIDECK_DATA_DIR si está definido, de lo contrario recurre a un valor predeterminado de plataforma. config.yaml siempre reside en <data-dir>/config.yaml:
  • Docker: /data/config.yaml: la imagen define IPMIDECK_DATA_DIR=/data; persiste /data con un volumen.
  • pip en Linux: /data/config.yaml de forma predeterminada: define IPMIDECK_DATA_DIR para reubicarlo.
  • pip en Windows: ./data/config.yaml, relativo al directorio desde el que ejecutas ipmideck.

​
Próximos pasos