Arvados

h1. Admin CLI for managing dispatcher / cloud VMs

Background: arvados-dispatch-cloud has a management interface for reporting and controlling the container queue and cloud VM instances. In principle, this is useful for identifying and killing stuck containers/instances, etc. However, it's very cumbersome to use because the only available frontend is a generic HTTP client like curl.

We should address this by adding some @arvados-server@ subcommands (alongside @cloudtest@, @config-check@, etc.).

For now, these commands will error out if arvados-dispatch-cloud is not running. In future some commands may also be usable with crunch-dispatch-slurm et al.

h2. Proposed commands

h3. @arvados-server instance list@

Display all known instance IDs, one per line, followed by state (unknown/booting/idle/...), time since last successful probe ("-" if none), and last container UUID ("-" if none).

h3. @arvados-server instance kill -reason "optional reason" {instanceID|containerUUID}@

Terminate specified instance.

If a container UUID is given, terminate whichever instance is running that container.

h3. @arvados-server instance hold|drain|resume {instanceID|containerUUID}@

Set idle behavior for specified instance to hold/drain/resume. See https://doc.arvados.org/main/api/dispatch.html

If a container UUID is given, operate on whichever instance is running that container.

h3. @arvados-server container kill -reason "optional reason" {containerUUID}@

Terminate specified container. Unlike clicking "cancel" in workbench2 which resets container request priority to 0, this signals the crunch-run supervisor process to terminate immediately.