This repository contains an implementation of Neubot's DASH experiment client and server, both written in Go.
The server is meant to be deployed at Measurement Lab. For this reason the release procedure for the server, described below, uses Docker. Images will be available as neubot/dash.
make buildcontainer
The following command should work on a Linux system:
make runcontainer
This command will run dash-server
in a container as the root user, with
no capabilities, limiting access to the file system and exposing all the
relevant ports: 80 for HTTP based tests, 443 for HTTPS tests, and 9990 to
access prometheus metrics.
First of all, update the version number in:
Then commit the changes and tag a new release.
To push the container at DockerHub, run:
docker push neubot/dash
The procedure to update the version that runs on M-Lab is the following:
- open a pull request at m-lab/dash so they know they need to sync from this repo
- ask the m-lab staff to pull the tagged version
- open a pull request for neubot.jsonnet at m-lab/k8s-support
At this point, neubot/dash
is deployed in staging. To test, use
https://locate-dot-mlab-staging.appspot.com/v2/nearest/neubot/dash
as the locate URL instead of the canonical one.
Build using:
go build -v ./cmd/dash-client
Make sure you read PRIVACY.md before running. The command
will anyway refuse to run unless you acknowledge the privacy policy by
passing the -y
command line flag.