Wind Tunnel Runner Status Dashboard

A simple web app to view the connection status of Wind Tunnel Runner nodes.

The app polls the nomad api at a regular interval for a list of nodes and caches the result to memory. There is no persistent storage.

Users can then enter a hostname to view the status of the node with that hostname.

Configuration

The application uses environment variables for configuration:

Variable	Default	Description
NOMAD_URL	n/a	Nomad server URL
NOMAD_ACCEPT_INVALID_CERT	false	Should an invalid https certificate be accepted on requests to Nomad server api
NOMAD_TOKEN	n/a	Nomad server authentication token
BIND_ADDR	0.0.0.0:3000	Address and port to bind the HTTP server.
UPDATE_SECONDS	60	Interval to update the clients data, in seconds.
RUST_LOG	info	Log level (error, warn, info, debug, trace)

Running

Run locally, connected to wind tunnel nomad server

Replace <nomad_token> with a real token and run the following command:

NOMAD_URL=https://nomad-server-01.holochain.org:4646 NOMAD_ACCEPT_INVALID_CERT=true NOMAD_TOKEN=<nomad_token> cargo run --release

The server will be running at 127.0.0.1:3000

Run with docker

1. Build the image

docker build -t wind-tunnel-runner-status-dashboard .

1. Replace <nomad_token> with a real token and run the image:

docker run -p 3000:3000 \
   -e NOMAD_URL=https://nomad-server-01.holochain.org:4646 \
   -e NOMAD_ACCEPT_INVALID_CERT=true \
   -e NOMAD_TOKEN=<nomad_token> \
   wind-tunnel-runner-status-dashboard

Deploying

The app can be deployed to the Digital Ocean App Platform, via Pulumi configuration.

To update the configuration, open a PR to see the preview of the changes in the CI. Then, once the PR is reviewed and merged into the main branch, a new workflow will push the changes to Pulumi.

Installation

First, make sure that you are in the Nix development shell or that you have installed pulumi, pulumi-go, and go.

Then, log into Pulumi with:

pulumi login

Next, set the default organisation to holochain with:

pulumi org set-default holochain

Finally, select the Pulumi stack that you want to use. For this repo it is wind-tunnel-runner-status-dashboard.

pulumi stack select wind-tunnel-runner-status-dashboard

Making changes

Then enter the infra directory and preview the changes with:

cd infra && pulumi preview

Update the DigitalOcean token

Pulumi requires a Personal Access Token (PAT) for DigitalOcean to make calls to the API.

Currently, the PAT is linked to the ThetaSinner DigitalOcean user account. To change the token, run the following command:

cd infra && pulumi config set --secret digitalocean:token <new-token>

This value is encrypted by Pulumi and stored in ./infra/Pulumi.wind-tunnel-runner-status-dashboard.yaml.

Remember to open a PR with the new token and allow the CI/Actions to apply the changes to Pulumi.

Update the Nomad API token

Pulumi requires a token for the deployed application to make calls to the Nomad API. To change the token, run the following command:

cd infra && pulumi config set --secret nomadToken <new-token>

This value is encrypted by Pulumi and stored in ./infra/Pulumi.wind-tunnel-runner-status-dashboard.yaml.

Remember to open a PR with the new token and allow the CI/Actions to apply the changes to Pulumi.