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

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 <url>

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
This commit was merged in pull request #47.
This commit is contained in:
2026-06-07 19:30:35 +10:00
parent f25bf6cb29
commit b46c116f6b
160 changed files with 11448 additions and 7907 deletions
+35
View File
@@ -0,0 +1,35 @@
.badge {
display: inline-block;
padding: 2px 8px;
border-radius: 4px;
font-size: 0.75em;
font-weight: 600;
font-family: var(--font-mono);
text-transform: uppercase;
letter-spacing: 0.03em;
}
.badge-default {
background: var(--bg-elevated);
color: var(--text-muted);
}
.badge-green {
background: rgba(34, 197, 94, 0.15);
color: var(--green);
}
.badge-yellow {
background: rgba(234, 179, 8, 0.15);
color: var(--yellow);
}
.badge-red {
background: rgba(239, 68, 68, 0.15);
color: var(--red);
}
.badge-blue {
background: rgba(59, 130, 246, 0.15);
color: var(--accent);
}
+10
View File
@@ -0,0 +1,10 @@
import './Badge.css';
interface BadgeProps {
children: React.ReactNode;
variant?: 'default' | 'green' | 'yellow' | 'red' | 'blue';
}
export function Badge({ children, variant = 'default' }: BadgeProps) {
return <span className={`badge badge-${variant}`}>{children}</span>;
}
+50
View File
@@ -0,0 +1,50 @@
.data-table-wrap {
overflow-x: auto;
border: 1px solid var(--border);
border-radius: var(--radius);
background: var(--bg-surface);
}
.data-table {
width: 100%;
border-collapse: collapse;
font-size: 0.9em;
}
.data-table th {
text-align: left;
padding: 10px 14px;
font-size: 0.8em;
font-weight: 600;
color: var(--text-muted);
text-transform: uppercase;
letter-spacing: 0.04em;
border-bottom: 1px solid var(--border);
background: var(--bg-elevated);
white-space: nowrap;
}
.data-table td {
padding: 10px 14px;
border-bottom: 1px solid var(--border);
color: var(--text);
vertical-align: middle;
}
.data-table tbody tr:last-child td {
border-bottom: none;
}
.data-table tbody tr:hover {
background: var(--bg-elevated);
}
.data-table tbody tr.clickable {
cursor: pointer;
}
.data-table-empty {
text-align: center;
color: var(--text-muted);
padding: 32px 14px !important;
}
+54
View File
@@ -0,0 +1,54 @@
import './DataTable.css';
interface Column<T> {
key: string;
header: string;
render: (item: T) => React.ReactNode;
width?: string;
}
interface DataTableProps<T> {
columns: Column<T>[];
data: T[];
emptyMessage?: string;
onRowClick?: (item: T) => void;
}
export function DataTable<T>({ columns, data, emptyMessage = 'No data', onRowClick }: DataTableProps<T>) {
return (
<div className="data-table-wrap">
<table className="data-table">
<thead>
<tr>
{columns.map(col => (
<th key={col.key} style={col.width ? { width: col.width } : undefined}>
{col.header}
</th>
))}
</tr>
</thead>
<tbody>
{data.length === 0 ? (
<tr>
<td colSpan={columns.length} className="data-table-empty">
{emptyMessage}
</td>
</tr>
) : (
data.map((item, i) => (
<tr
key={i}
onClick={onRowClick ? () => onRowClick(item) : undefined}
className={onRowClick ? 'clickable' : ''}
>
{columns.map(col => (
<td key={col.key}>{col.render(item)}</td>
))}
</tr>
))
)}
</tbody>
</table>
</div>
);
}
+29
View File
@@ -0,0 +1,29 @@
.stats-card {
background: var(--bg-surface);
border: 1px solid var(--border);
border-radius: var(--radius);
padding: 20px;
min-width: 160px;
}
.stats-label {
font-size: 0.8em;
color: var(--text-muted);
text-transform: uppercase;
letter-spacing: 0.05em;
margin-bottom: 6px;
}
.stats-value {
font-size: 1.8em;
font-weight: 700;
color: var(--text-bright);
font-family: var(--font-mono);
line-height: 1.2;
}
.stats-sub {
font-size: 0.8em;
color: var(--text-muted);
margin-top: 4px;
}
+17
View File
@@ -0,0 +1,17 @@
import './StatsCard.css';
interface StatsCardProps {
label: string;
value: string | number;
sub?: string;
}
export function StatsCard({ label, value, sub }: StatsCardProps) {
return (
<div className="stats-card">
<div className="stats-label">{label}</div>
<div className="stats-value">{value}</div>
{sub && <div className="stats-sub">{sub}</div>}
</div>
);
}
+29
View File
@@ -0,0 +1,29 @@
export function formatBytes(bytes: number): string {
if (bytes === 0) return '0 B';
const units = ['B', 'KB', 'MB', 'GB', 'TB'];
const i = Math.floor(Math.log(bytes) / Math.log(1024));
const val = bytes / Math.pow(1024, i);
return `${val.toFixed(i === 0 ? 0 : 1)} ${units[i]}`;
}
export function formatNumber(n: number): string {
return n.toLocaleString();
}
export function timeAgo(dateStr: string): string {
const seconds = Math.floor((Date.now() - new Date(dateStr).getTime()) / 1000);
if (seconds < 60) return `${seconds}s ago`;
const minutes = Math.floor(seconds / 60);
if (minutes < 60) return `${minutes}m ago`;
const hours = Math.floor(minutes / 60);
if (hours < 24) return `${hours}h ago`;
const days = Math.floor(hours / 24);
return `${days}d ago`;
}
export function truncateHash(hash: string, len = 12): string {
if (hash.startsWith('sha256:')) {
return hash.slice(0, 7 + len);
}
return hash.slice(0, len);
}