6 releases

0.3.1 Nov 16, 2020
0.3.0 Nov 6, 2020
0.2.4 Oct 27, 2020
0.1.0 Oct 20, 2020

#7 in #nomad

24 downloads per month

MIT license

22KB
352 lines

Build Latest version

nquery

Query and explore jobs on your Nomad clusters from the comfort of the command line.

The output is raw JSON, to facilitate integration with tooling such as jq.

Usage

# Get all jobs with IDs starting with 'redis' as pretty-printed JSON
$ nquery --pretty redis
[
  {
    "ID": "redis",
    "Name": "redis",
    "Namespace": "default",
    "ParameterizedJob": null,
    # ...
    "TaskGroups": [
      {
        # ...
        "Tasks": [
           {
              # ...
              "Meta": null,
              "Name": "redis",
           }
        ]
      }
    ]
  }
]


# Get the ID and task data-source fields of all parameterized jobs starting with etl
$ nquery --pretty --parameterized -f Meta.data-source etl
[
  {
    "ID": "etl-cluster-1"
    "Meta.data-source": "db-cluster-1",
  },
  {
    "ID": "etl-cluster-2"
    "Meta.data-source": "db-cluster-2",
  }
]

# Count the number of ETL tasks
$ nquery --parameterized -f Meta.data-source etl | jq '. | length'

Installation

Download the latest binary for your platform from the releases page.

or, with Cargo:

cargo install nquery

Debugging

To get helpful debugging information, run nquery with the NQUERY_LOG=nquery environment variable set.

Dependencies

~10–14MB
~272K SLoC