From 7f0c589bff505763a08f8eee25f9b7e7b8de2827 Mon Sep 17 00:00:00 2001 From: Lyndon-Li Date: Fri, 25 Jul 2025 18:04:33 +0800 Subject: [PATCH 1/2] CSI snapshot data movement doc update for cancel enhancement Signed-off-by: Lyndon-Li --- site/content/docs/main/csi-snapshot-data-movement.md | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/site/content/docs/main/csi-snapshot-data-movement.md b/site/content/docs/main/csi-snapshot-data-movement.md index 544542e18..0d537a73a 100644 --- a/site/content/docs/main/csi-snapshot-data-movement.md +++ b/site/content/docs/main/csi-snapshot-data-movement.md @@ -303,16 +303,14 @@ kubectl -n velero get datadownloads -l velero.io/restore-name=YOUR_RESTORE_NAME ### Restart and resume When Velero server is restarted, if the resource backup/restore has completed, so the backup/restore has excceded `InProgress` status and is waiting for the completion of the data movements, Velero will recapture the status of the running data movements and resume the execution. -When node-agent is restarted, if the `DataUpload`/`DataDownload` is in `InProgress` status, Velero recaptures the status of the running data mover pod and resume the execution. -When node-agent is restarted, if the `DataUpload`/`DataDownload` is in `New` or `Prepared` status, the data mover pod has not started, Velero processes it as normal cases, or the restart doesn't affect the execution. +When node-agent is restarted, Velero tries to recapture the status of the running data movements and resume the execution; if the resume fails, the data movements are canceled. ### Cancellation At present, Velero backup and restore doesn't support end to end cancellation that is launched by users. However, Velero cancels the `DataUpload`/`DataDownload` in below scenarios automatically: - When Velero server is restarted and the backup/restore is in `InProgress` status -- When node-agent is restarted and the `DataUpload`/`DataDownload` is in `Accepted` status -- When node-agent is restarted and the resume of an existing `DataUpload`/`DataDownload` that is in `InProgress` status fails +- When node-agent is restarted and the resume of an existing `DataUpload`/`DataDownload` fails - When an ongoing backup/restore is deleted - When a backup/restore does not finish before the item operation timeout (default value is `4 hours`) From ea21a49636f306c969e8da66d64b3e672d93e641 Mon Sep 17 00:00:00 2001 From: Lyndon-Li Date: Fri, 25 Jul 2025 18:12:45 +0800 Subject: [PATCH 2/2] update CSI snapshot data movement doc for host path disable Signed-off-by: Lyndon-Li --- changelogs/unreleased/9113-Lyndon-Li | 1 + site/content/docs/main/csi-snapshot-data-movement.md | 5 +++-- 2 files changed, 4 insertions(+), 2 deletions(-) create mode 100644 changelogs/unreleased/9113-Lyndon-Li diff --git a/changelogs/unreleased/9113-Lyndon-Li b/changelogs/unreleased/9113-Lyndon-Li new file mode 100644 index 000000000..c000cfeb9 --- /dev/null +++ b/changelogs/unreleased/9113-Lyndon-Li @@ -0,0 +1 @@ +Update CSI Snapshot Data Movement doc for issue #8534, #8185 \ No newline at end of file diff --git a/site/content/docs/main/csi-snapshot-data-movement.md b/site/content/docs/main/csi-snapshot-data-movement.md index 0d537a73a..2b3d84d07 100644 --- a/site/content/docs/main/csi-snapshot-data-movement.md +++ b/site/content/docs/main/csi-snapshot-data-movement.md @@ -32,10 +32,11 @@ Velero built-in data mover restores both volume data and metadata, so the data m ### Install Velero Node Agent Velero Node Agent is a Kubernetes daemonset that hosts Velero data movement controllers and launches data mover pods. -If you are using Velero built-in data mover, Node Agent must be installed. To install Node Agent, use the `--use-node-agent` flag. +If you are using Velero built-in data mover, Node Agent must be installed. To install Node Agent, use the `--use-node-agent` flag. +Velero built-in data mover doesn't require the host path for pod volumes into Node Agent pods. The installation by default creates it in order to support fs-backup. If you don't use fs-backup and want to remove it from Node Agent, you can specify the `--node-agent-disable-host-path` flag. ``` -velero install --use-node-agent +velero install --use-node-agent --node-agent-disable-host-path ``` ### Configure A Backup Storage Location