docs: simplify configuration resolution diagram

Signed-off-by: Hongsheng Liu <liuhongsheng4@huawei.com>
This commit is contained in:
Hongsheng Liu committed 2026-08-08 15:59:41 +08:00
1 parent 0104d4599c
commit e9a833d82d
1 file changed
+13 -26
+13 -26
View File
@@ -128,31 +128,18 @@ once into a complete, transport-safe configuration before runtime processes are
started. This keeps stage topology and model capabilities distinct from started. This keeps stage topology and model capabilities distinct from
deployment placement and from process-local engine objects. deployment placement and from process-local engine objects.
The figure shows only the primary hand-off object for each layer; the detailed
inputs, fields, and ownership rules are described below.
```mermaid ```mermaid
flowchart TB flowchart TB
subgraph authoring["Layer 1: Authoring inputs"] layer1["Layer 1 · Authoring inputs<br/>PipelineConfig + DeployConfig"]
pipeline["PipelineConfig<br/>frozen stage topology and execution types<br/>model capabilities and stage relationships"] layer2["Layer 2 · Resolve once<br/>OmniConfigResolveRequest<br/>resolve_omni_config()"]
deploy["DeployConfig<br/>placement, replicas, devices, and environment<br/>deploy-time defaults and connector definitions"] layer3["Layer 3 · Transport-safe control plane<br/>VllmOmniConfig"]
overrides["CLI / Python overrides"] layer4["Layer 4 · Runtime launch planning<br/>StageRuntime"]
metadata["HF or diffusion model metadata"] layer5["Layer 5 · Engine materialization<br/>VllmConfig / OmniDiffusionConfig"]
legacy["Legacy YAML adapter<br/>migration-only input; removed after model parity"]
end
request["Layer 2: OmniConfigResolveRequest"] layer1 --> layer2 --> layer3 --> layer4 --> layer5
resolve["resolve_omni_config()<br/>selects exactly one source path<br/>loads model metadata once<br/>applies precedence and stage overrides once<br/>resolves connectors, requests, runtime placement, and engine specs<br/>validates the complete pipeline"]
resolved["Layer 3: Resolved and transport-safe control-plane config<br/>VllmOmniConfig<br/>pipeline_config: PipelineConfig<br/>orchestrator_config: VllmOmniOrchestratorConfig<br/>stage_configs: tuple[VllmOmniStageConfig, ...]<br/>stage_pipeline_config · runtime_config · connector_config · request_config · engine_spec"]
launch["Layer 4: Runtime-only launch planning<br/>StageRuntime<br/>replica expansion · device allocation · local or remote launch<br/>ReplicaInitPlan remains private runtime state"]
materialize["Layer 5: Owning-process materialization<br/>materialize_engine_config(stage)"]
ar_config["VllmConfig<br/>vLLM-backed engine"]
diffusion_config["enriched OmniDiffusionConfig<br/>diffusion engine"]
authoring --> request
request --> resolve
resolve --> resolved
resolved --> launch
launch --> materialize
materialize --> ar_config
materialize --> diffusion_config
``` ```
The resolver names in this diagram describe the intended single resolution The resolver names in this diagram describe the intended single resolution
@@ -166,10 +153,10 @@ migrated to `PipelineConfig` and `DeployConfig`.
In the typed path, the common `VllmOmniStageConfig` slot in the In the typed path, the common `VllmOmniStageConfig` slot in the
diagram is realized by `VllmOmniARStageConfig`, diagram is realized by `VllmOmniARStageConfig`,
`VllmOmniGenerationStageConfig`, or `VllmOmniDiffusionStageConfig`. The `VllmOmniGenerationStageConfig`, or `VllmOmniDiffusionStageConfig`. The
diagram's request and engine-spec fields describe the control-plane boundary; request and engine-spec fields belong to the control-plane boundary; the
the current implementation stores their equivalent projections in the current implementation stores their equivalent projections in the structured
structured stage configuration and materializes backend-specific engine stage configuration and materializes backend-specific engine objects during
objects during stage initialization. stage initialization.
The important ownership rules are: The important ownership rules are: