3.4 KiB
RouterOS update-feed service
The project site now includes a small HTTP service for the RouterOS v7 update metadata used by the package updater. It serves the static landing page and Gitea release list, plus the plain-text update responses verified against MikroTik's public server.
Verified HTTP responses
RouterOS requests channel metadata in this form:
GET /routeros/NEWESTa7.stable?version=7.23.8
The response is plain text containing the offered version and Unix build time:
7.25.1 1793623193
The service currently maps testing to 7.23.8 for the upgrade-path experiment,
long-term to 7.24.6, and stable to 7.25.1. The version query parameter is
accepted and ignored, as it is by the upstream endpoint. Unknown channels return
HTTP 200 with No version available in this channel, matching the updater's
plain-text response handling.
After receiving a version, the RouterOS update UI requests its changelog:
GET /routeros/7.25.1/CHANGELOG
The body is the release's plain-text changelog. The three initial changelogs are
stored under site/feed/changelogs/; update them alongside the channel metadata
when publishing a new package version. /healthz is used by the Kubernetes
probes. /api/releases returns public Gitea release metadata for the landing
page.
The service also serves /routeros/<version>/packages.csv in the observed
arch,name,size format and streams the matching published, signed NPK at
/routeros/<version>/<package>-<version>-<arch>.npk. It selects the newest
published release revision for each package/architecture. The package list and
download were exercised against a public 7.25.1 Gitea release locally.
For the exact official 7.25.1 ARM and ARM64 sys2 builds, the NPK build can
replace both references to upgrade.mikrotik.com with
mikrotik.brunner.ninja:
python tools/routeros.py npk routeros-7.25.1-arm.npk --arch arm \
--patch-system --update-host mikrotik.brunner.ninja \
--keys .keys/development.json --output build/routeros-7.25.1-arm-updates.npk
The patch rejects any other sys2 digest. Both ARM and ARM64 test NPKs built,
self-verified, and contained only the project host in the updater binary.
The release workflow applies it to 7.25.1 builds. A live RouterOS update
check/download from this patched binary remains unverified. Do not treat a
version appearing in the dialog as proof that installation works. The exact
package request used by RouterOS and its behavior on the small-flash hAP ac2
still need a device test before a release is advertised as a working updater.
The update dialog handles version changes for installed packages. It does not offer a removed optional package as a same-version installation. For that experiment, download the published OLSR NPK from this site into RouterOS Files and reboot, or upload the same file with Winbox Files; do not use the version check button to reinstall it.
Hosting
The service runs from service/server.py; the corresponding container and
portable Helm chart live in this repository. Its public deployment target is
https://mikrotik.brunner.ninja. The service has no credentials or writable
data. It reads the checked-in feed/changelog files and queries the public Gitea
release API for the download page.
Local checks:
python3 -m unittest service.test_server -v
podman build -f service/Dockerfile -t localhost/mikrotik-olsr-site:test .
helm lint chart/mikrotik-olsr-site