109 lines
3.4 KiB
Markdown
109 lines
3.4 KiB
Markdown
# Platform Service Configuration Files
|
||
|
||
This directory contains **16 production-ready TOML configuration files** generated from Nickel schemas
|
||
for all platform services across all deployment modes.
|
||
|
||
## Generated Files
|
||
|
||
**4 Services × 4 Deployment Modes = 16 Configuration Files**
|
||
|
||
```toml
|
||
orchestrator.{solo,multiuser,cicd,enterprise}.toml (2.2 kB each)
|
||
control-center.{solo,multiuser,cicd,enterprise}.toml (3.4 kB each)
|
||
mcp-server.{solo,multiuser,cicd,enterprise}.toml (2.7 kB each)
|
||
installer.{solo,multiuser,cicd,enterprise}.toml (2.5 kB each)
|
||
```
|
||
|
||
**Total**: ~45 KB, all validated and ready for deployment
|
||
|
||
## Deployment Modes
|
||
|
||
| Mode | Resources | Database | Use Case | Load |
|
||
| ------ | ----------- | ---------- | ---------- | ------ |
|
||
| **solo** | 2 CPU, 4 GB | Embedded | Development | `ORCHESTRATOR_MODE=solo` |
|
||
| **multiuser** | 4 CPU, 8 GB | PostgreSQL/SurrealDB | Team Staging | `ORCHESTRATOR_MODE=multiuser` |
|
||
| **cicd** | 8 CPU, 16 GB | Ephemeral | CI/CD Pipelines | `ORCHESTRATOR_MODE=cicd` |
|
||
| **enterprise** | 16+ CPU, 32+ GB | SurrealDB HA | Production | `ORCHESTRATOR_MODE=enterprise` |
|
||
|
||
## Quick Start
|
||
|
||
### Load a configuration mode
|
||
|
||
```toml
|
||
# Solo mode (single developer)
|
||
export ORCHESTRATOR_MODE=solo
|
||
export CONTROL_CENTER_MODE=solo
|
||
|
||
# Multiuser mode (team development)
|
||
export ORCHESTRATOR_MODE=multiuser
|
||
export CONTROL_CENTER_MODE=multiuser
|
||
|
||
# Enterprise mode (production HA)
|
||
export ORCHESTRATOR_MODE=enterprise
|
||
export CONTROL_CENTER_MODE=enterprise
|
||
```
|
||
|
||
### Override individual fields
|
||
|
||
```javascript
|
||
export ORCHESTRATOR_SERVER_WORKERS=8
|
||
export ORCHESTRATOR_SERVER_PORT=9090
|
||
export CONTROL_CENTER_REQUIRE_MFA=true
|
||
```
|
||
|
||
## Configuration Loading Hierarchy
|
||
|
||
Each service loads configuration with this priority:
|
||
|
||
1. **Explicit path** — `{SERVICE}_CONFIG` environment variable
|
||
2. **Mode-specific** — `{SERVICE}_MODE` → `provisioning/platform/config/{service}.{mode}.toml`
|
||
3. **Legacy** — `config.user.toml` (backward compatibility)
|
||
4. **Defaults** — `config.defaults.toml` or built-in
|
||
5. **Field overrides** — `{SERVICE}_*` environment variables
|
||
|
||
## Docker Compose Integration
|
||
|
||
```javascript
|
||
export DEPLOYMENT_MODE=multiuser
|
||
docker-compose -f provisioning/platform/infrastructure/docker/docker-compose.yml up
|
||
```
|
||
|
||
## Kubernetes Integration
|
||
|
||
```yaml
|
||
# Load enterprise mode configs into K8s
|
||
kubectl create configmap orchestrator-config
|
||
--from-file=provisioning/platform/config/orchestrator.enterprise.toml
|
||
```
|
||
|
||
## Validation
|
||
|
||
Verify all configs parse correctly:
|
||
|
||
```toml
|
||
for file in *.toml; do
|
||
nu -c "open '$file'" && echo "✅ $file" || echo "❌ $file"
|
||
done
|
||
```
|
||
|
||
## Structure
|
||
|
||
- **orchestrator.*.toml** — Workflow engine configuration
|
||
- **control-center.*.toml** — Policy/RBAC backend configuration
|
||
- **mcp-server.*.toml** — MCP server configuration
|
||
- **installer.*.toml** — Installation/bootstrap configuration
|
||
|
||
Each file contains service-specific settings for networking, storage, security, logging, and monitoring.
|
||
|
||
## Related Documentation
|
||
|
||
- **Configuration workflow**: `provisioning/.typedialog/provisioning/platform/configuration-workflow.md`
|
||
- **Usage guide**: `provisioning/.typedialog/provisioning/platform/usage-guide.md`
|
||
- **Schema definitions**: `provisioning/.typedialog/provisioning/platform/schemas/`
|
||
- **Default values**: `provisioning/.typedialog/provisioning/platform/defaults/`
|
||
|
||
## Generated By
|
||
|
||
**Framework**: TypeDialog + Nickel Configuration System
|
||
**Date**: 2026-01-05
|
||
**Status**: ✅ Production Ready |