Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 11 additions & 3 deletions docs/proposals/20260608-dynamic-csi-mount.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,21 +2,23 @@
title: On-Demand CSI Volume Mount in Sandbox Runtime
authors:
- "@jicheng"
- "@mowangdk"
- "@ZeroCoder-dot"
reviewers:
- "@TBD"
creation-date: 2026-06-08
last-updated: 2026-06-08
last-updated: 2026-07-20
status: provisional
---

# On-Demand CSI Volume Mount in Sandbox Runtime

| Metadata | Details |
|----------|---------|
| **Author** | jicheng.sk <jicheng.sk@alibaba-inc.com> |
| **Authors** | jicheng.sk <jicheng.sk@alibaba-inc.com>, @mowangdk, @ZeroCoder-dot |
| **Status** | Provisional |
| **Created** | 2026-06-08 |
| **Updated** | 2026-06-08 |
| **Updated** | 2026-07-20 |
| **Related Components** | sandbox-manager, agent-sandbox-controller, agent-runtime |

## Table of Contents
Expand Down Expand Up @@ -147,6 +149,8 @@ therefore introduces a unified runtime-on-demand-mount design.

### Architecture Overview

**Component-level call flow** — the following mermaid diagram illustrates the control-plane to data-plane invocation chain and the persistence and restoration paths:

```mermaid

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

please:
The original struct should not be removed. We can provide a layered introduction: the original Mermaid diagram represents the component-level call flow and architecture, whereas the latest architecture diagram illustrates the sidecar relationships at the container runtime layer, including propagation paths and CSI mount locations.

flowchart TB
Comment on lines +152 to 155
subgraph CP[Control Plane: sandbox-manager]
Expand Down Expand Up @@ -178,6 +182,10 @@ flowchart TB
end
```

**Container runtime layer** — the diagram below zooms into the sandbox pod and illustrates the sidecar relationship, mount propagation paths, and where the CSI mount occurs:

![On-Demand CSI Mount Architecture](https://raw.githubusercontent.com/openkruise/openkruise.io/b59eace25e84b2c9c2fdb18a4796b27eb7cc2039/static/img/kruiseagents/on-demand-csi-mount-architecture.png)

### API Design

#### 1. User-facing API: `CSIMountConfig`
Expand Down
Loading