docs: simplify configuration resolution diagram
Signed-off-by: Hongsheng Liu <liuhongsheng4@huawei.com>
This commit is contained in:
1 parent
0104d4599c
commit
e9a833d82d
1 file changed
+13
-26
@@ -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:
|
||||||
|
|
||||||
|
|||||||
Reference in new issue
Block a user