Español · Українська

Doomsday Clock Exporter

Prometheus exporter for the Doomsday Clock value

Features

• Cached scraping with graceful degradation
• Environment variable configuration
• Service-specific healthcheck
• Self-observability metrics

Inherited from B19 / Ubuntu

• Persistent APT cache across builds
• Service process management with log routing (b19-exec)
• Cached artifact downloads with integrity verification
• Timed command execution with failure reporting (b19-run)
• Run-once initialization (bootstrap.d)
• Modular build hooks (build.d)
• Automatic CPU count detection
• Declarative dependency management (b19-deps)
• Pluggable startup system (entrypoint.d)
• Feature toggles for all subsystems
• Built-in health monitoring (healthcheck.d)
• Multilingual shell output (b19-i18n)
• Image lineage tracking
• Structured, level-filtered logging (b19-log)
• Non-root container by default
• Air-gapped / offline build and runtime support
• Runtime overlay injection
• Reproducible base image (pinned by digest)
• Port validation
• Unified lifecycle runner family
• Docker secrets auto-loading
• Interactive shell hooks
• Graceful signal handling
• Jinja2 configuration templates (minijinja-cli)
• Built-in test framework (test.d)
• Pre-installed utility tools
• XDG Base Directory paths

See FEATURES.md for the full list.

What this provides

• Executable doomsday-clock-exporter
• Container image ghcr.io/damian-buho/damian-buho/doomsday-clock-exporter:latest
• Container image docker.io/damianbuho/doomsday-clock-exporter:latest

Supported platforms

• linux/amd64
• linux/arm64
• linux/riscv64

Installation

Pull the published container image:

Pull from GHCR

docker pull ghcr.io/damian-buho/damian-buho/doomsday-clock-exporter:latest

Pull from DockerHub

docker pull docker.io/damianbuho/doomsday-clock-exporter:latest

Stable releases also publish X.Y.Z, X.Y and X tags — pull the precision you want to pin.

If the registries above are unreachable, pull from the origin instead:

Pull from Kiota

docker pull kiota.ch/damian-buho/doomsday-clock-exporter:latest

Usage

Bring the stack up locally:

make dc-up
make dc-logs
make dc-down

Then run it:

doomsday-clock-exporter --help

Building

Run make with no arguments for the default target; run make help to list every target.

For the local dev loop, make dev-container brings up the dev-container.

Pipeline entry points:

• make analyze — Run the heavy analysis sweep (mutation testing, benchmarks)
• make audited — Re-scan the pinned dependencies and published artifacts for new vulnerabilities
• make check-outdated — Report every pinned dependency that lags upstream
• make ready-to-publish — Run the pseudo-CI pipeline locally — build, test and scan, without publishing

Policies

• How to contribute
• Security policy
• Getting support
• Code of Conduct
• AI and LLM Policy

Links

• Projectfile Specification

License

This project is licensed under MIT — see the LICENSE file for details.