Zum Inhalt springen

Der Arbeitsbereich und der Ordner .microlab/

MicroLab speichert zwei Dinge an unterschiedlichen Orten: Ihre Repositorys (den Arbeitsbereich) und seine eigene Konfiguration (den Ordner .microlab/).

Es ist der Basisordner, der die Repositorys Ihrer Micros enthält. Standardmäßig ist es der Ordner, der die App selbst enthält; wenn Ihre Repos woanders sind, geben Sie es unter Einstellungen → Pfade → Arbeitsbereich an. Manifeste speichern den Pfad jedes Repos relativ zu diesem Arbeitsbereich, damit sie maschinenübergreifend portabel sind.

Dort lebt MicroLabs Konfiguration für ein Projekt. Was er enthält:

PfadWas es istGit?
scenarios/*.ymlDie SzenarienVersionierbar
micros/ (Manifeste)Die Beschreibung jedes MicrosVersionierbar
mocks/<Dienst>.jsonDer Mock-Katalog pro DienstVersionierbar
databases.ymlDer Katalog der DatenbankverbindungenVersionierbar
settings.local.ymlLokale Config und Zugangsdaten dieser MaschineAußerhalb von Git
.runtime/Laufzeitzustand (Control server, Logs, Entitlements, Einwilligung, temporäre Overrides)Außerhalb von Git

Die Idee: Was zum Projekt oder Team gehört (Szenarien, Manifeste, Mocks) wird versioniert und geteilt; was zu Ihrer Maschine gehört (absolute Pfade, Geheimnisse, flüchtiger Zustand) bleibt in settings.local.yml und .runtime/, außerhalb der Versionskontrolle.

Geheimnisse gehen nie im Klartext in eine versionierte Datei. Sie werden in settings.local.yml gespeichert (bearbeitbar unter Einstellungen → Zugangsdaten) und in Manifesten, Abhängigkeiten und Datenbanken als ${creds.<Schlüssel>} referenziert. MicroLab löst sie beim Start auf.