Merge pull request #11707 from kobergj/StaleNodesDocu

[docs-only] Revert-Stale-Nodes Docu
This commit is contained in:
kobergj
2025-10-02 14:07:57 +02:00
committed by GitHub
3 changed files with 45 additions and 25555 deletions

25554
coverage.out

File diff suppressed because it is too large Load Diff

View File

@@ -140,6 +140,50 @@ ocis storage-users uploads sessions --expired=true --clean
ocis storage-users uploads sessions --processing=true --has-virus=false --resume
```
#### Delete Stale Nodes command
This command allows to remove (or revert) nodes that are stale, meaning they are in postprocessing but their upload session is gone.
It will check all nodes that are in postprocessing and find those without an upload session. Then it will delete the node if there are no other versions. If there are other versions, it will instead revert the node to the previous version.
```bash
~/ocis storage-users uploads delete-stale-nodes <commandoptions>
```
```
NAME:
ocis storage-users uploads delete-stale-nodes - Delete (or revert) all nodes in processing state that are not referenced by any upload session
USAGE:
ocis storage-users uploads delete-stale-nodes [command options]
OPTIONS:
--spaceid value Space ID to check for processing nodes (omit to check all spaces)
--dry-run Only show what would be deleted without actually deleting (default: true)
--verbose Enable verbose logging (default: false)
--help, -h show help
```
#### Command Examples
Dry run to see what would be deleted (recommended first step)
```bash
ocis storage-users uploads delete-stale-nodes
```
Set `--dry-run=false` to actually delete the stale nodes
```bash
ocis storage-users uploads delete-stale-nodes --dry-run=false
```
Use `--verbose` to get more information about what is happening
```bash
ocis storage-users uploads delete-stale-nodes --dry-run=false --verbose
```
### Manage Spaces
This command set provides commands to manage spaces, including purging disabled spaces that exceed the retention period.

View File

@@ -336,7 +336,7 @@ func buildInfo(filter storage.UploadSessionFilter) string {
func DeleteStaleProcessingNodes(cfg *config.Config) *cli.Command {
return &cli.Command{
Name: "delete-stale-nodes",
Usage: "Delete all nodes in processing state that are not referenced by any upload session",
Usage: "Delete (or revert) all nodes in processing state that are not referenced by any upload session",
Flags: []cli.Flag{
&cli.StringFlag{
Name: "spaceid",