Compare commits
No commits in common. "f9443f1ea5c7c0649895ff70a0760da86437ee16" and "22244bd21a1952dc7978f06ad0e353d96de8d2d6" have entirely different histories.
f9443f1ea5
...
22244bd21a
@ -14,7 +14,7 @@ repos:
|
||||
language: system
|
||||
types: [rust]
|
||||
pass_filenames: false
|
||||
stages: [pre-commit]
|
||||
stages: [pre-push]
|
||||
|
||||
- id: rust-clippy
|
||||
name: Rust linting (cargo clippy)
|
||||
@ -22,7 +22,7 @@ repos:
|
||||
language: system
|
||||
types: [rust]
|
||||
pass_filenames: false
|
||||
stages: [pre-commit]
|
||||
stages: [pre-push]
|
||||
|
||||
# NOTE: Disabled - cargo test blocks git push. Tests should run in CI/CD.
|
||||
# - id: rust-test
|
||||
|
||||
@ -61,7 +61,7 @@ nickel export --format toml provisioning/schemas/infrastructure/systemd.ncl
|
||||
|
||||
Define service configuration once, generate multiple infrastructure outputs:
|
||||
|
||||
```plaintext
|
||||
```
|
||||
orchestrator.ncl (Platform Service Schema)
|
||||
↓
|
||||
Infrastructure Schemas (Docker, Kubernetes, Nginx, etc.)
|
||||
@ -123,7 +123,7 @@ nickel export --format yaml provisioning/schemas/infrastructure/kubernetes.ncl \
|
||||
|
||||
## File Structure
|
||||
|
||||
```plaintext
|
||||
```
|
||||
infrastructure/
|
||||
├── README.md # This file
|
||||
├── docker-compose.ncl # Docker Compose schema (232 lines)
|
||||
@ -273,7 +273,6 @@ oci_registry_config # Zot backend with filesystem storage
|
||||
- Other services: 0.25-0.5 CPU, 256-512M RAM
|
||||
|
||||
**Export to JSON**:
|
||||
|
||||
```bash
|
||||
nickel export --format json provisioning/schemas/infrastructure/examples-solo-deployment.ncl
|
||||
# Output: 198 lines of configuration
|
||||
@ -299,7 +298,6 @@ oci_registry_config # Harbor backend with S3 replication
|
||||
- Services scale appropriately for production load
|
||||
|
||||
**Export to JSON**:
|
||||
|
||||
```bash
|
||||
nickel export --format json provisioning/schemas/infrastructure/examples-enterprise-deployment.ncl
|
||||
# Output: 313 lines of configuration
|
||||
@ -308,7 +306,7 @@ nickel export --format json provisioning/schemas/infrastructure/examples-enterpr
|
||||
### Example Comparison
|
||||
|
||||
| Aspect | Solo | Enterprise |
|
||||
| -------- | ------ | ----------- |
|
||||
|--------|------|-----------|
|
||||
| **Services** | 5 | 6 |
|
||||
| **Orchestrator CPU** | 1.0 | 4.0 |
|
||||
| **Orchestrator Memory** | 1024M | 4096M |
|
||||
@ -397,7 +395,7 @@ Infrastructure schemas are independent from platform config schemas:
|
||||
|
||||
ConfigLoader automatically loads platform configs. Infrastructure configs are generated separately and deployed via infrastructure tools:
|
||||
|
||||
```plaintext
|
||||
```
|
||||
Platform Schema (Nickel)
|
||||
↓ nickel export → TOML
|
||||
↓ ConfigLoader → Service reads config
|
||||
|
||||
@ -1,7 +1,6 @@
|
||||
# TypeDialog + Nickel Configuration System for Platform Services
|
||||
|
||||
Complete configuration system for provisioning platform services (orchestrator, control-center, mcp-server, vault-service,
|
||||
extension-registry, rag, ai-service, provisioning-daemon) across multiple deployment modes (solo, multiuser, cicd, enterprise).
|
||||
Complete configuration system for provisioning platform services (orchestrator, control-center, mcp-server, vault-service, extension-registry, rag, ai-service, provisioning-daemon) across multiple deployment modes (solo, multiuser, cicd, enterprise).
|
||||
|
||||
## Architecture Overview
|
||||
|
||||
@ -16,7 +15,7 @@ This system implements a **TypeDialog + Nickel configuration workflow** that pro
|
||||
|
||||
## Directory Structure
|
||||
|
||||
```plaintext
|
||||
```
|
||||
provisioning/.typedialog/provisioning/platform/
|
||||
├── constraints/ # Single source of truth for validation limits
|
||||
├── schemas/ # Nickel type contracts (services + common + deployment modes)
|
||||
@ -49,7 +48,7 @@ nu scripts/configure.nu orchestrator solo --backend web
|
||||
|
||||
### 2. Configuration Composition
|
||||
|
||||
```plaintext
|
||||
```
|
||||
Base Defaults (defaults/*.ncl)
|
||||
↓
|
||||
+ Mode Overlay (defaults/deployment/{mode}-defaults.ncl)
|
||||
@ -250,7 +249,7 @@ nu provisioning/.typedialog/provisioning/platform/scripts/install-services.nu so
|
||||
|
||||
## Configuration Loading Hierarchy (Rust Services)
|
||||
|
||||
```plaintext
|
||||
```
|
||||
1. Environment variables (ORCHESTRATOR_*)
|
||||
2. User config (values/{service}.{mode}.ncl → TOML)
|
||||
3. Mode-specific defaults (configs/{service}.{mode}.toml)
|
||||
@ -260,7 +259,6 @@ nu provisioning/.typedialog/provisioning/platform/scripts/install-services.nu so
|
||||
## Constraint Interpolation Example
|
||||
|
||||
**constraints.toml**:
|
||||
|
||||
```toml
|
||||
[orchestrator.queue.concurrent_tasks]
|
||||
min = 1
|
||||
@ -268,7 +266,6 @@ max = 100
|
||||
```
|
||||
|
||||
**Form element** (fragments/orchestrator-queue-section.toml):
|
||||
|
||||
```toml
|
||||
[[elements]]
|
||||
name = "max_concurrent_tasks"
|
||||
@ -279,7 +276,6 @@ nickel_path = ["orchestrator", "queue", "max_concurrent_tasks"]
|
||||
```
|
||||
|
||||
**Jinja2 template** (orchestrator-config.ncl.j2):
|
||||
|
||||
```nickel
|
||||
orchestrator = {
|
||||
queue = {
|
||||
@ -293,19 +289,16 @@ orchestrator = {
|
||||
## Getting Started
|
||||
|
||||
1. **Run configuration wizard**:
|
||||
|
||||
```bash
|
||||
nu provisioning/.typedialog/provisioning/platform/scripts/configure.nu orchestrator solo
|
||||
```
|
||||
|
||||
2. **Generate TOML configs**:
|
||||
|
||||
```bash
|
||||
nu provisioning/.typedialog/provisioning/platform/scripts/generate-configs.nu orchestrator solo
|
||||
```
|
||||
|
||||
3. **Deploy services**:
|
||||
|
||||
```bash
|
||||
nu provisioning/.typedialog/provisioning/platform/scripts/install-services.nu solo
|
||||
```
|
||||
@ -325,7 +318,7 @@ orchestrator = {
|
||||
## Key Files
|
||||
|
||||
| File | Purpose |
|
||||
| ------ | --------- |
|
||||
|------|---------|
|
||||
| `constraints/constraints.toml` | Single source of truth for validation limits |
|
||||
| `schemas/orchestrator.ncl` | Orchestrator type schema |
|
||||
| `defaults/orchestrator-defaults.ncl` | Orchestrator default values |
|
||||
|
||||
@ -13,7 +13,7 @@ Configurations are **automatically generated** by composing:
|
||||
|
||||
## File Organization
|
||||
|
||||
```plaintext
|
||||
```
|
||||
configs/
|
||||
├── README.md # This file
|
||||
├── orchestrator.solo.ncl # Orchestrator solo mode
|
||||
@ -56,7 +56,6 @@ let validators = import "../validators/orchestrator-validator.ncl" in
|
||||
## Example Configuration
|
||||
|
||||
### Base Defaults
|
||||
|
||||
```nickel
|
||||
# defaults/orchestrator-defaults.ncl
|
||||
orchestrator = {
|
||||
@ -77,7 +76,6 @@ orchestrator = {
|
||||
```
|
||||
|
||||
### Solo Mode Override
|
||||
|
||||
```nickel
|
||||
# defaults/deployment/solo-defaults.ncl
|
||||
services.orchestrator = {
|
||||
@ -88,7 +86,6 @@ services.orchestrator = {
|
||||
```
|
||||
|
||||
### Generated Config
|
||||
|
||||
```nickel
|
||||
# configs/orchestrator.solo.ncl (auto-generated)
|
||||
{
|
||||
@ -122,7 +119,6 @@ services.orchestrator = {
|
||||
### Regenerating Configs
|
||||
|
||||
#### Via TypeDialog (Recommended)
|
||||
|
||||
```bash
|
||||
nu provisioning/.typedialog/provisioning/platform/scripts/configure.nu orchestrator solo
|
||||
```
|
||||
@ -134,7 +130,6 @@ Automatically:
|
||||
4. Generates updated config
|
||||
|
||||
#### Manual Rebuild
|
||||
|
||||
```bash
|
||||
# (Future) Script to rebuild all configs from sources
|
||||
nu provisioning/.typedialog/provisioning/platform/scripts/generate-configs.nu orchestrator solo
|
||||
@ -171,7 +166,7 @@ nu provisioning/.typedialog/provisioning/platform/scripts/generate-configs.nu or
|
||||
|
||||
## Configuration Values Hierarchy
|
||||
|
||||
```plaintext
|
||||
```
|
||||
1. Explicit user customization (values/{service}.{mode}.ncl)
|
||||
2. Mode-specific defaults (defaults/deployment/{mode}-defaults.ncl)
|
||||
3. Service base defaults (defaults/{service}-defaults.ncl)
|
||||
@ -184,14 +179,12 @@ Configurations are validated at three levels:
|
||||
|
||||
### 1. Schema Validation
|
||||
Type checking when config is evaluated:
|
||||
|
||||
```plaintext
|
||||
```
|
||||
| schemas.OrchestratorConfig
|
||||
```
|
||||
|
||||
### 2. Constraint Validation
|
||||
Range checking via validators:
|
||||
|
||||
```nickel
|
||||
max_concurrent_tasks = validators.ValidConcurrentTasks 5
|
||||
```
|
||||
@ -211,7 +204,6 @@ nu provisioning/.typedialog/provisioning/platform/scripts/generate-configs.nu or
|
||||
```
|
||||
|
||||
Rust services load the TOML:
|
||||
|
||||
```rust
|
||||
let config_path = "provisioning/platform/config/orchestrator.solo.toml";
|
||||
let config = Config::from_file(config_path)?;
|
||||
|
||||
@ -4,10 +4,9 @@ Complete documentation of the configuration pipeline that transforms interactive
|
||||
|
||||
## Overview
|
||||
|
||||
The provisioning platform uses a **four-stage configuration workflow** that leverages TypeDialog for interactive configuration,
|
||||
Nickel for type-safe composition, and TOML for service consumption:
|
||||
The provisioning platform uses a **four-stage configuration workflow** that leverages TypeDialog for interactive configuration, Nickel for type-safe composition, and TOML for service consumption:
|
||||
|
||||
```plaintext
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────────┐
|
||||
│ Stage 1: User Interaction (TypeDialog) │
|
||||
│ - Can use Nickel configuration as default values │
|
||||
@ -420,7 +419,7 @@ level = "debug"
|
||||
|
||||
### Output Location
|
||||
|
||||
```plaintext
|
||||
```
|
||||
provisioning/platform/config/
|
||||
├── orchestrator.solo.toml # Exported from configs/orchestrator.solo.ncl
|
||||
├── orchestrator.multiuser.toml # Exported from configs/orchestrator.multiuser.ncl
|
||||
@ -802,7 +801,7 @@ ORCHESTRATOR_CONFIG=provisioning/platform/config/orchestrator.solo.toml cargo ru
|
||||
|
||||
### Component Interactions
|
||||
|
||||
```plaintext
|
||||
```
|
||||
TypeDialog Forms Nickel Schemas
|
||||
(forms/*.toml) ←shares→ (schemas/*.ncl)
|
||||
│ │
|
||||
|
||||
@ -16,7 +16,7 @@ These constraints are used by:
|
||||
|
||||
## File Structure
|
||||
|
||||
```plaintext
|
||||
```
|
||||
constraints/
|
||||
└── constraints.toml # All validation constraints in TOML format
|
||||
```
|
||||
@ -26,7 +26,6 @@ constraints/
|
||||
### 1. Define Constraint
|
||||
|
||||
**constraints.toml**:
|
||||
|
||||
```toml
|
||||
[orchestrator.queue.concurrent_tasks]
|
||||
min = 1
|
||||
@ -36,7 +35,6 @@ max = 100
|
||||
### 2. Reference in Validator
|
||||
|
||||
**validators/orchestrator-validator.ncl**:
|
||||
|
||||
```nickel
|
||||
let constraints = import "../constraints/constraints.toml" in
|
||||
|
||||
@ -54,7 +52,6 @@ let constraints = import "../constraints/constraints.toml" in
|
||||
### 3. Reference in Form
|
||||
|
||||
**forms/fragments/orchestrator-queue-section.toml**:
|
||||
|
||||
```toml
|
||||
[[elements]]
|
||||
name = "max_concurrent_tasks"
|
||||
@ -110,7 +107,6 @@ When changing constraint bounds:
|
||||
### Example: Increase Max Queue Tasks
|
||||
|
||||
**Before**:
|
||||
|
||||
```toml
|
||||
[orchestrator.queue.concurrent_tasks]
|
||||
min = 1
|
||||
@ -118,7 +114,6 @@ max = 100
|
||||
```
|
||||
|
||||
**After**:
|
||||
|
||||
```toml
|
||||
[orchestrator.queue.concurrent_tasks]
|
||||
min = 1
|
||||
|
||||
@ -12,7 +12,7 @@ Defaults provide:
|
||||
|
||||
## File Organization
|
||||
|
||||
```plaintext
|
||||
```
|
||||
defaults/
|
||||
├── README.md # This file
|
||||
├── common/ # Shared defaults
|
||||
@ -36,7 +36,7 @@ defaults/
|
||||
|
||||
Configuration is built from layers:
|
||||
|
||||
```plaintext
|
||||
```
|
||||
Base Defaults (service-defaults.ncl)
|
||||
↓
|
||||
+ Mode Overlay (deployment/{mode}-defaults.ncl)
|
||||
@ -49,7 +49,6 @@ Base Defaults (service-defaults.ncl)
|
||||
```
|
||||
|
||||
Example:
|
||||
|
||||
```nickel
|
||||
# configs/orchestrator.solo.ncl
|
||||
let defaults = import "../defaults/orchestrator-defaults.ncl" in
|
||||
@ -69,7 +68,6 @@ let solo_defaults = import "../defaults/deployment/solo-defaults.ncl" in
|
||||
### 1. Service Base Defaults
|
||||
|
||||
**orchestrator-defaults.ncl**:
|
||||
|
||||
```nickel
|
||||
{
|
||||
orchestrator = {
|
||||
@ -99,7 +97,6 @@ let solo_defaults = import "../defaults/deployment/solo-defaults.ncl" in
|
||||
### 2. Mode-Specific Overrides
|
||||
|
||||
**deployment/solo-defaults.ncl**:
|
||||
|
||||
```nickel
|
||||
{
|
||||
resources = {
|
||||
@ -117,7 +114,6 @@ let solo_defaults = import "../defaults/deployment/solo-defaults.ncl" in
|
||||
```
|
||||
|
||||
**deployment/enterprise-defaults.ncl**:
|
||||
|
||||
```nickel
|
||||
{
|
||||
resources = {
|
||||
@ -138,7 +134,6 @@ let solo_defaults = import "../defaults/deployment/solo-defaults.ncl" in
|
||||
## Common Defaults
|
||||
|
||||
### server-defaults.ncl
|
||||
|
||||
```nickel
|
||||
{
|
||||
server = {
|
||||
@ -152,7 +147,6 @@ let solo_defaults = import "../defaults/deployment/solo-defaults.ncl" in
|
||||
```
|
||||
|
||||
### database-defaults.ncl
|
||||
|
||||
```nickel
|
||||
{
|
||||
database = {
|
||||
@ -165,7 +159,6 @@ let solo_defaults = import "../defaults/deployment/solo-defaults.ncl" in
|
||||
```
|
||||
|
||||
### security-defaults.ncl
|
||||
|
||||
```nickel
|
||||
{
|
||||
security = {
|
||||
@ -179,7 +172,6 @@ let solo_defaults = import "../defaults/deployment/solo-defaults.ncl" in
|
||||
```
|
||||
|
||||
### monitoring-defaults.ncl
|
||||
|
||||
```nickel
|
||||
{
|
||||
monitoring = {
|
||||
@ -226,7 +218,6 @@ let solo_defaults = import "../defaults/deployment/solo-defaults.ncl" in
|
||||
### Changing a Base Default
|
||||
|
||||
**orchestrator-defaults.ncl**:
|
||||
|
||||
```nickel
|
||||
# Before
|
||||
queue = {
|
||||
@ -247,7 +238,6 @@ queue = {
|
||||
### Changing Mode Override
|
||||
|
||||
**deployment/solo-defaults.ncl**:
|
||||
|
||||
```nickel
|
||||
# Before
|
||||
orchestrator = {
|
||||
|
||||
@ -68,7 +68,6 @@ nickel export --format toml full-platform-enterprise.ncl > platform.toml
|
||||
- No audit logging
|
||||
|
||||
**Usage**:
|
||||
|
||||
```bash
|
||||
# Export to TOML and run
|
||||
nickel export --format toml orchestrator-solo.ncl > orchestrator.solo.toml
|
||||
@ -79,7 +78,6 @@ nu ../../scripts/configure.nu orchestrator solo --backend cli
|
||||
```
|
||||
|
||||
**Customization Examples**:
|
||||
|
||||
```nickel
|
||||
# Increase concurrency for testing (still development-friendly)
|
||||
queue.max_concurrent_tasks = 5
|
||||
@ -143,14 +141,12 @@ workspace.path = "/path/to/my/workspace"
|
||||
- Network isolation and load balancing setup required
|
||||
|
||||
**Environment Variables Required**:
|
||||
|
||||
```bash
|
||||
export JWT_SECRET="<secure-random-256-bit-string>"
|
||||
export SURREALDB_PASSWORD="<database-password>"
|
||||
```
|
||||
|
||||
**Usage**:
|
||||
|
||||
```bash
|
||||
# Deploy standalone with SurrealDB
|
||||
nickel export --format toml orchestrator-enterprise.ncl > orchestrator.enterprise.toml
|
||||
@ -162,7 +158,6 @@ kubectl apply -f provisioning/platform/infrastructure/kubernetes/*.yaml
|
||||
```
|
||||
|
||||
**Customization Examples**:
|
||||
|
||||
```nickel
|
||||
# Adjust concurrency for your specific infrastructure
|
||||
queue.max_concurrent_tasks = 50 # Scale down if resource-constrained
|
||||
@ -227,14 +222,12 @@ security.rate_limit.requests_per_second = 20000
|
||||
- RBAC requires careful role definition
|
||||
|
||||
**Environment Variables Required**:
|
||||
|
||||
```bash
|
||||
export DB_PASSWORD="<postgresql-password>"
|
||||
export JWT_SECRET="<secure-random-string>"
|
||||
```
|
||||
|
||||
**Usage**:
|
||||
|
||||
```bash
|
||||
# Generate and deploy
|
||||
nickel export --format toml control-center-multiuser.ncl > control-center.multiuser.toml
|
||||
@ -249,16 +242,14 @@ docker-compose -f docker-compose.multiuser.yml up -d
|
||||
```
|
||||
|
||||
**RBAC Quick Reference**:
|
||||
|
||||
| Role | Intended Users | Key Permissions |
|
||||
| ------ | ---------------- | ----------------- |
|
||||
|------|----------------|-----------------|
|
||||
| admin | Infrastructure leads | All operations: full access |
|
||||
| operator | Operations engineers | Execute workflows, manage tasks, view policies |
|
||||
| developer | Application developers | View workflows, view policies (read-only) |
|
||||
| viewer | Non-technical (PM, QA) | View workflows only (minimal read) |
|
||||
|
||||
**Customization Examples**:
|
||||
|
||||
```nickel
|
||||
# Require MFA globally for higher security
|
||||
mfa.required = true
|
||||
@ -321,7 +312,6 @@ policies.password = {
|
||||
- 100 RPS rate limiting with 20-request burst
|
||||
|
||||
**Global Configuration**:
|
||||
|
||||
```nickel
|
||||
let deployment_mode = "enterprise"
|
||||
let namespace = "provisioning"
|
||||
@ -366,7 +356,6 @@ let environment = "production"
|
||||
- Network setup complexity (TLS, CORS, rate limiting)
|
||||
|
||||
**Environment Variables Required**:
|
||||
|
||||
```bash
|
||||
# Database credentials
|
||||
export DB_PASSWORD="<postgresql-password>"
|
||||
@ -386,8 +375,7 @@ export TLS_KEY="<key-path>"
|
||||
```
|
||||
|
||||
**Architecture Diagram**:
|
||||
|
||||
```plaintext
|
||||
```
|
||||
┌───────────────────────────────────────────────┐
|
||||
│ Nginx Load Balancer (TLS, CORS, RateLimit) │
|
||||
│ https://orchestrator.example.com │
|
||||
@ -416,7 +404,6 @@ export TLS_KEY="<key-path>"
|
||||
```
|
||||
|
||||
**Usage**:
|
||||
|
||||
```bash
|
||||
# Export complete configuration
|
||||
nickel export --format toml full-platform-enterprise.ncl > platform.toml
|
||||
@ -437,7 +424,6 @@ docker-compose -f docker-compose.enterprise.yml up -d
|
||||
```
|
||||
|
||||
**Customization Examples**:
|
||||
|
||||
```nickel
|
||||
# Adjust deployment domain
|
||||
let domain = "my-company.com"
|
||||
@ -464,7 +450,7 @@ mcp_server.performance.cache_ttl = 7200
|
||||
## Deployment Mode Comparison Matrix
|
||||
|
||||
| Feature | Solo | MultiUser | Enterprise |
|
||||
| --------- | ------ | ----------- | ----------- |
|
||||
|---------|------|-----------|-----------|
|
||||
| **Ideal For** | Dev | Team/Staging | Production |
|
||||
| **Storage** | Filesystem | PostgreSQL | SurrealDB Cluster |
|
||||
| **Replicas** | 1 | 1 | 3+ (HA) |
|
||||
@ -629,7 +615,6 @@ ORCHESTRATOR_CONFIG=orchestrator.solo.toml timeout 5 cargo run --bin orchestrato
|
||||
### Port Already in Use
|
||||
|
||||
**Fix**: Change the port in your configuration:
|
||||
|
||||
```nickel
|
||||
server.port = 9999 # Instead of 9090
|
||||
```
|
||||
@ -645,7 +630,6 @@ server.port = 9999 # Instead of 9090
|
||||
### Import Not Found
|
||||
|
||||
**Fix**: Ensure all relative paths in imports are correct:
|
||||
|
||||
```nickel
|
||||
# Correct (relative to examples/)
|
||||
let defaults = import "../defaults/orchestrator-defaults.ncl" in
|
||||
@ -712,13 +696,11 @@ nickel export --format toml orchestrator-custom.ncl > orchestrator.custom.toml
|
||||
## Using Examples
|
||||
|
||||
### View Example
|
||||
|
||||
```bash
|
||||
cat provisioning/.typedialog/provisioning/platform/examples/orchestrator-solo.ncl
|
||||
```
|
||||
|
||||
### Copy and Customize
|
||||
|
||||
```bash
|
||||
# Start with solo example
|
||||
cp examples/orchestrator-solo.ncl values/orchestrator.solo.ncl
|
||||
@ -731,7 +713,6 @@ nu scripts/validate-config.nu values/orchestrator.solo.ncl
|
||||
```
|
||||
|
||||
### Generate from Example
|
||||
|
||||
```bash
|
||||
# Use example as base, regenerate with TypeDialog
|
||||
nu scripts/configure.nu orchestrator solo --backend web
|
||||
@ -788,13 +769,11 @@ Each example is a complete Nickel configuration:
|
||||
## Creating New Examples
|
||||
|
||||
### 1. Start with Existing Example
|
||||
|
||||
```bash
|
||||
cp examples/orchestrator-solo.ncl examples/orchestrator-custom.ncl
|
||||
```
|
||||
|
||||
### 2. Modify for Your Use Case
|
||||
|
||||
```toml
|
||||
# Update configuration values
|
||||
orchestrator.server.workers = 8 # More workers
|
||||
@ -802,7 +781,6 @@ orchestrator.queue.max_concurrent_tasks = 20 # Higher concurrency
|
||||
```
|
||||
|
||||
### 3. Validate Configuration
|
||||
|
||||
```bash
|
||||
nickel typecheck examples/orchestrator-custom.ncl
|
||||
nickel eval examples/orchestrator-custom.ncl
|
||||
@ -816,7 +794,6 @@ Add comments explaining:
|
||||
- Customization needed
|
||||
|
||||
### 5. Save as Reference
|
||||
|
||||
```bash
|
||||
mv examples/orchestrator-custom.ncl examples/orchestrator-{scenario}.ncl
|
||||
```
|
||||
|
||||
@ -12,7 +12,7 @@ Schemas define:
|
||||
|
||||
## File Organization
|
||||
|
||||
```plaintext
|
||||
```
|
||||
schemas/
|
||||
├── README.md # This file
|
||||
├── common/ # Shared schemas (server, database, security, etc.)
|
||||
@ -138,7 +138,6 @@ Log configuration:
|
||||
|
||||
### orchestrator.ncl
|
||||
Workflow orchestration:
|
||||
|
||||
```nickel
|
||||
OrchestratorConfig = {
|
||||
workspace | WorkspaceConfig,
|
||||
@ -154,7 +153,6 @@ OrchestratorConfig = {
|
||||
|
||||
### control-center.ncl
|
||||
Policy and RBAC:
|
||||
|
||||
```nickel
|
||||
ControlCenterConfig = {
|
||||
workspace | WorkspaceConfig,
|
||||
@ -168,7 +166,6 @@ ControlCenterConfig = {
|
||||
|
||||
### mcp-server.ncl
|
||||
MCP protocol server:
|
||||
|
||||
```nickel
|
||||
MCPServerConfig = {
|
||||
workspace | WorkspaceConfig,
|
||||
@ -189,7 +186,6 @@ Deployment schemas define resource constraints for each mode:
|
||||
- **enterprise.ncl** - 16+ CPU, 32+ GB RAM, HA
|
||||
|
||||
Example:
|
||||
|
||||
```nickel
|
||||
# schemas/deployment/solo.ncl
|
||||
{
|
||||
|
||||
@ -12,7 +12,7 @@ Templates provide:
|
||||
|
||||
## File Organization
|
||||
|
||||
```plaintext
|
||||
```
|
||||
templates/
|
||||
├── README.md # This file
|
||||
├── orchestrator-config.ncl.j2 # Nickel output template (Jinja2)
|
||||
@ -133,7 +133,6 @@ typedialog-web nickel-roundtrip "$CONFIG" "forms/{service}-form.toml" --output "
|
||||
### Key Jinja2 Patterns
|
||||
|
||||
**Conditional blocks** (only include if field is set):
|
||||
|
||||
```nickel
|
||||
{%- if workspace_name %}
|
||||
name = "{{ workspace_name }}",
|
||||
@ -141,7 +140,6 @@ name = "{{ workspace_name }}",
|
||||
```
|
||||
|
||||
**String values** (with quotes):
|
||||
|
||||
```nickel
|
||||
{%- if storage_backend %}
|
||||
backend = '{{ storage_backend }}, # Enum (atom syntax)
|
||||
@ -149,7 +147,6 @@ backend = '{{ storage_backend }}, # Enum (atom syntax)
|
||||
```
|
||||
|
||||
**Numeric values** (no quotes):
|
||||
|
||||
```nickel
|
||||
{%- if server_port %}
|
||||
port = {{ server_port }}, # Number
|
||||
@ -157,7 +154,6 @@ port = {{ server_port }}, # Number
|
||||
```
|
||||
|
||||
**Boolean values** (lower case):
|
||||
|
||||
```nickel
|
||||
{%- if workspace_enabled is defined %}
|
||||
enabled = {{ workspace_enabled | lower }}, # Boolean (true/false)
|
||||
@ -165,7 +161,6 @@ enabled = {{ workspace_enabled | lower }}, # Boolean (true/false)
|
||||
```
|
||||
|
||||
**Comments** (for generated files):
|
||||
|
||||
```nickel
|
||||
# Auto-generated by provisioning TypeDialog
|
||||
# Edit via: nu scripts/configure.nu orchestrator {mode}
|
||||
@ -300,19 +295,16 @@ let config = import "../../values/orchestrator.solo.ncl" in
|
||||
## Rendering Templates
|
||||
|
||||
### Render to JSON
|
||||
|
||||
```bash
|
||||
nickel export --format json templates/orchestrator-config.ncl.j2 > config.json
|
||||
```
|
||||
|
||||
### Render to YAML (via yq)
|
||||
|
||||
```bash
|
||||
nickel export --format json templates/kubernetes/orchestrator-deployment.yaml.ncl | yq -P > deployment.yaml
|
||||
```
|
||||
|
||||
### Render to TOML
|
||||
|
||||
```bash
|
||||
nickel export --format toml templates/configs/orchestrator-config.toml.ncl > config.toml
|
||||
```
|
||||
|
||||
@ -158,7 +158,6 @@ max_connections = 512
|
||||
### Database Configuration (Control Center)
|
||||
|
||||
**RocksDB** (solo, cicd modes):
|
||||
|
||||
```toml
|
||||
[database]
|
||||
backend = "rocksdb"
|
||||
@ -171,7 +170,6 @@ compression = "snappy"
|
||||
```
|
||||
|
||||
**PostgreSQL** (multiuser, enterprise modes):
|
||||
|
||||
```toml
|
||||
[database]
|
||||
backend = "postgres"
|
||||
@ -188,7 +186,6 @@ ssl_mode = "require"
|
||||
### Storage Configuration (Orchestrator)
|
||||
|
||||
**Filesystem** (solo, cicd modes):
|
||||
|
||||
```toml
|
||||
[storage]
|
||||
backend = "filesystem"
|
||||
@ -196,7 +193,6 @@ path = "/var/lib/provisioning/orchestrator/data"
|
||||
```
|
||||
|
||||
**SurrealDB Server** (multiuser mode):
|
||||
|
||||
```toml
|
||||
[storage]
|
||||
backend = "surrealdb_server"
|
||||
@ -206,7 +202,6 @@ surrealdb_database = "orchestrator"
|
||||
```
|
||||
|
||||
**SurrealDB Cluster** (enterprise mode):
|
||||
|
||||
```toml
|
||||
[storage]
|
||||
backend = "surrealdb_cluster"
|
||||
|
||||
@ -4,8 +4,7 @@ Nickel-based Docker Compose templates for deploying platform services across all
|
||||
|
||||
## Overview
|
||||
|
||||
This directory contains Nickel templates that generate Docker Compose files for different deployment scenarios.
|
||||
Each template imports configuration from `values/*.ncl` and expands to valid Docker Compose YAML.
|
||||
This directory contains Nickel templates that generate Docker Compose files for different deployment scenarios. Each template imports configuration from `values/*.ncl` and expands to valid Docker Compose YAML.
|
||||
|
||||
**Key Pattern**: Templates use **Nickel composition** to build service definitions dynamically based on configuration, allowing parameterized infrastructure-as-code.
|
||||
|
||||
@ -37,7 +36,6 @@ Each template imports configuration from `values/*.ncl` and expands to valid Doc
|
||||
- Restart Policy: `unless-stopped` (survives host reboot)
|
||||
|
||||
**Usage**:
|
||||
|
||||
```bash
|
||||
# Generate from Nickel template
|
||||
nickel export --format json platform-stack.solo.yml.ncl | yq -P > docker-compose.solo.yml
|
||||
@ -53,7 +51,6 @@ docker-compose -f docker-compose.solo.yml down
|
||||
```
|
||||
|
||||
**Environment Variables** (recommended in `.env` file):
|
||||
|
||||
```bash
|
||||
ORCHESTRATOR_LOG_LEVEL=debug
|
||||
CONTROL_CENTER_LOG_LEVEL=info
|
||||
@ -99,7 +96,6 @@ MCP_SERVER_LOG_LEVEL=info
|
||||
- Logging: JSON format with rotation
|
||||
|
||||
**Usage**:
|
||||
|
||||
```bash
|
||||
# Generate from Nickel template
|
||||
nickel export --format json platform-stack.multiuser.yml.ncl | yq -P > docker-compose.multiuser.yml
|
||||
@ -122,7 +118,6 @@ docker-compose exec postgres psql -U postgres -c "CREATE DATABASE provisioning;"
|
||||
```
|
||||
|
||||
**Database Initialization**:
|
||||
|
||||
```bash
|
||||
# Connect to PostgreSQL for schema creation
|
||||
docker-compose exec postgres psql -U provisioning -d provisioning
|
||||
@ -135,7 +130,6 @@ docker-compose exec surrealdb surreal sql --auth root:password
|
||||
```
|
||||
|
||||
**Environment Variables** (in `.env.multiuser`):
|
||||
|
||||
```bash
|
||||
# Database Credentials (CRITICAL - change before production)
|
||||
DB_PASSWORD=your-strong-password
|
||||
@ -184,7 +178,6 @@ GITEA_ROOT_URL=http://localhost:3000/
|
||||
- **Low Resource**: Minimal memory/CPU footprint
|
||||
|
||||
**Usage**:
|
||||
|
||||
```bash
|
||||
# Generate from Nickel template
|
||||
nickel export --format json platform-stack.cicd.yml.ncl | yq -P > docker-compose.cicd.yml
|
||||
@ -204,7 +197,6 @@ docker-compose -f docker-compose.cicd.yml down -v
|
||||
```
|
||||
|
||||
**CI/CD Integration Example**:
|
||||
|
||||
```bash
|
||||
# GitHub Actions workflow
|
||||
- name: Start Provisioning Stack
|
||||
@ -221,7 +213,6 @@ docker-compose -f docker-compose.cicd.yml down -v
|
||||
```
|
||||
|
||||
**Environment Variables** (minimal):
|
||||
|
||||
```bash
|
||||
# Logging (optional)
|
||||
ORCHESTRATOR_LOG_LEVEL=warn
|
||||
@ -274,8 +265,7 @@ ORCHESTRATOR_LOG_LEVEL=warn
|
||||
- Logging: JSON format with 500MB files, kept 30 versions
|
||||
|
||||
**Architecture**:
|
||||
|
||||
```plaintext
|
||||
```
|
||||
┌──────────────────────┐
|
||||
│ External Client │
|
||||
│ (HTTPS, Port 443) │
|
||||
@ -309,7 +299,6 @@ Observability Stack:
|
||||
```
|
||||
|
||||
**Usage**:
|
||||
|
||||
```bash
|
||||
# Generate from Nickel template
|
||||
nickel export --format json platform-stack.enterprise.yml.ncl | yq -P > docker-compose.enterprise.yml
|
||||
@ -363,7 +352,6 @@ curl -H "Host: orchestrator.example.com" http://localhost/health
|
||||
- [ ] Configure external log aggregation (ELK stack, Splunk, etc.)
|
||||
|
||||
**Environment Variables** (in `.env.enterprise`):
|
||||
|
||||
```bash
|
||||
# Database Credentials (CRITICAL)
|
||||
DB_PASSWORD=your-strong-password-32-chars-min
|
||||
@ -546,7 +534,6 @@ docker logs -f $(docker ps | grep orchestrator | awk '{print $1}')
|
||||
**Error**: `bind: address already in use`
|
||||
|
||||
**Fix**: Change port in template or stop conflicting container:
|
||||
|
||||
```bash
|
||||
# Find process using port
|
||||
lsof -i :9090
|
||||
@ -562,7 +549,6 @@ ports:
|
||||
### Service Fails to Start
|
||||
|
||||
**Check logs**:
|
||||
|
||||
```bash
|
||||
docker-compose logs orchestrator
|
||||
```
|
||||
@ -577,7 +563,6 @@ docker-compose logs orchestrator
|
||||
### Persistent Volume Issues
|
||||
|
||||
**Clean volumes** (WARNING: Deletes data):
|
||||
|
||||
```bash
|
||||
docker-compose down -v
|
||||
docker volume prune -f
|
||||
|
||||
@ -221,7 +221,6 @@ kubectl describe service orchestrator -n provisioning
|
||||
### Required ConfigMaps
|
||||
|
||||
#### orchestrator-config
|
||||
|
||||
```yaml
|
||||
apiVersion: v1
|
||||
kind: ConfigMap
|
||||
@ -236,7 +235,6 @@ data:
|
||||
```
|
||||
|
||||
#### control-center-config
|
||||
|
||||
```yaml
|
||||
apiVersion: v1
|
||||
kind: ConfigMap
|
||||
@ -253,7 +251,6 @@ data:
|
||||
```
|
||||
|
||||
#### mcp-server-config
|
||||
|
||||
```yaml
|
||||
apiVersion: v1
|
||||
kind: ConfigMap
|
||||
@ -275,7 +272,6 @@ data:
|
||||
### Required Secrets
|
||||
|
||||
#### control-center-secrets
|
||||
|
||||
```yaml
|
||||
apiVersion: v1
|
||||
kind: Secret
|
||||
|
||||
@ -101,8 +101,7 @@ ORCHESTRATOR_CONFIG=provisioning/platform/config/orchestrator.solo.toml cargo ru
|
||||
```
|
||||
|
||||
**Expected Output**:
|
||||
|
||||
```plaintext
|
||||
```
|
||||
[INFO] Orchestrator starting...
|
||||
[INFO] Server listening on 127.0.0.1:9090
|
||||
[INFO] Storage backend: filesystem
|
||||
@ -128,7 +127,6 @@ curl -X POST http://localhost:9090/api/workflows \
|
||||
To change configuration:
|
||||
|
||||
**Option A: Re-run Interactive Form**
|
||||
|
||||
```bash
|
||||
cd provisioning/.typedialog/provisioning/platform
|
||||
nu scripts/configure.nu orchestrator solo --backend cli
|
||||
@ -138,7 +136,6 @@ nu scripts/generate-configs.nu orchestrator solo
|
||||
```
|
||||
|
||||
**Option B: Edit TOML Directly**
|
||||
|
||||
```bash
|
||||
# Edit the file directly
|
||||
vi provisioning/platform/config/orchestrator.solo.toml
|
||||
@ -147,7 +144,6 @@ vi provisioning/platform/config/orchestrator.solo.toml
|
||||
```
|
||||
|
||||
**Option C: Environment Variable Override**
|
||||
|
||||
```bash
|
||||
# No file changes needed
|
||||
export ORCHESTRATOR_SERVER_PORT=9999
|
||||
@ -219,7 +215,6 @@ docker-compose -f provisioning/platform/infrastructure/docker/docker-compose.mul
|
||||
```
|
||||
|
||||
**Verify Services**:
|
||||
|
||||
```bash
|
||||
# Check all services are running
|
||||
docker-compose -f provisioning/platform/infrastructure/docker/docker-compose.multiuser.yml ps
|
||||
@ -471,7 +466,6 @@ kubectl apply -f provisioning/platform/infrastructure/kubernetes/prometheus-aler
|
||||
### Change Configuration Value
|
||||
|
||||
**Without Service Restart** (Environment Variable):
|
||||
|
||||
```bash
|
||||
# Override specific value via environment variable
|
||||
export ORCHESTRATOR_LOG_LEVEL=debug
|
||||
@ -482,7 +476,6 @@ ORCHESTRATOR_CONFIG=config.toml cargo run --bin orchestrator
|
||||
```
|
||||
|
||||
**With Service Restart** (TOML Edit):
|
||||
|
||||
```bash
|
||||
# Edit TOML directly
|
||||
vi provisioning/platform/config/orchestrator.solo.toml
|
||||
@ -493,7 +486,6 @@ ORCHESTRATOR_CONFIG=config.toml cargo run --bin orchestrator
|
||||
```
|
||||
|
||||
**With Validation** (Regenerate from Form):
|
||||
|
||||
```bash
|
||||
# Re-run interactive form to regenerate
|
||||
cd provisioning/.typedialog/provisioning/platform
|
||||
@ -508,7 +500,6 @@ nu scripts/generate-configs.nu orchestrator solo
|
||||
### Add Team Member
|
||||
|
||||
**In Kubernetes PostgreSQL**:
|
||||
|
||||
```bash
|
||||
kubectl exec -it -n provisioning deployment/postgres -- psql -U provisioning -d provisioning
|
||||
|
||||
@ -524,7 +515,6 @@ INSERT INTO role_assignments (user_id, role, granted_by, granted_at) VALUES
|
||||
### Scale Service Replicas
|
||||
|
||||
**In Kubernetes**:
|
||||
|
||||
```bash
|
||||
# Scale orchestrator from 3 to 5 replicas
|
||||
kubectl scale deployment orchestrator -n provisioning --replicas=5
|
||||
@ -588,7 +578,7 @@ ORCHESTRATOR_CONFIG=config.toml cargo run --bin orchestrator 2>&1 | grep -i "con
|
||||
|
||||
## Configuration File Locations
|
||||
|
||||
```plaintext
|
||||
```
|
||||
provisioning/.typedialog/provisioning/platform/
|
||||
├── forms/ # User-facing interactive forms
|
||||
│ ├── orchestrator-form.toml
|
||||
@ -638,8 +628,7 @@ provisioning/.typedialog/provisioning/platform/
|
||||
```
|
||||
|
||||
TOML output location:
|
||||
|
||||
```plaintext
|
||||
```
|
||||
provisioning/platform/config/
|
||||
├── orchestrator.solo.toml # Consumed by orchestrator service
|
||||
├── control-center.enterprise.toml # Consumed by control-center service
|
||||
|
||||
@ -12,7 +12,7 @@ Validators provide:
|
||||
|
||||
## File Organization
|
||||
|
||||
```plaintext
|
||||
```
|
||||
validators/
|
||||
├── README.md # This file
|
||||
├── common-validator.ncl # Ports, positive numbers, strings
|
||||
@ -94,7 +94,6 @@ ValidRange = fun min max value =>
|
||||
## Common Validators
|
||||
|
||||
### common-validator.ncl
|
||||
|
||||
```nickel
|
||||
let constraints = import "../constraints/constraints.toml" in
|
||||
|
||||
@ -124,7 +123,6 @@ let constraints = import "../constraints/constraints.toml" in
|
||||
```
|
||||
|
||||
### resource-validator.ncl
|
||||
|
||||
```nickel
|
||||
let constraints = import "../constraints/constraints.toml" in
|
||||
let common = import "./common-validator.ncl" in
|
||||
@ -145,7 +143,6 @@ let common = import "./common-validator.ncl" in
|
||||
## Service-Specific Validators
|
||||
|
||||
### orchestrator-validator.ncl
|
||||
|
||||
```nickel
|
||||
let constraints = import "../constraints/constraints.toml" in
|
||||
let common = import "./common-validator.ncl" in
|
||||
@ -181,7 +178,6 @@ let common = import "./common-validator.ncl" in
|
||||
```
|
||||
|
||||
### control-center-validator.ncl
|
||||
|
||||
```nickel
|
||||
{
|
||||
# JWT token expiration
|
||||
@ -199,7 +195,6 @@ let common = import "./common-validator.ncl" in
|
||||
```
|
||||
|
||||
### mcp-server-validator.ncl
|
||||
|
||||
```nickel
|
||||
{
|
||||
# Max concurrent tool executions
|
||||
@ -286,7 +281,6 @@ nickel export --format toml provisioning/.typedialog/provisioning/platform/confi
|
||||
## Adding a New Validator
|
||||
|
||||
1. **Create validator function** in appropriate file:
|
||||
|
||||
```nickel
|
||||
ValidMyValue = fun value =>
|
||||
if value < minimum then error "Too low"
|
||||
@ -295,7 +289,6 @@ nickel export --format toml provisioning/.typedialog/provisioning/platform/confi
|
||||
```
|
||||
|
||||
2. **Add constraint** to constraints.toml if needed:
|
||||
|
||||
```toml
|
||||
[service.feature.my_value]
|
||||
min = 1
|
||||
@ -303,13 +296,11 @@ nickel export --format toml provisioning/.typedialog/provisioning/platform/confi
|
||||
```
|
||||
|
||||
3. **Use in config**:
|
||||
|
||||
```nickel
|
||||
my_value = validators.ValidMyValue 50,
|
||||
```
|
||||
|
||||
4. **Add form constraint** (if interactive):
|
||||
|
||||
```toml
|
||||
[[elements]]
|
||||
name = "my_value"
|
||||
@ -318,7 +309,6 @@ nickel export --format toml provisioning/.typedialog/provisioning/platform/confi
|
||||
```
|
||||
|
||||
5. **Test**:
|
||||
|
||||
```bash
|
||||
nickel typecheck configs/service.mode.ncl
|
||||
```
|
||||
|
||||
@ -12,7 +12,7 @@ The values directory stores:
|
||||
|
||||
## File Organization
|
||||
|
||||
```plaintext
|
||||
```
|
||||
values/
|
||||
├── .gitignore # Ignore *.ncl user configs
|
||||
├── README.md # This file
|
||||
@ -44,7 +44,6 @@ Each config file (`{service}.{mode}.ncl`) is:
|
||||
- **Runtime data** - Created/updated by scripts and forms
|
||||
|
||||
Example:
|
||||
|
||||
```nickel
|
||||
# values/orchestrator.solo.ncl (auto-generated, user-editable)
|
||||
{
|
||||
@ -69,7 +68,7 @@ Example:
|
||||
|
||||
## .gitignore Pattern
|
||||
|
||||
```plaintext
|
||||
```
|
||||
# values/.gitignore
|
||||
*.ncl # Ignore all Nickel config files (user-specific)
|
||||
!*.example.ncl # EXCEPT example files (tracked for documentation)
|
||||
@ -151,7 +150,6 @@ This ensures:
|
||||
## Configuration Workflow
|
||||
|
||||
### 1. Generate Initial Config
|
||||
|
||||
```bash
|
||||
nu scripts/configure.nu orchestrator solo
|
||||
```
|
||||
@ -159,7 +157,6 @@ nu scripts/configure.nu orchestrator solo
|
||||
Creates `values/orchestrator.solo.ncl` from form input.
|
||||
|
||||
### 2. Edit Configuration
|
||||
|
||||
```bash
|
||||
# Manually edit if needed
|
||||
vi values/orchestrator.solo.ncl
|
||||
@ -169,13 +166,11 @@ nu scripts/configure.nu orchestrator solo --backend web
|
||||
```
|
||||
|
||||
### 3. Validate Configuration
|
||||
|
||||
```bash
|
||||
nu scripts/validate-config.nu values/orchestrator.solo.ncl
|
||||
```
|
||||
|
||||
### 4. Generate TOML for Services
|
||||
|
||||
```bash
|
||||
nu scripts/generate-configs.nu orchestrator solo
|
||||
```
|
||||
@ -186,7 +181,7 @@ Exports to `provisioning/platform/config/orchestrator.solo.toml` (consumed by Ru
|
||||
|
||||
User configs are composed with defaults during generation:
|
||||
|
||||
```plaintext
|
||||
```
|
||||
defaults/orchestrator-defaults.ncl (base values)
|
||||
↓ &
|
||||
values/orchestrator.solo.ncl (user customizations)
|
||||
@ -210,7 +205,6 @@ provisioning/platform/config/orchestrator.solo.toml (Rust service config)
|
||||
Since user configs are gitignored, sharing requires:
|
||||
|
||||
### Option 1: Share via File
|
||||
|
||||
```bash
|
||||
# Export current config
|
||||
cat values/orchestrator.solo.ncl > /tmp/orchestrator-config.ncl
|
||||
@ -221,7 +215,6 @@ cp /tmp/orchestrator-config.ncl values/orchestrator.solo.ncl
|
||||
|
||||
### Option 2: Use Example Template
|
||||
Share setup instructions instead of raw config:
|
||||
|
||||
```bash
|
||||
# Document the setup steps
|
||||
cat > SETUP.md << EOF
|
||||
@ -234,7 +227,6 @@ EOF
|
||||
|
||||
### Option 3: Store in Separate Repo
|
||||
For team configs, use a separate private repository:
|
||||
|
||||
```bash
|
||||
# Clone team configs
|
||||
git clone private-repo/provisioning-configs values/
|
||||
@ -257,19 +249,16 @@ chmod 600 values/orchestrator.solo.ncl
|
||||
If you accidentally delete a user config:
|
||||
|
||||
### Option 1: Regenerate from TypeDialog
|
||||
|
||||
```bash
|
||||
nu scripts/configure.nu orchestrator solo
|
||||
```
|
||||
|
||||
### Option 2: Copy from Backup
|
||||
|
||||
```bash
|
||||
cp /backup/provisioning-values/orchestrator.solo.ncl values/
|
||||
```
|
||||
|
||||
### Option 3: Use Example as Base
|
||||
|
||||
```bash
|
||||
cp examples/orchestrator-solo.ncl values/orchestrator.solo.ncl
|
||||
# Customize as needed
|
||||
@ -279,14 +268,12 @@ nu scripts/configure.nu orchestrator solo --backend web
|
||||
## Troubleshooting
|
||||
|
||||
### Config File Missing
|
||||
|
||||
```bash
|
||||
# Regenerate from defaults
|
||||
nu scripts/configure.nu orchestrator solo
|
||||
```
|
||||
|
||||
### Config Won't Validate
|
||||
|
||||
```bash
|
||||
# Check for syntax errors
|
||||
nickel eval values/orchestrator.solo.ncl
|
||||
@ -296,7 +283,6 @@ diff examples/orchestrator-solo.ncl values/orchestrator.solo.ncl
|
||||
```
|
||||
|
||||
### Changes Not Taking Effect
|
||||
|
||||
```bash
|
||||
# Regenerate TOML from Nickel
|
||||
nu scripts/generate-configs.nu orchestrator solo
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user