Demo

Flow Diagram

Installation

# homebrewbrew install robinovitch61/tap/wander# upgrade using homebrewbrew update&& brew upgrade wander# nix-shell# ensure NUR is accessible (https://github.com/nix-community/NUR)nix-shell -p nur.repos.robinovitch61.wander# nix flakes# ensure flake support is enabled (https://nixos.wiki/wiki/Flakes#Enable_flakes_temporarily)nix run github:robinovitch61/nur-packages#wander# arch linux# PKGBUILD available at https://aur.archlinux.org/packages/wanderyay -S wander-bin# with go (https://go.dev/doc/install)go install github.com/robinovitch61/wander@latest# windows with wingetwinget install robinovitch61.wander# windows with scoopscoop bucket add robinovitch61 https://github.com/robinovitch61/scoop-bucketscoop install wander# windows with chocolateychoco install wander

Usage

Configuration

# Nomad address. Default "http://localhost:4646"#nomad_addr: "http://localhost:4646"# Nomad token#nomad_token: ""# Nomad region#nomad_region: ""# Nomad namespace. Default "*"#nomad_namespace: "*"# Nomad http auth, in the form of "user" or "user:pass"#nomad_http_auth: ""# Path to a PEM encoded CA cert file to use to verify the Nomad server SSL certificate#nomad_cacert: ""# Path to a directory of PEM encoded CA cert files to verify the Nomad server SSL certificate. If both cacert and capath are specified, cacert is used#nomad_capath: ""# Path to a PEM encoded client cert for TLS authentication to the Nomad server. Must also specify client key#nomad_client_cert: ""# Path to an unencrypted PEM encoded private key matching the client cert#nomad_client_key: ""# The server name to use as the SNI host when connecting via TLS#nomad_tls_server_name: ""# If True, do not verify TLS certificates. Default False#nomad_skip_verify: False# Seconds between updates for job & allocation pages. Disable with -1. Default 2#wander_update_seconds: 2# Columns to display for Jobs view - can reference Meta keys. Default "Job,Type,Namespace,Status,Count,Submitted,Since Submit"#wander_job_columns: "Job,Type,Namespace,Status,Count,Submitted,Since Submit"# Columns to display for Tasks for Job view. Default "Node ID,Alloc ID,Task Group,Alloc Name,Task Name,State,Started,Finished,Uptime"#wander_tasks_for_job_columns: "Node ID,Alloc ID,Task Group,Alloc Name,Task Name,State,Started,Finished,Uptime"# Columns to display for All Tasks view. Default "Job,Node ID,Alloc ID,Task Group,Alloc Name,Task Name,State,Started,Finished,Uptime"#wander_all_tasks_columns: "Job,Node ID,Alloc ID,Task Group,Alloc Name,Task Name,State,Started,Finished,Uptime"# If True, start with compact header. Default False#wander_compact_header: False# If True, start in All Tasks view. Default False#wander_start_all_tasks: False# If True, remove unnecessary gaps between table columns when possible. Default True# If you want column positions to remain static as you scroll and filter, set this to False#wander_compact_tables: True# Log byte offset from which logs start. Default 1000000#wander_log_offset: 1000000# If True, start with filtering active on first view. Default False#wander_start_filtering: False# If True, filtering highlights and allows cycling through matches, but does not remove surrounding context. Default True#wander_filter_with_context: True# If True, follow new logs as they come in rather than having to reload. Default True#wander_log_tail: True# If True, copy the full path to file after save. Default False#wander_copy_save_path: False# Topics to follow in event streams, comma-separated. Default "Job,Allocation,Deployment,Evaluation"# see https://www.nomadproject.io/api-docs/events#event-stream#wander_event_topics: "Job,Allocation,Deployment,Evaluation"# Namespace used in stream for all events. "*" for all namespaces. Default "default"#wander_event_namespace: "default"# The jq (https://stedolan.github.io/jq/) query used for parsing general events. "." to show entire event JSON. Default is:#  .Events[] | {#    "1:Index": .Index,#    "2:Topic": .Topic,#    "3:Type": .Type,#    "4:Name": .Payload | (.Job // .Allocation // .Deployment // .Evaluation) | (.JobID // .ID),#    "5:ID": .Payload | (.Job.ID // (.Allocation // .Deployment // .Evaluation).ID[:8])#  }# The numbering exists to preserve ordering, as https://github.com/itchyny/gojq does not keep the order of object keys#wander_event_jq_query: >#  .Events[] | {#    "1:Index": .Index,#    "2:Topic": .Topic,#    "3:Type": .Type,#    "4:Name": .Payload | (.Job // .Allocation // .Deployment // .Evaluation) | (.JobID // .ID),#    "5:ID": .Payload | (.Job.ID // (.Allocation // .Deployment // .Evaluation).ID[:8])#  }# The jq (https://stedolan.github.io/jq/) query used for parsing allocation-specific events. "." to show entire event JSON. Default is:#  .Index as $index | .Events[] | .Type as $type | .Payload.Allocation |#  .DeploymentStatus.Healthy as $healthy | .ClientStatus as $clientStatus | .Name as $allocName |#  (.TaskStates // {"":{"Events": [{}]}}) | to_entries[] | .key as $k | .value.Events[] | {#    "0:Index": $index,#    "1:AllocName": $allocName,#    "2:TaskName": $k,#    "3:Type": $type,#    "4:Time": ((.Time // 0) / 1000000000 | todate),#    "5:Msg": .DisplayMessage,#    "6:Healthy": $healthy,#    "7:ClientStatus": $clientStatus#  }# The numbering exists to preserve ordering, as https://github.com/itchyny/gojq does not keep the order of object keys#wander_alloc_event_jq_query: >#  .Index as $index | .Events[] | .Type as $type | .Payload.Allocation |#  .DeploymentStatus.Healthy as $healthy | .ClientStatus as $clientStatus | .Name as $allocName |#  (.TaskStates // {"":{"Events": [{}]}}) | to_entries[] | .key as $k | .value.Events[] | {#    "0:Index": $index,#    "1:AllocName": $allocName,#    "2:TaskName": $k,#    "3:Type": $type,#    "4:Time": ((.Time // 0) / 1000000000 | todate),#    "5:Msg": .DisplayMessage,#    "6:Healthy": $healthy,#    "7:ClientStatus": $clientStatus#  }# For `wander serve`. Hostname of the machine hosting the ssh server. Default "localhost"#wander_host: "localhost"# For `wander serve`. Port for the ssh server. Default 21324#wander_port: 21324# For `wander serve`. Host key path for wander ssh server#wander_host_key_path: ""# For `wander serve`. Host key PEM block for wander ssh server#wander_host_key_pem: ""# Custom colors#wander_logo_color: "#DBBD70"

Exec Command

# specify job and task, assuming single allocationwanderexec alright_stop --task redisecho"hi"# specify allocation, assuming single taskwanderexec 3dca0982echo"hi"# use prefixes of jobs or allocation idswanderexec alecho"hi"# prefix of job "alright_stop"wanderexec 3decho"hi"# prefix of alloc ID "3dca0982"# specify flags for the exec command with --wanderexec alright_stop --task redis --echo -n"hi"

SSH App

Trying It Out

# in first terminal session, start and leave nomad running in dev modesudo nomad agent -dev -bind 0.0.0.0 -log-level INFO# in a different terminal session, create example job and run itnomad job initnomad job run example.nomad# run wanderwander

Manually Specifying thewander Version

go build -ldflags"-X github.com/robinovitch61/wander/cmd.Version=vX.Y.Z"

Development

git clone git@github.com:robinovitch61/wander.gitcd wandergo build# outputs ./wander executable