Runbook
Operational fundamentals are inherited from the Base Template. Tenants specifics:
Common tasks
| Task |
Command |
| Build |
dotnet build ConnectSoft.Saas.TenantsTemplate.slnx |
| Run host |
dotnet run --project src/ConnectSoft.Saas.Tenants.Application |
| Test |
dotnet test |
| Migrations |
MicroserviceMigration runs via the host migration pipeline |
Troubleshooting
| Symptom |
Likely cause |
Action |
| Duplicate tenant key/id error |
UQ_Tenants_TenantKey / UQ_Tenants_TenantId |
Tenant key/id must be globally unique - choose a new key |
| Transition rejected |
Illegal lifecycle move |
Check AllowedTransitions (Draft->Active->Suspended->Decommissioned) |
| Downstream contexts not reacting |
Lifecycle events not delivered |
Ensure MassTransit transport/persistence are configured |
| Cross-partition mutation error |
Grain key mismatch |
Operation TenantId must match TenantLifecycleGrain key |
See also