Pim van Pelt
58391f5463
gRPC / proto - Rename WatchBackendEvents → WatchEvents; return a stream of Event oneof (LogEvent, BackendEvent, FrontendEvent) with optional filter flags (log, log_level, backend, frontend) - Add EnableBackend, DisableBackend, SetFrontendPoolBackendWeight RPCs - Rename PauseResumeRequest → BackendRequest - Add CheckConfig RPC returning ok/parse_error/semantic_error maglevd - Route slog through a LogBroadcaster (slog.Handler) so WatchEvents subscribers can receive structured log records independently of the daemon's own --log-level - Add --reflection flag (default true) to toggle gRPC server reflection - Add --check flag: validates config file and exits 0/1/2 - SIGHUP: use config.Check before applying reload; log parse vs semantic error separately; refuse reload on any error - Rename default config path /etc/maglev → /etc/vpp-maglev maglevc - Add 'watch events [num <n>] [log [level <level>]] [backend] [frontend]' command; prints compact protojson, stops on any keypress or Ctrl-C; uses cbreak mode (not raw) so output post-processing is preserved - Add 'set backend <name> enable|disable' - Add 'set frontend <name> pool <pool> backend <name> weight <0-100>' - Add 'config check' command Debian packaging - Rename service unit to vpp-maglevd.service - Rename conffiles to /etc/default/vpp-maglev and /etc/vpp-maglev/ - Create maglevd system user/group in postinst; add to vpp group if present - Add postrm; add adduser to Depends
55 lines
1.7 KiB
Markdown
55 lines
1.7 KiB
Markdown
# maglevd
|
|
|
|
Health checker and gRPC control plane for VPP Maglev load balancing.
|
|
|
|
## Build and Install
|
|
|
|
```sh
|
|
make # builds build/<arch>/maglevd and build/<arch>/maglevc
|
|
make test # runs all tests
|
|
make pkg-deb # Creates a debian package for arm64 and amd64
|
|
```
|
|
|
|
Requires Go 1.25+ and (for `make proto`) `protoc` with `protoc-gen-go` and
|
|
`protoc-gen-go-grpc`.
|
|
|
|
Produces `vpp-maglev_<version>_amd64.deb` and `vpp-maglev_<version>_arm64.deb`
|
|
in the `build/` directory by cross-compiling with `GOOS=linux GOARCH=<arch>`.
|
|
Requires `dpkg-deb` (available on any Debian/Ubuntu host).
|
|
|
|
## Running
|
|
|
|
After installing, the unit is enabled but not started automatically:
|
|
|
|
```sh
|
|
# edit /etc/vpp-maglev/maglev.yaml, then:
|
|
systemctl enable --now vpp-maglevd
|
|
```
|
|
|
|
Or run the server and client by hand:
|
|
|
|
```sh
|
|
maglevd --config /etc/vpp-maglev/maglev.yaml --grpc-addr :9090
|
|
maglevd --version # print version and exit
|
|
|
|
maglevc --server localhost:9090 # interactive shell
|
|
maglevc show frontends # one-shot
|
|
maglevc -color=false show backends # one-shot, no ANSI color
|
|
maglevc set backend nginx0-ams pause
|
|
```
|
|
|
|
Send `SIGHUP` to `maglevd` to reload config without restarting.
|
|
`maglevd` requires `CAP_NET_RAW` for ICMP health checks.
|
|
|
|
Check out a minimal configuration file in [[debian/maglev.yaml](debian/maglev.yaml)].
|
|
See [docs/user-guide.md](docs/user-guide.md) for flags, signals, and `maglevc` usage.
|
|
See [docs/config-guide.md](docs/config-guide.md) for the full configuration reference.
|
|
See [docs/healthchecks.md](docs/healthchecks.md) for health state machine details.
|
|
|
|
## Docker
|
|
|
|
```sh
|
|
docker build -t maglevd .
|
|
docker run --cap-add NET_RAW -v /etc/vpp-maglev:/etc/vpp-maglev maglevd
|
|
```
|