Templates

Composez des twins dans un même environnement quand vous avez besoin d'une topologie d'usine, d'un namespace, de paramètres runtime ou d'une portée protocolaire.

Détails techniques

Partez d'un template minimal

kind: MiravoTemplate
version: "1"
name: "My Environment"

namespace:
  enterprise: AcmeCorp
  site: detroit-plant

areas:
  - name: production
    lines:
      - name: line-1
        twins:
          - model: centrifugal-pump
            count: 3
            variation: 0.05

settings:
  tick_interval_ms: 1000
  time_multiplier: 1

Enregistrez ce fichier sous my-plant.miravo.yaml.

Validez le fichier avec miravo start avant de démarrer un runtime.

miravo start --template ./my-plant.miravo.yaml --dry-run

Inspectez la topologie résolue avec miravo templates inspect.

miravo templates inspect ./my-plant.miravo.yaml

Modélisez la topologie explicitement

Les templates définissent areas, puis lines, puis twins. Chaque affectation fixe un modèle, le nombre d'instances, des surcharges éventuelles, des heures initiales éventuelles et une portée protocolaire éventuelle.

Le namespace utilise enterprise et site dans l'esprit ISA-95, ou un prefix plat. Les chemins émis continuent avec area, line, instance et member.

Cadrez les protocoles là où ils comptent

protocols:
  opcua:
    port: 4840
  mqtt:
    port: 1883

areas:
  - name: machining
    protocol_scope: [opcua]
    lines:
      - name: cnc-cell
        twins:
          - model: cnc-spindle
            count: 2
          - model: storage-tank
            count: 1
            protocol_scope: [mqtt]

La portée la plus proche gagne. Miravo résout protocol_scope dans cet ordre : affectation de twin, line, area, puis protocols global.

Validez avant de lancer

miravo start --template <id|path> --dry-run valide le template et ses modèles référencés sans démarrer le runtime. miravo templates inspect <id> affiche la topologie résolue et l'ensemble des modèles référencés.

Référence

Pages liées