Repository navigation
Development
Pavel Erokhin edited this page Nov 9, 2026
·
2 revisions
- Go 1.27, with
prometheus/client_golangandgo.yaml.in/yaml/v3. - A distroless image on
ghcr.io/mairwunnx/minecraft-exporter, for amd64 and arm64. - GitHub Actions: “CI” on every push and pull request, “Release” by hand, “Autopilot” every week.
-
gofmt -l .prints nothing. -
go vet ./...andgo test -race ./...pass. CI runs the same, then builds the image. - Run the exporter against a real WorldAPI, read-only, and
curl /metricstwice, 15 seconds apart. Every group from Metrics shows up, andminecraft_exporter_request_errors_totalstays absent. - For a change to what the dashboard shows, build the image locally and look at the dashboard through
examples/, as Building from source says.
- Count the requests. A new endpoint costs WorldAPI requests on every scrape. Slow data (once a minute or rarer) joins the batched queue in
privateItems()instead. - Data behind a permission goes through
allowed()anddone()with the endpoint's name. - Change the minecraft-grafana dashboard in the same go when a metric is added, renamed, or changes meaning, and the Metrics page here.
- Add the change to
CHANGELOG.mdunder the next version.
I write this project together with Claude, Anthropic's AI. CLAUDE.md in the repository (and AGENTS.md, the same file) tells it how the project fits together and what keeps it working.
Every Monday at 03:00 UTC .github/workflows/autopilot.yml runs Claude in GitHub Actions. It updates dependencies with /update-deps, fixes what breaks, pushes to master, and runs the “Release” workflow when the exporter changed. /update-minecraft stops at once here: the exporter follows WorldAPI's endpoints, not the game. Both skills live in .claude/skills/ and match the other projects of the family.
- Go:
toolchainingo.modand thegolangimage inDockerfile, the same version. Thegoline stays at the oldest Go the code needs. - Images:
Dockerfile(golang,gcr.io/distroless/static-debian13:nonroot), and Prometheus and Grafana inexamples/compose.yaml. - GitHub Actions in
.github/workflows/.
Next: Releasing.
For server owners
For developers