Greenfield Go multi-tenant IPFS Pinning Service wire-compatible with the
IPFS Pinning Services API spec. Paired 1:1 with Kubo over localhost RPC,
clustered via embedded NATS JetStream, Postgres source-of-truth with
RLS-enforced tenancy, Fiber + huma v2 for the HTTP surface, Authentik
OIDC for session login with kid-rotated HS256 JWT API tokens.
Feature-complete against the 22-milestone build plan, including the
ship-it v1.0 gap items:
* admin CLIs: drain/uncordon, maintenance, mint-token, rotate-key,
prune-denylist, rebalance --dry-run, cache-stats, cluster-presences
* TTL leader election via NATS KV, fence tokens, JetStream dedup
* rebalancer (plan/apply split), reconciler, requeue sweeper
* ristretto caches with NATS-backed cross-node invalidation
(placements live-nodes + token denylist)
* maintenance watchdog for stuck cluster-pause flag
* Prometheus /metrics with CIDR ACL, HTTP/pin/scheduler/cache gauges
* rate limiting: session (10/min) + anonymous global (120/min)
* integration tests: rebalance, refcount multi-org, RLS belt
* goreleaser (tar + deb/rpm/apk + Alpine Docker) targeting Gitea
Stack: Cobra/Viper, Fiber v2 + huma v2, embedded NATS JetStream,
pgx/sqlc/golang-migrate, ristretto, TypeID, prometheus/client_golang,
testcontainers-go.
38 lines
1.1 KiB
SQL
38 lines
1.1 KiB
SQL
-- name: UpsertNode :one
|
|
INSERT INTO nodes (id, display_name, multiaddrs, rpc_url, status)
|
|
VALUES ($1, $2, $3, $4, 'up')
|
|
ON CONFLICT (id) DO UPDATE
|
|
SET display_name = EXCLUDED.display_name,
|
|
multiaddrs = EXCLUDED.multiaddrs,
|
|
rpc_url = EXCLUDED.rpc_url,
|
|
status = CASE WHEN nodes.status = 'drained' THEN 'drained' ELSE 'up' END,
|
|
last_seen_at = now()
|
|
RETURNING *;
|
|
|
|
-- name: GetNode :one
|
|
SELECT * FROM nodes WHERE id = $1;
|
|
|
|
-- name: ListLiveNodes :many
|
|
SELECT * FROM nodes WHERE status = 'up' ORDER BY id;
|
|
|
|
-- name: ListAllNodes :many
|
|
SELECT * FROM nodes ORDER BY id;
|
|
|
|
-- name: TouchNodeHeartbeat :exec
|
|
UPDATE nodes SET last_seen_at = now() WHERE id = $1;
|
|
|
|
-- name: MarkNodeDown :exec
|
|
UPDATE nodes SET status = 'down' WHERE id = $1 AND status = 'up';
|
|
|
|
-- name: DrainNode :exec
|
|
UPDATE nodes SET status = 'drained' WHERE id = $1;
|
|
|
|
-- name: UncordonNode :exec
|
|
UPDATE nodes SET status = 'up' WHERE id = $1 AND status = 'drained';
|
|
|
|
-- name: MarkStaleNodesDown :many
|
|
UPDATE nodes
|
|
SET status = 'down'
|
|
WHERE status = 'up' AND last_seen_at < (now() - make_interval(secs => $1))
|
|
RETURNING id;
|