nomad

# Nomad Skill

Query HashiCorp Nomad clusters using the `nomad` CLI. Read-only operations for monitoring and troubleshooting.

## Requirements

- `nomad` CLI installed
- `NOMAD_ADDR` environment variable set (or defaults to http://127.0.0.1:4646)
- `NOMAD_TOKEN` if ACLs are enabled

## Commands

### Jobs

List all jobs:
```bash
nomad job status
```

Get job details:
```bash
nomad job status <job-id>
```

Job history:
```bash
nomad job history <job-id>
```

Job deployments:
```bash
nomad job deployments <job-id>
```

### Allocations

List allocations for a job:
```bash
nomad job allocs <job-id>
```

Allocation details:
```bash
nomad alloc status <alloc-id>
```

Allocation logs (stdout):
```bash
nomad alloc logs <alloc-id>
```

Allocation logs (stderr):
```bash
nomad alloc logs -stderr <alloc-id>
```

Follow logs:
```bash
nomad alloc logs -f <alloc-id>
```

### Nodes

List all nodes:
```bash
nomad node status
```

Node details:
```bash
nomad node status <node-id>
```

Node allocations:
```bash
nomad node status -allocs <node-id>
```

### Evaluations

List recent evaluations:
```bash
nomad eval list
```

Evaluation details:
```bash
nomad eval status <eval-id>
```

### Services

List services (Nomad native service discovery):
```bash
nomad service list
```

Service info:
```bash
nomad service info <service-name>
```

### Namespaces

List namespaces:
```bash
nomad namespace list
```

### Variables

List variables:
```bash
nomad var list
```

Get variable:
```bash
nomad var get <path>
```

### Cluster

Server members:
```bash
nomad server members
```

Agent info:
```bash
nomad agent-info
```

## JSON Output

Add `-json` to most commands for JSON output:
```bash
nomad job status -json
nomad node status -json
nomad alloc status -json <alloc-id>
```

## Filtering

Use `-filter` for expression-based filtering:
```bash
nomad job status -filter='Status == "running"'
nomad node status -filter='Status == "ready"'
```

## Common Patterns

### Find failed allocations
```bash
nomad job allocs <job-id> | grep -i failed
```

### Get logs from latest allocation
```bash
nomad alloc logs $(nomad job allocs -json <job-id> | jq -r '.[0].ID')
```

### Check cluster health
```bash
nomad server members
nomad node status
```

## Environment Variables

- `NOMAD_ADDR` — Nomad API address (default: http://127.0.0.1:4646)
- `NOMAD_TOKEN` — ACL token for authentication
- `NOMAD_NAMESPACE` — Default namespace
- `NOMAD_REGION` — Default region
- `NOMAD_CACERT` — Path to CA cert for TLS
- `NOMAD_CLIENT_CERT` — Path to client cert for TLS
- `NOMAD_CLIENT_KEY` — Path to client key for TLS

## Notes

- This skill is read-only. No job submissions, stops, or modifications.
- Use `nomad-tui` for interactive cluster management.
- For job deployment, use `nomad job run <file.nomad.hcl>` directly.