Conceptos básicos de configuración

Archivos de configuración y ajustes base de KiloCenter — config.docker.yaml, KC-Core, KC-Gateway, asignaciones de puertos.

Objetivo

Comprender y verificar la configuración de tiempo de ejecución de referencia para una implementación local.

Archivos de configuración

• kilocenter-modules/config/config.docker.yaml -- configuración de KC-Core (modo contenedor)

• kilocenter-modules/KC-Core/config.yaml -- configuración de KC-Core (modo de desarrollo desde código fuente)

• kilocenter-modules/KC-Gateway/config.yaml -- configuración de KC-Gateway (modo de desarrollo desde código fuente)

• kilocenter-modules/docker-compose.yml -- definiciones de servicios y asignaciones de puertos

Valores predeterminados del modo contenedor

En modo contenedor, KC-Core lee config/config.docker.yaml. Todas las direcciones de servicio usan nombres DNS de servicios de Docker (p. ej., postgres, redis, mosquitto). Las variables de entorno en .env anulan los valores predeterminados de compose.

Valores predeterminados del modo de desarrollo desde código fuente

kilocenter-modules/start-dev.sh exporta variables de entorno y detecta automáticamente el puerto de PostgreSQL:

• Si el contenedor Docker kilocenter-postgres está en ejecución, usa el puerto 5433.

• De lo contrario, recurre a 5432 para un PostgreSQL local en el host.

Configuraciones para verificar antes de probar

• Base de datos: host, puerto, credenciales (valor predeterminado: localhost:5433, usuario kilocenter, contraseña cámbiame)

• salud de KC-Core: puerto 8086

• gRPC-web de KC-Gateway: puerto 9090

• salud de KC-Gateway: puerto 8087

• BSSCI: puerto 5000, rutas de certificados TLS

• SCACI: puerto 5001, rutas de certificados TLS

• MQTT: host, puerto y credenciales del broker

Rutas de certificados TLS

Las rutas de certificados TLS de BSSCI y SCACI se configuran en la protocolo sección en KC-Core/config.yaml (desarrollo desde código fuente) o config/config.docker.yaml (contenedor):

protocolo:
  bsci_tls:
    enabled: true
    cert_file: "certificates/server.crt"
    key_file: "certificates/server.key"
    ca_file: "certificates/ca.crt"
    min_version: "1.2"
  scaci_tls:
    enabled: true
    cert_file: "certificates/server.crt"
    key_file: "certificates/server.key"
    ca_file: "certificates/ca.crt"
    min_version: "1.3"

Las rutas en la configuración de desarrollo desde código fuente son relativas al directorio de trabajo de KC-Core. La configuración del contenedor usa rutas absolutas (/app/certificates/). Genere los certificados antes del primer inicio; consulte la instalación de Docker Compose.

Credenciales predeterminadas

Estos valores predeterminados existen por conveniencia en el desarrollo local. Cámbielos para cualquier implementación no local:

• PostgreSQL: usuario kilocenter, contraseña cámbiame

• Broker MQTT: usuario admin, contraseña KiloCenter

• Inicio de sesión de fábrica de la estación base AVA: ubuntu / 123456

Integración MQTT

MQTT está deshabilitado de forma predeterminada en KC-Core/config.yaml:

mqtt:
  enabled: false
  host: "localhost"
  port: 1883
  username: "admin"
  password: "KiloCenter"

Para habilitar MQTT, establezca enabled: true y reinicie KC-Core. El broker Mosquitto debe estar en ejecución (está incluido en la pila de Docker Compose). Consulte Primeros pasos con MQTT para obtener detalles de integración.

Lista de verificación de validación

• KC-Core se inicia sin errores y /health responde en el puerto 8086

• KC-Gateway se inicia y /health responde en el puerto 8087

• Modo contenedor: KC-Web se carga en http://localhost/

• Modo de desarrollo desde el código fuente: KC-Web se carga en http://localhost:5173

• KC-Web puede conectarse a KC-Gateway en el puerto 9090 (las solicitudes gRPC-web se completan correctamente en la consola del navegador)