Services¶
Use the mbse-lab services commands for routine Flexo and SysON lifecycle
operations. They wrap the repo-owned Docker Compose files while preserving the
service data directories by default.
Endpoints¶
| Stack | Endpoint | URL |
|---|---|---|
| Flexo MMS | Layer1 API | http://localhost:18080 |
| Flexo MMS | SysML v2 API | http://localhost:18083 |
| Flexo MMS | Auth login | http://localhost:8082/login |
| Flexo MMS | Fuseki | http://localhost:3030 |
| Flexo MMS | MinIO | http://localhost:9000 |
| SysON | Web UI | http://localhost:18090 |
| SysON | GraphQL API | http://localhost:18090/api/graphql |
| SysON | REST API docs | http://localhost:18090/v3/api-docs/rest-apis |
Start¶
Create or refresh local runtime files first:
Start Flexo and SysON:
By default, services up waits for the selected service APIs. Use --no-wait
only when you want container startup to return immediately.
Initialize the Flexo org used by the SysML v2 service after first setup:
The backup step writes an ignored N-Quads backup under
deploy/flexo-mms/backups/. It does not refresh the tracked startup seed unless
you explicitly pass the seed-update flags.
Status¶
Check local service status:
Check APIs directly when you need lower-level confirmation:
Run a disposable deployment smoke test without touching normal local containers or data:
The isolated smoke test uses a unique Docker Compose project name, random
localhost-only host ports, and temporary bind-mounted data under
tmp/isolated-deployments/. It tears the stack down after verification unless
--keep is passed.
Logs¶
Inspect recent logs:
Use --follow, --flexo-service, and --syson-service for focused log
inspection.
Stop And Restart¶
Stop both service families without deleting runtime data:
Stop only SysON:
Stop only Flexo:
Restart the lab:
Use services down --volumes only when you intentionally want to remove
Compose-managed volumes. It does not remove the ignored SysON Postgres bind
mount; see Safety And Sharing for the service data
boundary.
Maintenance¶
After meaningful Flexo graph changes:
Refresh the tracked synthetic startup seed only with explicit intent:
Rotate ignored local Flexo credentials:
The forced Flexo regeneration path remains a maintainer operation because it may overwrite local generated deployment files: