hashicorp / hashicorp/nomad

Use list subcommand instead of overloading status

Open
#8,686 0 comments 0 reactions 0 assignees View on GitHub
theme/cli type/enhancement
Dominant language
Go
Stars
17k
Forks
2.1k
Avg merge
1d 9h
Merged PRs (30d)
105

Description

### Nomad version
v0.12.3+ent (ef2ee76806abbeccb076a73511fc47ec4500c877)

### Issue

Some commands use a `list` subcommand and some commands overload `status` to list all objects when an object ID is not given.

All commands should have a `list` subcommand for 3 reasons:

1. A distinct subcommand for the purpose is the most obvious place for people to look for this functionality.
2. Listing may have distinct parameters from object retrieval. A distinct `list` subcommand prevents intermingling list and get parameters in single `status` subcommand.

**TODO: Commands overloading status:**

* `job`
* `node`
* `volume`
* `eval` (overloads status weirdly)
* `server` uses `members` and should probably be brought in line as well

**Done: Commands with list already:**

* `acl policy`
* `acl token`
* `deployment`
* `namespace`
* `quota`
* `sentinel`

**WONTFIX: Comands that do not need listing:**

* `alloc status` - We do not need a command line for listing all allocations

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.