• Improve user experience
    ci/woodpecker/tag/woodpecker Pipeline was successful
    Stable

    victor.kolomin released this 2026-07-06 08:14:27 +00:00 | 0 commits to main since this release

    Bug fixes

    Panic (nil pointer dereference) on image check — latestVersion could be nil when a tag from the registry failed to parse as SemVer while the error was silently ignored. Added explicit nil check with continue.
    Older versions being proposed — when proposed_tags_count: 3, all top-N tags were sent as notifications without checking each one individually. If current tag was v0.2.10 and top-3 contained v0.10.2, v0.2.10, v0.2.9, a notification for v0.2.9 was sent anyway. Now every tag is checked: tagVersion > currentVersion.
    Race condition in skiplist — IsImageIgnored was reading shared data without holding the mutex. Fixed.
    ~/.docker/config.json invalid JSON — missing curly braces caused Docker CLI to fail on startup.
    Woodpecker CI pipeline — when block was placed after steps instead of before, causing pipeline definition not found error.

    GHCR / rate limits

    Retry with backoff on 429 — reads Retry-After header on rate limit response; falls back to exponential backoff (10s → 20s → 40s) when header is absent. Up to 3 retries.
    GitHub PAT support — new github_token config field / CONTROLLA__GITHUB__TOKEN env var. Authenticated requests to GHCR have a significantly higher rate limit. Fixed auth format: SetBasicAuth("token", pat) instead of empty username.
    Pagination limit — new ghcr_max_pages config field (default: 5). Images with thousands of tags (e.g. immich-server) no longer exhaust the rate-limit quota in a single cycle. 5 pages × 200 tags = 1000 tags per image.
    Inter-request delay — 2-second pause between each image check to reduce burst pressure on all registries.

    Tag filtering

    Skip latest tag — images using latest are skipped entirely, no registry requests made.
    Prefixed tags support (ee-1.19.2, lts-3.0.1) — TryNormalizeTagForSemVer now strips - before a version number for comparison while preserving the original tag for display and git operations.
    Date-dash tags filtered (2026-05-26-debian-rootless) — new dateDashTagRegexp catches YYYY-MM-DD* format tags.
    Embedded timestamp tags filtered (26.03.20250318) — embeddedTimestampRegexp catches any tag segment with 7+ consecutive digits.
    X.Y.Z.A tags protected — fourPartTagRegex explicitly allows four-part numeric tags before other filters run, preventing false positives.
    Normalisation collision handling — when ee-1.19.2 and 1.19.2 both normalise to the same SemVer, the exact-match tag wins.

    Stability

    HTTP timeouts — added 15s timeout to DockerHubClient and GhcrClient (was missing).
    Error notification cache cleared on success — error_getting_tags is removed from sentNotifications after a successful fetch so the error can re-fire in a future cycle instead of being permanently suppressed.
    Semver dependency consistency — sort.go and main.go both use github.com/Masterminds/semver/v3; previously v1 and v3 were mixed in the same binary.

    New

    docker-compose.yml — sample file for local deployment
    internal/versionutils/normalize_test.go — unit tests covering prefix tag normalisation, collision handling, date and timestamp tag filtering

    Downloads