measurementlab/measure-saver

M-Lab Measure Saver

https://godoc.org/github.com/m-lab/measure-saver?status.svg](https://godoc.org/github.com/m-lab/measure-saver) 

本仓库包含Measure Saver服务的源代码，该服务用于接收来自M-Lab Measure Chrome扩展的数据，并将其存储到PostgreSQL数据库中。

构建服务

使用Docker

bash
docker build -t measurementlab/measure-saver:latest .

这将构建一个基于Alpine Linux的最小镜像，包含静态链接的measure-saver可执行文件，是推荐的构建和运行方式。有关Docker构建的详细信息，请阅读Dockerfile。

从源代码构建

若需修改并测试：

bash
go build ./cmd/measure-saver

运行：

bash
./measure-saver

或安装到$GOPATH/bin：

bash
go install ./cmd/measure-saver

测试服务

运行PostgreSQL实例

首先确保本地运行PostgreSQL数据库，并为服务创建用户和数据库。测试时可使用Docker容器：

bash
docker run --name postgres-dev -d postgres:12.3-alpine

进入容器执行psql：

bash
docker exec -it postgres-dev psql -U postgres

创建数据库：

text
postgres=# create database "measure-saver";

运行服务

首次运行时会自动创建所需表：

bash
docker run --network=host measurementlab/measure-saver:latest

远程PostgreSQL、授权密钥文件和TLS证书的完整运行示例：

bash
docker run --network=host measurementlab/measure-saver:latest \
  -db.addr "myhost:5432" \
  -db.name "database-name" \
  -db.user "user" \
  -db.pass "password" \
  -keys.file "authorized_api_keys.txt" \
  -tls.cert "certs/cert.pem" \
  -tls.key "certs/key.pem"

所有可用参数请参考-help输出。

使用服务

API仅暴露一个REST资源：/v0/measurements。发送POST请求到该端点，包含测量结果的JSON数据：

示例：

json
{
  "BrowserID": "a-unique-browser-id",
  "DeviceType": "xyz",
  "Notes": "This is a note",
  "Download": 100,
  "Upload": 50,
  "Latency": 20,
  "ClientInfo": {
    [ClientInfo对象]
  },
  "ServerInfo": {
    [ServerInfo对象]
  },
  "Results": {
    [NDT结果对象]
  }
}

ClientInfo、ServerInfo和Results对象定义见此处。