Skip to content

Commit 2e90f52

Browse files
committed
fix(upgrade): update update read me docs
Signed-off-by: sinhaashish <[email protected]>
1 parent 580147c commit 2e90f52

File tree

4 files changed

+71
-38
lines changed

4 files changed

+71
-38
lines changed

k8s/plugin/README.md

Lines changed: 68 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -28,11 +28,10 @@ Commands:
2828
scale 'Scale' resources
2929
cordon 'Cordon' resources
3030
uncordon 'Uncordon' resources
31-
dump `Dump` resources
32-
install `Install` resources
33-
uninstall `Uninstall` resources
34-
upgrade `Upgrade` resources
35-
help Print this message or the help of the given subcommand(s)
31+
dump 'Dump' resources
32+
upgrade 'Upgrade' the deployment
33+
delete 'Delete' the upgrade resources
34+
help Print this message or the help of the given subcommand(s)
3635
3736
Options:
3837
-r, --rest <REST>
@@ -46,7 +45,7 @@ Options:
4645
-t, --timeout <TIMEOUT>
4746
Timeout for the REST operations [default: 10s]
4847
-n, --namespace <NAMESPACE>
49-
Kubernetes namespace of mayastor service, defaults to mayastor [default: mayastor]
48+
Kubernetes namespace of mayastor service
5049
-h, --help
5150
Print help
5251
-V, --version
@@ -278,7 +277,7 @@ Options:
278277
-d, --output-directory-path <OUTPUT_DIRECTORY_PATH>
279278
Output directory path to store archive file [default: ./]
280279
-n, --namespace <NAMESPACE>
281-
Kubernetes namespace of mayastor service, defaults to mayastor [default: mayastor]
280+
Kubernetes namespace of mayastor service[default: mayastor]
282281
-o, --output <OUTPUT>
283282
The Output, viz yaml, json [default: none]
284283
-j, --jaeger <JAEGER>
@@ -347,57 +346,91 @@ Supportability - collects state & log information of services and dumps it to a
347346
kubectl mayastor dump volume volume-1 -d /mayastor-dump -r http://127.0.0.1:30011 -l http://127.0.0.1:3100 -e http://127.0.0.1:2379 -n mayastor
348347
```
349348
349+
</details>
350350
<details>
351351
<summary> Upgrade operations </summary>
352352
353353
**Examples**:
354354
355-
1. To install upgrade resources need for executing upgrade operation
356-
```sh
357-
## Command
358-
kubectl mayastor install upgrade-operator -n <mayastor_namespace>
359-
```
360-
361-
2. To uninstall upgrade resources need for executing upgrade operation
362-
```sh
363-
## Command
364-
kubectl mayastor uninstall upgrade-operator -n <mayastor_namespace>
365-
```
366-
367-
1. To upgrade the installation
368-
```sh
355+
1. Upgrade deployment
356+
```
369357
## Command
370358
kubectl mayastor upgrade
371359
`Upgrade` the deployment
372360
373361
Usage: kubectl-mayastor upgrade [OPTIONS]
374362
375363
Options:
376-
-d, --dry-run
364+
-d, --dry-run
377365
Display all the validations output but will not execute upgrade
378-
-r, --rest <REST>
366+
-r, --rest <REST>
379367
The rest endpoint to connect to
380-
-k, --kube-config-path <KUBE_CONFIG_PATH>
381-
Path to kubeconfig file
382-
-s, --skip-data-plane-restart
368+
-D, --skip-data-plane-restart
383369
If set then upgrade will skip the io-engine pods restart
384-
--skip-single-replica-volume-validation
370+
-k, --kube-config-path <KUBE_CONFIG_PATH>
371+
Path to kubeconfig file
372+
-S, --skip-single-replica-volume-validation
385373
If set then it will continue with upgrade without validating singla replica volume
386-
--skip-replica-rebuild
374+
-R, --skip-replica-rebuild
387375
If set then upgrade will skip the repilca rebuild in progress validation
388-
-o, --output <OUTPUT>
376+
-C, --skip-cordoned-node-validation
377+
If set then upgrade will skip the cordoned node validation
378+
-o, --output <OUTPUT>
389379
The Output, viz yaml, json [default: none]
390-
-j, --jaeger <JAEGER>
380+
-j, --jaeger <JAEGER>
391381
Trace rest requests to the Jaeger endpoint agent
392-
-n, --namespace <NAMESPACE>
393-
Kubernetes namespace of mayastor service, defaults to mayastor [default: mayastor]
394-
-h, --help
382+
-n, --namespace <NAMESPACE>
383+
Kubernetes namespace of mayastor service [default: mayastor]
384+
-h, --help
395385
Print help
396386
```
397387
398-
4. To get the upgrade status
399-
```sh
388+
2. Get the upgrade status
389+
```
400390
## Command
401391
kubectl mayastor get upgrade-status
392+
`Get` the upgrade status
393+
394+
Usage: kubectl-mayastor get upgrade-status [OPTIONS]
395+
396+
Options:
397+
-r, --rest <REST>
398+
The rest endpoint to connect to
399+
-k, --kube-config-path <KUBE_CONFIG_PATH>
400+
Path to kubeconfig file
401+
-o, --output <OUTPUT>
402+
The Output, viz yaml, json [default: none]
403+
-j, --jaeger <JAEGER>
404+
Trace rest requests to the Jaeger endpoint agent
405+
-n, --namespace <NAMESPACE>
406+
Kubernetes namespace of mayastor service [default: mayastor]
407+
-h, --help
408+
Print help
402409
```
410+
411+
3. Delete upgrade resources
412+
```
413+
## Command
414+
kubectl mayastor delete upgrade
415+
`Delete` the upgrade resources
416+
417+
Usage: kubectl-mayastor delete upgrade [OPTIONS]
418+
419+
Options:
420+
-f, --force
421+
If true, immediately remove upgrade resources bypass graceful deletion
422+
-r, --rest <REST>
423+
The rest endpoint to connect to
424+
-k, --kube-config-path <KUBE_CONFIG_PATH>
425+
Path to kubeconfig file
426+
-o, --output <OUTPUT>
427+
The Output, viz yaml, json [default: none]
428+
-j, --jaeger <JAEGER>
429+
Trace rest requests to the Jaeger endpoint agent
430+
-n, --namespace <NAMESPACE>
431+
Kubernetes namespace of mayastor service [default: mayastor]
432+
-h, --help
433+
Print help
434+
435+
```
403436
</details>

k8s/plugin/src/main.rs

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ struct CliArgs {
4343
#[clap(long, short, default_value = "10s")]
4444
timeout: humantime::Duration,
4545

46-
/// Kubernetes namespace of mayastor service, defaults to mayastor
46+
/// Kubernetes namespace of mayastor service
4747
#[clap(global = true, long, short = 'n', default_value = "mayastor")]
4848
namespace: String,
4949
}

k8s/plugin/src/resources/mod.rs

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ pub enum Operations {
3434
Dump(DumpArgs),
3535
/// `Upgrade` the deployment.
3636
Upgrade(UpgradeArgs),
37-
/// `Delete` the resources.
37+
/// `Delete` the upgrade resources.
3838
#[clap(subcommand)]
3939
Delete(DeleteResources),
4040
}

k8s/supportability/src/lib.rs

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,7 @@ pub struct SupportArgs {
4444
#[clap(global = true, long, short = 'd', default_value = "./")]
4545
output_directory_path: String,
4646

47-
/// Kubernetes namespace of mayastor service, defaults to mayastor
47+
/// Kubernetes namespace of mayastor service
4848
#[clap(global = true, long, short = 'n', default_value = "mayastor")]
4949
namespace: String,
5050
}

0 commit comments

Comments
 (0)