Skip to content

History / deployment specification

Revisions

  • wiki: GET /api/runtime/shard-info diagnostic endpoint (Phase F R3b-1) Per wiki-maintenance.md Rule 2a, route + env docs land in lockstep with the code (noetl/server#46 + the v2.12.0 PR). - Sharding section gains a new "Diagnostic endpoint (Phase F R3b-1)" subsection with the route shape, response example, validation rules, and companion-endpoint context (gateway twin + integration test in ops). - Network surface row lists the new route alongside the existing /api/runtime/* paths. Refs noetl/ai-meta#49 Refs noetl/server#46

    @kadyapam kadyapam committed Jun 4, 2026
  • wiki: deployment-spec gains NOETL_SHARD_INDEX / NOETL_SHARD_COUNT (Phase F R2) Per wiki-maintenance.md Rule 2a, env var docs land in the same change set as the code (noetl/server#44 + the upcoming PR for v2.11.0). - NOETL_* table gains both vars with the *why* behind each. - New "## Sharding" section explains the default no-op behavior, enablement procedure for the Phase F R4+ cutover, and the routing key derivation (hash(execution_id) % N via twox-hash with fixed seed 0). Refs noetl/ai-meta#49 Refs noetl/server#44

    @kadyapam kadyapam committed Jun 4, 2026
  • wiki: deployment-specification page (Phase F R1.5 follow-up) Codifies the deployment shape for noetl-server: runtime contract, network surface, resources, health probes, FULL env-var catalogue with the why behind each one, secrets handling, observability hooks, kind-validation procedure. Captures the NOETL_SERVER_MACHINE_ID variable added in Phase F R1.5 (noetl/server#42) alongside the existing env surface that wasn't previously documented (NOETL_HOST, NOETL_PORT, NOETL_DEBUG, NOETL_ENCRYPTION_KEY, NOETL_INTERNAL_API_TOKEN, NOETL_PUBLIC_SERVER_URL, NOETL_DISABLE_METRICS, NOETL_AUTO_RECREATE_RUNTIME, NOETL_RUNTIME_SWEEP_INTERVAL, NOETL_RUNTIME_OFFLINE_SECONDS, NOETL_SCHEMA; POSTGRES_*; NATS_*; HOSTNAME / COMPUTERNAME / RUST_LOG). Sidebar gains an "Operations" section linking the new page; Home references it in the Pages list. Going forward this page is the single source of truth for env vars + ports + dependencies; any code change that touches std::env::var or envy::from_env must update it in the same change set per the new agents/rules/wiki-maintenance.md Rule 2a (landing separately on ai-meta). Refs noetl/ai-meta#49 Refs noetl/server#42

    @kadyapam kadyapam committed Jun 4, 2026