- name
- nomad
- version
- 1.0.0
- description
- Query HashiCorp Nomad clusters. List jobs, nodes, allocations, evaluations, and services. Read-only operations for monitoring and troubleshooting.
- homepage
- https://github.com/danfedick/nomad-skill
- metadata
- {"clawdbot":{"emoji":"📦","requires":{"bins":["nomad"]}}}
Nomad Skill
Query HashiCorp Nomad clusters using the nomad CLI. Read-only operations for monitoring and troubleshooting.
Requirements
nomadCLI installedNOMAD_ADDRenvironment variable set (or defaults to http://127.0.0.1:4646)NOMAD_TOKENif ACLs are enabled
Commands
Jobs
List all jobs:
nomad job statusGet job details:
nomad job status <job-id>Job history:
nomad job history <job-id>Job deployments:
nomad job deployments <job-id>Allocations
List allocations for a job:
nomad job allocs <job-id>Allocation details:
nomad alloc status <alloc-id>Allocation logs (stdout):
nomad alloc logs <alloc-id>Allocation logs (stderr):
nomad alloc logs -stderr <alloc-id>Follow logs:
nomad alloc logs -f <alloc-id>Nodes
List all nodes:
nomad node statusNode details:
nomad node status <node-id>Node allocations:
nomad node status -allocs <node-id>Evaluations
List recent evaluations:
nomad eval listEvaluation details:
nomad eval status <eval-id>Services
List services (Nomad native service discovery):
nomad service listService info:
nomad service info <service-name>Namespaces
List namespaces:
nomad namespace listVariables
List variables:
nomad var listGet variable:
nomad var get <path>Cluster
Server members:
nomad server membersAgent info:
nomad agent-infoJSON Output
Add -json to most commands for JSON output:
nomad job status -json
nomad node status -json
nomad alloc status -json <alloc-id>Filtering
Use -filter for expression-based filtering:
nomad job status -filter='Status == "running"'
nomad node status -filter='Status == "ready"'Common Patterns
Find failed allocations
nomad job allocs <job-id> | grep -i failedGet logs from latest allocation
nomad alloc logs $(nomad job allocs -json <job-id> | jq -r '.[0].ID')Check cluster health
nomad server members
nomad node statusEnvironment Variables
NOMAD_ADDR— Nomad API address (default: http://127.0.0.1:4646)NOMAD_TOKEN— ACL token for authenticationNOMAD_NAMESPACE— Default namespaceNOMAD_REGION— Default regionNOMAD_CACERT— Path to CA cert for TLSNOMAD_CLIENT_CERT— Path to client cert for TLSNOMAD_CLIENT_KEY— Path to client key for TLS
Notes
- This skill is read-only. No job submissions, stops, or modifications.
- Use
nomad-tuifor interactive cluster management. - For job deployment, use
nomad job run <file.nomad.hcl>directly.