• v3.0.0 b46c116f6b

    Feat/v3 go rewrite (#47)
    ci/woodpecker/tag/docker Pipeline was successful

    unkinben released this 2026-06-07 19:30:35 +10:00 | 33 commits to master since this release

    Complete rewrite of ArtifactAPI from Python/FastAPI to Go as a single binary.

    Core engine:

    • 10 package providers: generic, docker, helm, pypi, npm, rpm, alpine,
      puppet, terraform, goproxy — each with built-in mutable patterns
    • Content-addressable storage (SHA256 dedup across all remotes)
    • Three-tier caching: Redis (TTL/locks) → S3/MinIO (blobs) → upstream
    • Classifier with allowlist/blocklist per-remote (empty = allow all)
    • Circuit breaker, conditional revalidation, stale-on-error
    • Background garbage collection for orphaned blobs
    • Access logging to PostgreSQL

    API:

    • v1 proxy endpoints (backwards compatible)
    • v2 management API: CRUD remotes/virtuals, object browser, stats,
      health, SSE events, probe/test endpoint
    • Virtual repos with index merging (Helm YAML + PyPI HTML)

    Frontend (React + Vite, separate Dockerfile):

    • Dashboard with stats, health indicators, top remotes
    • Remotes list with type filter, remote detail with config/patterns
    • Object browser with pagination and evict
    • Test Remote page: probe any remote path, see headers/size/timing
    • Virtuals page with expandable member lists

    TUI (Bubble Tea):

    • Dashboard, remotes list/detail, object browser, virtuals
    • Vim-style navigation, artifactapi tui --endpoint

    Infrastructure:

    • S3 client supports MinIO, Ceph RGW, AWS S3 (minio-go)
    • PostgreSQL schema with migrations
    • Docker Compose: API + UI + Postgres 17 + Redis 7 + MinIO
    • Makefile with Go version check, build/test/lint/fmt/e2e targets
    • Distroless Docker image (~15MB)

    Testing:

    • Unit tests for models, classifier, providers, mergers
    • E2E tests with testcontainers-go (real Postgres/Redis/MinIO)

    Terraform config:

    • All 40 production remotes + helm virtual as HCL
    • Provider repo: terraform-provider-artifactapi v0.0.1 (separate)

    Co-authored-by: Ben Vincent ben@unkin.net
    Reviewed-on: #47

    Downloads