Zum Inhalt springen

Micro, Manifest und Stack

Ein Micro ist ein startbares Repository. In MicroLab fügen Sie es einmal hinzu —indem Sie seinen Ordner wählen oder es aus Git klonen— und ab dann wird es durch ein Manifest beschrieben, das MicroLab für Sie erzeugt.

Das Manifest ist die Beschreibung, wie ein Micro startet: seine Technologie, seine Ports, die Infrastruktur, die es braucht, seine Abhängigkeiten zu anderen Cores und sein Startrezept. MicroLab erkennt es automatisch beim Hinzufügen des Micros (aus Dateien wie pom.xml, application.yml oder package.json); Sie prüfen es nur.

Das Manifest ist portabel: Der Pfad zum Repo wird relativ zum Arbeitsbereich gespeichert, nicht absolut, damit es maschinenübergreifend funktioniert. Es kann aus der App (Bereich Micros) oder aus dem CLI bearbeitet werden.

Wenn Sie im Repo den Branch wechseln, können sich seine Ports oder Abhängigkeiten ändern; MicroLab erkennt das (Drift) und bietet an, das Manifest aus dem Repository zu aktualisieren, wobei das von Hand Kuratierte erhalten bleibt. Siehe Branch wechseln und Drift.

Der Stack ist die Technologie des Micros. Heute unterstützt MicroLab:

quarkus · spring-boot · node · angular · python

Der Stack bestimmt drei Dinge: wie der Micro startet (sein Befehl), wo sein Health ist (um zu wissen, wann er gesund ist) und wie ihm die Konfiguration injiziert wird (-D-Systemeigenschaften in der JVM-Familie, Umgebungsvariablen in Node/Python usw.).

Dieses Wissen lebt in einer Registry von Profilen pro Technologie innerhalb von MicroLab, nicht im Manifest: Das Manifest deklariert nur stack.kind (quarkus, node…) und, falls nötig, eine punktuelle Anpassung. Unterstützung für eine neue Technologie hinzuzufügen bedeutet, ein Profil hinzuzufügen, nicht in Ihren Micros etwas umzuschreiben.