https://github.com/sparkmeter/nquery
Query and explore your Nomad clusters
https://github.com/sparkmeter/nquery
cli hacktoberfest hashicorp nomad rust
Last synced: about 1 year ago
JSON representation
Query and explore your Nomad clusters
- Host: GitHub
- URL: https://github.com/sparkmeter/nquery
- Owner: sparkmeter
- License: mit
- Created: 2020-10-06T01:31:01.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2023-01-20T22:46:22.000Z (over 3 years ago)
- Last Synced: 2024-10-31T11:40:30.525Z (over 1 year ago)
- Topics: cli, hacktoberfest, hashicorp, nomad, rust
- Language: Rust
- Homepage:
- Size: 62.5 KB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
[](https://github.com/sparkmeter/nquery/actions?query=workflow%3ACI)
[](https://crates.io/crates/nquery)
# 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`](https://stedolan.github.io/jq/).
## Usage
```bash
# 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](https://github.com/sparkmeter/nquery/releases).
or, with Cargo:
```bash
cargo install nquery
```
## Debugging
To get helpful debugging information, run nquery with the `NQUERY_LOG=nquery`
environment variable set.