drove-cli 0.0.1__tar.gz → 0.0.3__tar.gz

{drove_cli-0.0.1 → drove_cli-0.0.3}/PKG-INFO

@@ -1,8 +1,7 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: drove-cli
-Version: 0.0.1
+Version: 0.0.3
 Summary: Drove Command Line Interface
-Home-page: https://github.com/PhonePe/drove-cli
 License: Apache-2.0
 Keywords: container,docker,podman,distributed-systems,container-orchestrator
 Author: Santanu Sinha
@@ -21,6 +20,8 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: System :: Clustering
 Classifier: Topic :: System :: Distributed Computing
 Requires-Dist: requests (>=2.31.0,<3.0.0)
@@ -38,20 +39,41 @@ Command line interface for the Drove Container Orchestrator.
 
 ## Installation
 
-You can install the cli from from PyPI.
+You can install the CLI from PyPI.
 
 ```bash
 pip install drove-cli
 ```
 
-Reactivate/deactivate virtual environment based on the need to utilize drove cli.
+### To install in a virtual env
+
+Create virtual environment
+```bash
+mkdir -p ${HOME}/venvs
+cd ${HOME}/venvs
+python3 -m venv drove_cli
+cd drove_cli
+source bin/activate
+pip install drove-cli
+```
+
+To activate in another shell:
+
+```bash
+source ${HOME}/venvs/drove_cli/bin/activate
+```
+
+To deactivate the venv (run when in activated environment):
+```bash
+deactivate
+```
 
 ## Running using docker
-The cli is pushed as a docker for easy access. This also elimintates the need for having python etc setup on your system.
+The cli is pushed as a docker for easy access. This also eliminates the need for having python etc setup on your system.
 
 1) Pull the image:
 ```shell
-docker pull ghcr.io/PhonePe/drove-cli:latest
+docker pull ghcr.io/phonepe/drove-cli:latest
 ```
 
 2) Create a shell script called `drove` with the following content:
@@ -61,7 +83,7 @@ docker pull ghcr.io/PhonePe/drove-cli:latest
 docker run \
     --rm --interactive --tty --network host \
     --name drove-cli -v ${HOME}/.drove:/root/.drove:ro  \
-    ghcr.io/PhonePe/drove-cli:latest "$@"
+    ghcr.io/phonepe/drove-cli:latest "$@"
 
 ```
 
@@ -80,7 +102,7 @@ export PATH="${PATH}:/path/to/your/script"
 
 
 6) Run drove cli
-```
+```shell
 drove -h
 ```
 
@@ -96,17 +118,20 @@ To see basic help:
 
 $ drove -h
 
-usage: drove [-h] [--file FILE] [--cluster CLUSTER] [--endpoint ENDPOINT] [--auth-header AUTH_HEADER] [--insecure INSECURE] [--username USERNAME] [--password PASSWORD] [--debug]
-             {executor,cluster,apps,appinstances,tasks} ...
+usage: drove [-h] [--file FILE] [--cluster CLUSTER] [--endpoint ENDPOINT] [--auth-header AUTH_HEADER] [--insecure] [--username USERNAME] [--password PASSWORD] [--debug]
+             {lsinstances,executor,cluster,apps,appinstances,tasks,localservices} ...
+
 
 positional arguments:
-  {executor,cluster,apps,appinstances,tasks}
+  {lsinstances,executor,cluster,apps,appinstances,tasks,localservices}
                         Available plugins
+    lsinstances         Drove local service instance related commands
     executor            Drove cluster executor related commands
     cluster             Drove cluster related commands
     apps                Drove application related commands
     appinstances        Drove application instance related commands
     tasks               Drove task related commands
+    localservices       Drove local service related commands
 
 options:
   -h, --help            show this help message and exit
@@ -117,8 +142,7 @@ options:
                         Drove endpoint. (For example: https://drove.test.com)
   --auth-header AUTH_HEADER, -t AUTH_HEADER
                         Authorization header value for the provided drove endpoint
-  --insecure INSECURE, -i INSECURE
-                        Do not verify SSL cert for server
+  --insecure, -i        Do not verify SSL cert for server
   --username USERNAME, -u USERNAME
                         Drove cluster username
   --password PASSWORD, -p PASSWORD
@@ -130,18 +154,20 @@ options:
 To see documentation for a command/section:
 ```
 $ drove cluster -h
-usage: drove cluster [-h] {ping,summary,leader,endpoints,events} ...
+usage: drove cluster [-h] {ping,summary,leader,endpoints,events,maintenance-on,maintenance-off} ...
 
 positional arguments:
-  {ping,summary,leader,endpoints,events}
+  {ping,summary,leader,endpoints,events,maintenance-on,maintenance-off}
                         Available commands for cluster management
     ping                Ping the cluster
     summary             Show cluster summary
     leader              Show leader for cluster
     endpoints           Show all exposed endpoints
     events              Events on the cluster
+    maintenance-on      Set cluster to maintenance mode
+    maintenance-off     Removed maintenance mode on cluster
 
-optional arguments:
+options:
   -h, --help            show this help message and exit
 ```
 
@@ -194,8 +220,8 @@ auth_header = %(prod_token)s
 ..
 ```
 
-The `DEFAULT` section can be used to define common variables like Insecure etc. The `local`, `stage`, `production` etc are names for inidividual clusters and these sections can be used to define configuration for individual clusters. Cluster name is referred to in the command line by using the `-c` command line option.\
-*Interpolation* of values is supported and can be acieved by using `%(variable_name)s` references.
+The `DEFAULT` section can be used to define common variables like Insecure etc. The `local`, `stage`, `production` etc are names for individual clusters and these sections can be used to define configuration for individual clusters. Cluster name is referred to in the command line by using the `-c` command line option.\
+*Interpolation* of values is supported and can be achieved by using `%(variable_name)s` references.
 
 > * Note: The `DEFAULT` section is mandatory
 > * Note: The `s` at the end of `%(var)s` is mandatory for interpolation
@@ -245,10 +271,10 @@ $ drove -e http://localhost:10000 -u guest -p guest ...
 ```
 
 ## CLI format
-The following cli format is followed:
+The following CLI format is followed:
 
 ```
-usage: drove [-h] [--file FILE] [--cluster CLUSTER] [--endpoint ENDPOINT] [--auth-header AUTH_HEADER] [--insecure INSECURE] [--username USERNAME] [--password PASSWORD] [--debug]
+usage: drove [-h] [--file FILE] [--cluster CLUSTER] [--endpoint ENDPOINT] [--auth-header AUTH_HEADER] [--insecure] [--username USERNAME] [--password PASSWORD] [--debug]
              {executor,cluster,apps,appinstances,tasks} ...
 ```
 ### Basic Arguments
@@ -261,8 +287,7 @@ usage: drove [-h] [--file FILE] [--cluster CLUSTER] [--endpoint ENDPOINT] [--aut
                         Drove endpoint. (For example: https://drove.test.com)
   --auth-header AUTH_HEADER, -t AUTH_HEADER
                         Authorization header value for the provided drove endpoint
-  --insecure INSECURE, -i INSECURE
-                        Do not verify SSL cert for server
+  --insecure, -i        Do not verify SSL cert for server
   --username USERNAME, -u USERNAME
                         Drove cluster username
   --password PASSWORD, -p PASSWORD
@@ -274,17 +299,19 @@ usage: drove [-h] [--file FILE] [--cluster CLUSTER] [--endpoint ENDPOINT] [--aut
 ## Commands
 Commands in drove are meant to address specific functionality. They can be summarized as follows:
 ```
-    executor            Drove cluster executor related commands
-    cluster             Drove cluster related commands
-    apps                Drove application related commands
-    appinstances        Drove application instance related commands
-    tasks               Drove task related commands
+    list                List all executors
+    info                Show details about executor
+    appinstances        Show app instances running on this executor
+    tasks               Show tasks running on this executor
+    lsinstances         Show local service instances running on this executor
+    blacklist           Blacklist executors
+    unblacklist         Un-blacklist executors
 ```
 ### executor
 ---
 Drove cluster executor related commands
 
-```
+```shell
 drove executor [-h] {list,info,appinstances,tasks} ...
 ```
 
@@ -294,7 +321,7 @@ drove executor [-h] {list,info,appinstances,tasks} ...
 
 List all executors
 
-```
+```shell
 drove executor list [-h]
 ```
 
@@ -302,7 +329,7 @@ drove executor list [-h]
 
 Show details about executor
 
-```
+```shell
 drove executor info [-h] executor-id
 ```
 
@@ -314,7 +341,7 @@ drove executor info [-h] executor-id
 
 Show app instances running on this executor
 
-```
+```shell
 drove executor appinstances [-h] [--sort {0,1,2,3,4,5}] [--reverse] executor-id
 ```
 ###### Positional Arguments
@@ -333,7 +360,7 @@ drove executor appinstances [-h] [--sort {0,1,2,3,4,5}] [--reverse] executor-id
 
 Show tasks running on this executor
 
-```
+```shell
 drove executor tasks [-h] [--sort {0,1,2,3,4,5}] [--reverse] executor-id
 ```
 
@@ -348,12 +375,54 @@ drove executor tasks [-h] [--sort {0,1,2,3,4,5}] [--reverse] executor-id
   --reverse, -r         Sort in reverse order
 ```
 
+##### lsinstances
+
+Show local service instances running on this executor
+
+```shell
+drove executor lsinstances [-h] [--sort {0,1,2,3,4,5}] [--reverse] executor-id
+```
+###### Positional Arguments
+
+`executor-id` - Executor id for which info is to be shown
+
+###### Arguments
+
+```
+  --sort {0,1,2,3,4,5}, -s {0,1,2,3,4,5}
+                        Sort output by column
+  --reverse, -r         Sort in reverse order
+```
+
+##### blacklist
+
+Take executors out of rotation.
+
+```shell
+drove executor blacklist executor-id [executor-id ...]
+```
+
+###### Positional Arguments
+
+`executor-id` - List of executor ids to be blacklisted. At least one is mandatory.
+
+##### unblacklist
+
+Bring blacklisted executors back into rotation.
+
+```shell
+drove executor unblacklist executor-id [executor-id ...]
+```
+
+###### Positional Arguments
+
+`executor-id` - List of executor ids to be brought in to the rotation. At least one is mandatory.
 
 ### cluster
 ---
 Drove cluster related commands
 
-```
+```shell
 drove cluster [-h] {ping,summary,leader,endpoints,events} ...
 ```
 
@@ -363,7 +432,7 @@ drove cluster [-h] {ping,summary,leader,endpoints,events} ...
 
 Ping the cluster
 
-```
+```shell
 drove cluster ping [-h]
 ```
 
@@ -371,20 +440,20 @@ drove cluster ping [-h]
 
 Show cluster summary
 
-```
+```shell
 drove cluster summary [-h]
 ```
 
 ##### leader
 
 Show leader for cluster
-```
+```shell
 drove cluster leader [-h]
 ```
 ##### endpoints
 
 Show all exposed endpoints
-```
+```shell
 drove cluster endpoints [-h] [--vhost VHOST]
 ```
 
@@ -399,7 +468,7 @@ drove cluster endpoints [-h] [--vhost VHOST]
 
 Events on the cluster
 
-```
+```shell
 drove cluster events [-h] [--follow] [--type TYPE] [--count COUNT] [--textfmt TEXTFMT]
 ```
 
@@ -414,12 +483,24 @@ drove cluster events [-h] [--follow] [--type TYPE] [--count COUNT] [--textfmt TE
                         Use the format string to print message
                         Default: “{type: <25} | {id: <36} | {time: <20} | {metadata}”
 ```
+##### maintenance-on
+Set cluster to maintenance mode.
+
+```shell
+drove cluster maintenance-on
+```
+##### maintenance-off
+Set cluster to normal mode.
+
+```shell
+drove cluster maintenance-off
+```
 
 ### apps
 ---
 Drove application related commands
 
-```
+```shell
 drove apps [-h] {list,summary,spec,create,destroy,deploy,scale,suspend,restart,cancelop} ...
 ```
 #### Sub-commands
@@ -428,7 +509,7 @@ drove apps [-h] {list,summary,spec,create,destroy,deploy,scale,suspend,restart,c
 
 List all applications
 
-```
+```shell
 drove apps list [-h] [--sort {0,1,2,3,4,5,6,7,8}] [--reverse]
 ```
 
@@ -443,7 +524,7 @@ drove apps list [-h] [--sort {0,1,2,3,4,5,6,7,8}] [--reverse]
 ##### summary
 
 Show a summary for an application
-```
+```shell
 drove apps summary [-h] app-id
 ```
 ###### Positional Arguments
@@ -453,7 +534,7 @@ drove apps summary [-h] app-id
 ##### spec
 
 Print the raw json spec for an application
-```
+```shell
 drove apps spec [-h] app-id
 ```
 ###### Positional Arguments
@@ -463,7 +544,7 @@ drove apps spec [-h] app-id
 ##### create
 
 Create application on cluster
-```
+```shell
 drove apps create [-h] spec-file
 ```
 ###### Positional Arguments
@@ -473,7 +554,7 @@ drove apps create [-h] spec-file
 ##### destroy
 
 Destroy an app with zero instances
-```
+```shell
 drove apps destroy [-h] app-id
 ```
 ###### Positional Arguments
@@ -483,7 +564,7 @@ drove apps destroy [-h] app-id
 ##### deploy
 
 Deploy new app instances.
-```
+```shell
 drove apps deploy [-h] [--parallelism PARALLELISM] [--timeout TIMEOUT] app-id instances
 ```
 ###### Positional Arguments
@@ -504,7 +585,7 @@ drove apps deploy [-h] [--parallelism PARALLELISM] [--timeout TIMEOUT] app-id in
 
 Scale app to required instances. Will increase or decrease instances on the cluster to match this number
 
-```
+```shell
 drove apps scale [-h] [--parallelism PARALLELISM] [--timeout TIMEOUT] app-id instances
 ```
 ###### Positional Arguments
@@ -525,7 +606,7 @@ drove apps scale [-h] [--parallelism PARALLELISM] [--timeout TIMEOUT] app-id ins
 ##### suspend
 
 Suspend the app
-```
+```shell
 drove apps suspend [-h] [--parallelism PARALLELISM] [--timeout TIMEOUT] app-id
 ```
 ###### Positional Arguments[¶](#Positional%20Arguments_repeat9 "Link to this heading")
@@ -546,7 +627,7 @@ drove apps suspend [-h] [--parallelism PARALLELISM] [--timeout TIMEOUT] app-id
 
 Restart am existing app instances.
 
-```
+```shell
 drove apps restart [-h] [--parallelism PARALLELISM] [--timeout TIMEOUT] app-id
 ```
 
@@ -565,7 +646,7 @@ drove apps restart [-h] [--parallelism PARALLELISM] [--timeout TIMEOUT] app-id
 ##### cancelop
 
 Cancel current operation
-```
+```shell
 drove apps cancelop [-h] app-id
 ```
 ###### Positional Arguments
@@ -574,7 +655,7 @@ drove apps cancelop [-h] app-id
 ### appinstances
 ---
 Drove application instance related commands
-```
+```shell
 drove appinstances [-h] {list,info,logs,tail,download,replace,kill} ...
 ```
 #### Sub-commands
@@ -582,7 +663,7 @@ drove appinstances [-h] {list,info,logs,tail,download,replace,kill} ...
 ##### list
 
 List all application instances
-```
+```shell
 drove appinstances list [-h] [--old] [--sort {0,1,2,3,4,5}] [--reverse] app-id
 ```
 ###### Positional Arguments
@@ -599,7 +680,7 @@ drove appinstances list [-h] [--old] [--sort {0,1,2,3,4,5}] [--reverse] app-id
 ##### info
 
 Print details for an application instance
-```
+```shell
 drove appinstances info [-h] app-id instance-id
 ```
 ###### Positional Arguments
@@ -609,7 +690,7 @@ drove appinstances info [-h] app-id instance-id
 ##### logs
 
 Print list of logs for application instance
-```
+```shell
 drove appinstances logs [-h] app-id instance-id
 ```
 ###### Positional Arguments
@@ -620,7 +701,7 @@ drove appinstances logs [-h] app-id instance-id
 ##### tail
 
 Tail log for application instance
-```
+```shell
 drove appinstances tail [-h] [--file FILE] app-id instance-id
 ```
 ###### Positional Arguments
@@ -637,7 +718,7 @@ drove appinstances tail [-h] [--file FILE] app-id instance-id
 ##### download
 
 Download log for application instance
-```
+```shell
 drove appinstances download [-h] [--out OUT] app-id instance-id file
 ```
 ###### Positional Arguments
@@ -653,7 +734,7 @@ drove appinstances download [-h] [--out OUT] app-id instance-id file
 ##### replace
 
 Replace specific app instances with fresh instances
-```
+```shell
 drove appinstances replace [-h] [--parallelism PARALLELISM] [--timeout TIMEOUT] app-id instance-id [instance-id ...]
 ```
 ###### Positional Arguments
@@ -672,7 +753,7 @@ drove appinstances replace [-h] [--parallelism PARALLELISM] [--timeout TIMEOUT]
 ##### kill
 
 Kill specific app instances
-```
+```shell
 drove appinstances kill [-h] [--parallelism PARALLELISM] [--timeout TIMEOUT] app-id instance-id [instance-id ...]
 ```
 ###### Positional Arguments
@@ -691,7 +772,7 @@ drove appinstances kill [-h] [--parallelism PARALLELISM] [--timeout TIMEOUT] app
 ### tasks
 ---
 Drove task related commands
-```
+```shell
 drove tasks [-h] {create,kill,list,show,logs,tail,download} ...
 ```
 #### Sub-commands
@@ -699,7 +780,7 @@ drove tasks [-h] {create,kill,list,show,logs,tail,download} ...
 ##### create
 
 Create a task on cluster
-```
+```shell
 drove tasks create [-h] spec-file
 ```
 ###### Positional Arguments
@@ -709,7 +790,7 @@ drove tasks create [-h] spec-file
 ##### kill
 
 Kill a running task
-```
+```shell
 drove tasks kill [-h] source-app-name task-id
 ```
 ###### Positional Arguments
@@ -720,7 +801,7 @@ drove tasks kill [-h] source-app-name task-id
 ##### list
 
 List all active tasks
-```
+```shell
 drove tasks list [-h] [--app APP] [--sort {0,1,2,3,4,5,6,7,8}] [--reverse]
 ```
 ###### Named Arguments
@@ -733,7 +814,7 @@ drove tasks list [-h] [--app APP] [--sort {0,1,2,3,4,5,6,7,8}] [--reverse]
 ##### show
 
 Shows details about a task
-```
+```shell
 drove tasks show [-h] source-app task-id
 ```
 ###### Positional Arguments
@@ -743,7 +824,7 @@ drove tasks show [-h] source-app task-id
 ##### logs
 
 Print list of logs for task
-```
+```shell
 drove tasks logs [-h] source-app task-id
 ```
 ###### Positional Arguments
@@ -753,7 +834,7 @@ drove tasks logs [-h] source-app task-id
 ##### tail
 
 Tail log for task
-```
+```shell
 drove tasks tail [-h] [--file FILE] source-app task-id
 ```
 ###### Positional Arguments
@@ -769,7 +850,7 @@ drove tasks tail [-h] [--file FILE] source-app task-id
 
 Download log for task
 
-```
+```shell
 drove tasks download [-h] [--out OUT] source-app task-id file
 ```
 ###### Positional Arguments
@@ -782,6 +863,256 @@ drove tasks download [-h] [--out OUT] source-app task-id file
 ```
   --out OUT, -o OUT  Filename to download to. Default is the same filename as provided.
 ```
+### localservices
+---
+Drove local service related commands
+
+```shell
+drove localservices [-h] {list,summary,spec,create,destroy,activate,deactivate,restart,cancelop} ...
+```
+#### Sub-commands
+
+##### list
+
+List all local services
+
+```shell
+drove localservices list [-h] [--sort {0,1,2,3,4,5,6,7,8}] [--reverse]
+```
+
+###### Named Arguments
+
+```
+  --sort {0,1,2,3,4,5,6,7,8}, -s {0,1,2,3,4,5,6,7,8}
+                        Sort output by column
+  --reverse, -r         Sort in reverse order
+```
+
+##### summary
+
+Show a summary for a local service
+```shell
+drove localservices summary [-h] service-id
+```
+###### Positional Arguments
+
+`service-id` - Local Service ID
+
+##### spec
+
+Print the raw json spec for a local service
+```shell
+drove localservices spec [-h] service-id
+```
+###### Positional Arguments
+
+`service-id` - Local Service ID
+
+##### create
+
+Create local service on cluster
+```shell
+drove localservices create [-h] spec-file
+```
+###### Positional Arguments
+
+`spec-file` - JSON spec file for the local service
+
+##### destroy
+
+Destroy an inactive local service
+
+```shell
+drove localservices destroy [-h] service-id
+```
+###### Positional Arguments
+
+`service-id` - Local Service ID
+
+
+##### activate
+
+Activate a local service
+
+```shell
+drove localservices activate [-h] service-id
+```
+###### Positional Arguments
+
+`service-id` - Local Service ID
+
+##### deactivate
+
+Deactivate a local service
+
+```shell
+drove localservices deactivate [-h] service-id
+```
+###### Positional Arguments
+
+`service-id` - Local Service ID
+
+##### update
+
+Deactivate a local service
+
+```shell
+drove localservices update [-h] service-id count
+```
+###### Positional Arguments
+
+`service-id` - Local Service ID
+`count` - Number of instances per executor
+
+##### restart
+
+Restart a local service.
+
+```shell
+drove localservices restart [-h] [--stop] [--parallelism PARALLELISM] [--timeout TIMEOUT] [--wait] service-id
+```
+
+###### Positional Arguments
+
+`service-id` - Local Service ID
+
+###### Named Arguments
+```
+  --stop, -s            Stop current instance before spinning up new ones
+  --parallelism PARALLELISM, -p PARALLELISM
+                        Number of parallel threads to be used to execute operation
+  --timeout TIMEOUT, -t TIMEOUT
+                        Timeout for the operation on the cluster
+  --wait, -w            Wait to ensure all instances are replaced
+```
+##### cancelop
+
+Cancel current operation
+```shell
+drove localservices cancelop [-h] service-id
+```
+###### Positional Arguments
+`service-id` - Service ID
+
+### lsinstances
+---
+Drove local service instance related commands
+
+```shell
+drove lsinstances [-h] {list,info,logs,tail,download,replace,kill} ...
+```
+#### Sub-commands
+
+##### list
+
+List all local service instances
+```shell
+drove lsinstances list [-h] [--old] [--sort {0,1,2,3,4,5}] [--reverse] service-id
+```
+###### Positional Arguments
+`service-id` - Local Service ID
+
+###### Named Arguments
+
+```
+  --parallelism PARALLELISM, -p PARALLELISM
+                        Number of parallel threads to be used to execute operation (default: 1)
+  --timeout TIMEOUT, -t TIMEOUT
+                        Timeout for the operation on the cluster (default: 5 minutes)
+```
+##### info
+
+Print details for an local service instance
+```shell
+drove lsinstances info [-h] service-id instance-id
+```
+###### Positional Arguments
+`service-id` - Local Service ID\
+`instance-id` - Local Service Instance ID
+
+##### logs
+
+Print list of logs for local service instance
+```shell
+drove lsinstances logs [-h] service-id instance-id
+```
+###### Positional Arguments
+
+`service-id` - Local Service ID\
+`instance-id` - Local Service Instance ID
+
+##### tail
+
+Tail log for local service instance
+```shell
+drove lsinstances tail [-h] [--file FILE] service-id instance-id
+```
+###### Positional Arguments
+
+`service-id` - Local Service ID
+`instance-id` - Local Service Instance ID
+
+###### Named Arguments
+
+```
+  --log LOG, -l LOG  Log filename to tail. Default is to tail output.log
+```
+
+##### download
+
+Download log for local service instance
+```shell
+drove lsinstances download [-h] [--out OUT] service-id instance-id file
+```
+###### Positional Arguments
+
+`service-id` - Local Service ID
+`instance-id` - Local Service Instance ID
+`file` - Log filename to download
+
+###### Named Arguments
+```
+--out, -o Filename to download to. Default is the same filename as provided.
+```
+##### replace
+
+Replace specific local service instances with fresh instances
+```shell
+drove lsinstances replace [-h] [--stop] [--parallelism PARALLELISM] [--timeout TIMEOUT] [--wait] service-id instance-id [instance-id ...]
+```
+###### Positional Arguments
+`service-id` - Local Service ID
+`instance-id` - Local Service Instance IDs
+
+###### Named Arguments
+```
+  --stop, -s            Stop the instance before spinning up a new one
+  --parallelism PARALLELISM, -p PARALLELISM
+                        Number of parallel threads to be used to execute operation
+  --timeout TIMEOUT, -t TIMEOUT
+                        Timeout for the operation on the cluster
+  --wait, -w            Wait to ensure all instances are replaced
+```
+
+##### kill
+
+Kill specific local service instances
+```shell
+drove lsinstances kill [-h] [--parallelism PARALLELISM] [--timeout TIMEOUT] service-id instance-id [instance-id ...]
+```
+###### Positional Arguments
+`service-id` - Local Service ID
+`instance-id` - Local Service Instance IDs
+
+###### Named Arguments
+
+```
+  --parallelism PARALLELISM, -p PARALLELISM
+                        Number of parallel threads to be used to execute operation
+  --timeout TIMEOUT, -t TIMEOUT
+                        Timeout for the operation on the cluster (default: 5 minutes)
+  --wait, -w            Wait to ensure all instances are killed
+```
 
 ©2024, Santanu Sinha.