Notions de base de configuration

Fichiers de configuration et paramètres de base de KiloCenter — config.docker.yaml, KC-Core, KC-Gateway, mappages de ports.

Objectif

Comprendre et vérifier la configuration d’exécution de base pour un déploiement local.

Fichiers de configuration

• kilocenter-modules/config/config.docker.yaml -- configuration de KC-Core (mode conteneur)

• kilocenter-modules/KC-Core/config.yaml -- configuration de KC-Core (mode de développement source)

• kilocenter-modules/KC-Gateway/config.yaml -- configuration de KC-Gateway (mode de développement source)

• kilocenter-modules/docker-compose.yml -- définitions des services et mappages de ports

Valeurs par défaut du mode conteneur

En mode conteneur, KC-Core lit config/config.docker.yaml. Toutes les adresses des services utilisent des noms DNS de service Docker (p. ex., postgres, redis, mosquitto). Les variables d’environnement dans .env remplacent les valeurs par défaut de Compose.

Valeurs par défaut du mode de développement source

kilocenter-modules/start-dev.sh exporte les variables d’environnement et détecte automatiquement le port PostgreSQL :

• Si le conteneur Docker kilocenter-postgres est en cours d’exécution, il utilise le port 5433.

• Sinon, il se rabat sur 5432 pour un PostgreSQL local sur l’hôte.

Paramètres à vérifier avant les tests

• Base de données: hôte, port, identifiants (par défaut : localhost:5433, utilisateur kilocenter, mot de passe changeme)

• Santé de KC-Core: port 8086

• KC-Gateway gRPC-web: port 9090

• Santé de KC-Gateway: port 8087

• BSSCI: port 5000, chemins des certificats TLS

• SCACI: port 5001, chemins des certificats TLS

• MQTT: hôte du courtier, port et identifiants

Chemins des certificats TLS

Les chemins des certificats TLS BSSCI et SCACI sont configurés dans la protocole section dans KC-Core/config.yaml (mode dev source) ou config/config.docker.yaml (conteneur) :

protocol:
  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"

Les chemins dans la configuration du mode dev source sont relatifs au répertoire de travail de KC-Core. La configuration conteneur utilise des chemins absolus (/app/certificates/). Générez les certificats avant le premier démarrage — voir l’installation de Docker Compose.

Identifiants par défaut

Ces valeurs par défaut existent pour faciliter le développement local. Modifiez-les pour tout déploiement non local :

• PostgreSQL : utilisateur kilocenter, mot de passe changeme

• Courtier MQTT : utilisateur admin, mot de passe KiloCenter

• Connexion d’usine de la station de base AVA : ubuntu / 123456

Intégration MQTT

MQTT est désactivé par défaut dans KC-Core/config.yaml:

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

Pour activer MQTT, définissez enabled: true et redémarrez KC-Core. Le courtier Mosquitto doit être en cours d’exécution (il est inclus dans la pile Docker Compose). Voir Premiers pas MQTT pour les détails d’intégration.

Liste de vérification de validation

• KC-Core démarre sans erreur et /health répond sur le port 8086

• KC-Gateway démarre et /health répond sur le port 8087

• Mode conteneur: KC-Web se charge à http://localhost/

• Mode de développement à partir des sources: KC-Web se charge à http://localhost:5173

• KC-Web peut joindre KC-Gateway sur le port 9090 (les requêtes gRPC-web réussissent dans la console du navigateur)