Compare commits
1 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
 unkinben
|
1cca9fef00 |
+46
-5
@@ -1,6 +1,47 @@
|
|||||||
bin/
|
# Python
|
||||||
/terraform/
|
__pycache__/
|
||||||
|
*.py[cod]
|
||||||
|
*$py.class
|
||||||
|
*.so
|
||||||
|
.Python
|
||||||
|
build/
|
||||||
|
develop-eggs/
|
||||||
|
dist/
|
||||||
|
downloads/
|
||||||
|
eggs/
|
||||||
|
.eggs/
|
||||||
|
lib/
|
||||||
|
lib64/
|
||||||
|
parts/
|
||||||
|
sdist/
|
||||||
|
var/
|
||||||
|
wheels/
|
||||||
|
*.egg-info/
|
||||||
|
.installed.cfg
|
||||||
|
*.egg
|
||||||
|
MANIFEST
|
||||||
|
|
||||||
# e2e-docker fixtures are real package files (.rpm, .tgz, .whl, .zip, ...) that
|
# Virtual environment
|
||||||
# are intentionally tracked, overriding any global ignore of those extensions.
|
.venv/
|
||||||
!e2e-docker/fixtures/**
|
venv/
|
||||||
|
ENV/
|
||||||
|
env/
|
||||||
|
|
||||||
|
# IDE
|
||||||
|
.vscode/
|
||||||
|
.idea/
|
||||||
|
*.swp
|
||||||
|
*.swo
|
||||||
|
|
||||||
|
# Environment variables
|
||||||
|
.env
|
||||||
|
remotes.yaml
|
||||||
|
|
||||||
|
# Logs
|
||||||
|
*.log
|
||||||
|
|
||||||
|
# uv
|
||||||
|
uv.lock
|
||||||
|
|
||||||
|
# Docker volumes
|
||||||
|
minio_data/
|
||||||
|
|||||||
@@ -1,24 +0,0 @@
|
|||||||
repos:
|
|
||||||
- repo: https://github.com/pre-commit/pre-commit-hooks
|
|
||||||
rev: v5.0.0
|
|
||||||
hooks:
|
|
||||||
- id: trailing-whitespace
|
|
||||||
- id: end-of-file-fixer
|
|
||||||
- id: check-yaml
|
|
||||||
- id: check-added-large-files
|
|
||||||
- id: check-merge-conflict
|
|
||||||
|
|
||||||
- repo: https://github.com/dnephin/pre-commit-golang
|
|
||||||
rev: v0.5.1
|
|
||||||
hooks:
|
|
||||||
- id: go-fmt
|
|
||||||
- id: go-mod-tidy
|
|
||||||
|
|
||||||
- repo: local
|
|
||||||
hooks:
|
|
||||||
- id: go-vet
|
|
||||||
name: go vet
|
|
||||||
entry: go vet ./...
|
|
||||||
language: system
|
|
||||||
types: [go]
|
|
||||||
pass_filenames: false
|
|
||||||
@@ -1,9 +0,0 @@
|
|||||||
when:
|
|
||||||
- event: pull_request
|
|
||||||
|
|
||||||
steps:
|
|
||||||
- name: docker-build
|
|
||||||
image: woodpeckerci/plugin-docker-buildx
|
|
||||||
settings:
|
|
||||||
repo: git.unkin.net/unkin/artifactapi
|
|
||||||
dry_run: true
|
|
||||||
@@ -1,48 +0,0 @@
|
|||||||
when:
|
|
||||||
- event: tag
|
|
||||||
ref: refs/tags/v*
|
|
||||||
|
|
||||||
steps:
|
|
||||||
- name: docker-api
|
|
||||||
image: artifactapi.k8s.syd1.au.unkin.net/docker-internal/plugin-docker-buildx:latest
|
|
||||||
settings:
|
|
||||||
registry: artifactapi.k8s.syd1.au.unkin.net
|
|
||||||
repo: artifactapi.k8s.syd1.au.unkin.net/docker-internal/artifactapi
|
|
||||||
build_args:
|
|
||||||
VERSION: ${CI_COMMIT_TAG}
|
|
||||||
tags:
|
|
||||||
- ${CI_COMMIT_TAG}
|
|
||||||
- latest
|
|
||||||
backend_options:
|
|
||||||
kubernetes:
|
|
||||||
serviceAccountName: default
|
|
||||||
resources:
|
|
||||||
requests:
|
|
||||||
memory: 1Gi
|
|
||||||
cpu: 1
|
|
||||||
limits:
|
|
||||||
memory: 4Gi
|
|
||||||
cpu: 2
|
|
||||||
|
|
||||||
- name: docker-web
|
|
||||||
image: artifactapi.k8s.syd1.au.unkin.net/docker-internal/plugin-docker-buildx:latest
|
|
||||||
settings:
|
|
||||||
registry: artifactapi.k8s.syd1.au.unkin.net
|
|
||||||
repo: artifactapi.k8s.syd1.au.unkin.net/docker-internal/artifactapi-ui
|
|
||||||
dockerfile: ui/Dockerfile.ui
|
|
||||||
context: ui
|
|
||||||
build_args:
|
|
||||||
BASE_PATH: /ui
|
|
||||||
tags:
|
|
||||||
- ${CI_COMMIT_TAG}
|
|
||||||
- latest
|
|
||||||
backend_options:
|
|
||||||
kubernetes:
|
|
||||||
serviceAccountName: default
|
|
||||||
resources:
|
|
||||||
requests:
|
|
||||||
memory: 1Gi
|
|
||||||
cpu: 1
|
|
||||||
limits:
|
|
||||||
memory: 4Gi
|
|
||||||
cpu: 2
|
|
||||||
@@ -1,34 +0,0 @@
|
|||||||
when:
|
|
||||||
- event: pull_request
|
|
||||||
|
|
||||||
steps:
|
|
||||||
- name: pre-commit
|
|
||||||
# gobuilder trusts the internal CA, which the S3 build cache endpoint needs.
|
|
||||||
# go-cache-plugin is baked into the image; S3 errors degrade to cache misses.
|
|
||||||
image: "artifactapi.k8s.syd1.au.unkin.net/docker-internal/gobuilder:0.1.2-alma9"
|
|
||||||
commands:
|
|
||||||
- uvx pre-commit run --all-files
|
|
||||||
environment:
|
|
||||||
# golib lives on Gitea; skip the public proxy/sum db.
|
|
||||||
GOPRIVATE: git.unkin.net
|
|
||||||
GOCACHEPROG: "go-cache-plugin --cache-dir=/tmp/gocache"
|
|
||||||
GOCACHE_S3_BUCKET: gocache
|
|
||||||
# Explicit region skips a GetBucketLocation probe RGW handles poorly.
|
|
||||||
GOCACHE_S3_REGION: us-east-1
|
|
||||||
GOCACHE_S3_ENDPOINT_URL: "https://s3.ceph.unkin.net"
|
|
||||||
GOCACHE_S3_PATH_STYLE: "true"
|
|
||||||
GOCACHE_KEY_PREFIX: ci-artifactapi
|
|
||||||
AWS_ACCESS_KEY_ID:
|
|
||||||
from_secret: GOCACHE_AWS_ACCESS_KEY_ID
|
|
||||||
AWS_SECRET_ACCESS_KEY:
|
|
||||||
from_secret: GOCACHE_AWS_SECRET_ACCESS_KEY
|
|
||||||
backend_options:
|
|
||||||
kubernetes:
|
|
||||||
serviceAccountName: default
|
|
||||||
resources:
|
|
||||||
requests:
|
|
||||||
memory: 512Mi
|
|
||||||
cpu: 1
|
|
||||||
limits:
|
|
||||||
memory: 2Gi
|
|
||||||
cpu: 2
|
|
||||||
@@ -1,34 +0,0 @@
|
|||||||
when:
|
|
||||||
- event: pull_request
|
|
||||||
|
|
||||||
steps:
|
|
||||||
- name: test
|
|
||||||
# gobuilder trusts the internal CA, which the S3 build cache endpoint needs.
|
|
||||||
# go-cache-plugin is baked into the image; S3 errors degrade to cache misses.
|
|
||||||
image: "artifactapi.k8s.syd1.au.unkin.net/docker-internal/gobuilder:0.1.2-alma9"
|
|
||||||
commands:
|
|
||||||
- go test -race -count=1 ./pkg/... ./internal/...
|
|
||||||
environment:
|
|
||||||
# golib lives on Gitea; skip the public proxy/sum db.
|
|
||||||
GOPRIVATE: git.unkin.net
|
|
||||||
GOCACHEPROG: "go-cache-plugin --cache-dir=/tmp/gocache"
|
|
||||||
GOCACHE_S3_BUCKET: gocache
|
|
||||||
# Explicit region skips a GetBucketLocation probe RGW handles poorly.
|
|
||||||
GOCACHE_S3_REGION: us-east-1
|
|
||||||
GOCACHE_S3_ENDPOINT_URL: "https://s3.ceph.unkin.net"
|
|
||||||
GOCACHE_S3_PATH_STYLE: "true"
|
|
||||||
GOCACHE_KEY_PREFIX: ci-artifactapi
|
|
||||||
AWS_ACCESS_KEY_ID:
|
|
||||||
from_secret: GOCACHE_AWS_ACCESS_KEY_ID
|
|
||||||
AWS_SECRET_ACCESS_KEY:
|
|
||||||
from_secret: GOCACHE_AWS_SECRET_ACCESS_KEY
|
|
||||||
backend_options:
|
|
||||||
kubernetes:
|
|
||||||
serviceAccountName: default
|
|
||||||
resources:
|
|
||||||
requests:
|
|
||||||
memory: 1Gi
|
|
||||||
cpu: 1
|
|
||||||
limits:
|
|
||||||
memory: 4Gi
|
|
||||||
cpu: 2
|
|
||||||
+42
-14
@@ -1,25 +1,53 @@
|
|||||||
FROM golang:1.25-alpine AS builder
|
# Use Alpine Linux as base image
|
||||||
|
FROM python:3.11-alpine
|
||||||
|
|
||||||
RUN apk add --no-cache git
|
# Set working directory
|
||||||
|
WORKDIR /app
|
||||||
|
|
||||||
WORKDIR /build
|
# Install system dependencies
|
||||||
|
RUN apk add --no-cache \
|
||||||
|
gcc \
|
||||||
|
musl-dev \
|
||||||
|
libffi-dev \
|
||||||
|
postgresql-dev \
|
||||||
|
curl \
|
||||||
|
wget \
|
||||||
|
tar
|
||||||
|
|
||||||
# golib is fetched straight from Gitea; the public proxy and sum db have no
|
# Install uv
|
||||||
# view of git.unkin.net modules.
|
ARG PACKAGE_VERSION=0.9.21
|
||||||
ENV GOPRIVATE=git.unkin.net
|
RUN wget -O /app/uv-x86_64-unknown-linux-musl.tar.gz https://github.com/astral-sh/uv/releases/download/${PACKAGE_VERSION}/uv-x86_64-unknown-linux-musl.tar.gz && \
|
||||||
|
tar xf /app/uv-x86_64-unknown-linux-musl.tar.gz -C /app && \
|
||||||
|
mv /app/uv-x86_64-unknown-linux-musl/uv /usr/local/bin/uv && \
|
||||||
|
rm -rf /app/uv-x86_64-unknown-linux-musl* && \
|
||||||
|
chmod +x /usr/local/bin/uv && \
|
||||||
|
uv --version
|
||||||
|
|
||||||
COPY go.mod go.sum ./
|
# Copy CA bundle from host
|
||||||
RUN go mod download
|
COPY ca-bundle.pem /app/ca-bundle.pem
|
||||||
|
RUN chmod 644 /app/ca-bundle.pem
|
||||||
|
|
||||||
COPY . .
|
# Create non-root user first
|
||||||
|
RUN adduser -D -s /bin/sh appuser && \
|
||||||
|
chown -R appuser:appuser /app
|
||||||
|
|
||||||
ARG VERSION=dev
|
# Copy dependency files and change ownership
|
||||||
RUN CGO_ENABLED=0 go build -ldflags="-s -w -X main.version=${VERSION}" -o artifactapi ./cmd/artifactapi
|
COPY --chown=appuser:appuser pyproject.toml uv.lock README.md ./
|
||||||
|
|
||||||
FROM gcr.io/distroless/static-debian12:nonroot
|
# Switch to appuser and install Python dependencies
|
||||||
|
USER appuser
|
||||||
|
RUN uv sync --frozen
|
||||||
|
|
||||||
COPY --from=builder /build/artifactapi /usr/local/bin/artifactapi
|
# Copy application source
|
||||||
|
COPY --chown=appuser:appuser src/ ./src/
|
||||||
|
COPY --chown=appuser:appuser remotes.yaml ./
|
||||||
|
|
||||||
|
# Expose port
|
||||||
EXPOSE 8000
|
EXPOSE 8000
|
||||||
|
|
||||||
ENTRYPOINT ["artifactapi"]
|
# Health check
|
||||||
|
HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
|
||||||
|
CMD curl -f http://localhost:8000/health || exit 1
|
||||||
|
|
||||||
|
# Run the application
|
||||||
|
CMD ["uv", "run", "python", "-m", "src.artifactapi.main"]
|
||||||
@@ -1,76 +1,49 @@
|
|||||||
.PHONY: build test lint fmt e2e docker-e2e docker docker-ui compose clean tidy check-go
|
.PHONY: build install dev clean test lint format docker-build docker-up docker-down docker-logs docker-rebuild docker-clean docker-restart
|
||||||
|
|
||||||
BINARY := bin/artifactapi
|
build:
|
||||||
MODULE := git.unkin.net/unkin/artifactapi
|
docker build --no-cache -t artifactapi:latest .
|
||||||
VERSION ?= $(shell git describe --tags --always --dirty 2>/dev/null || echo "0.0.0-dev")
|
|
||||||
GO_VERSION_REQUIRED := 1.23
|
|
||||||
GO_VERSION_ACTUAL := $(shell go version | sed 's/go version go\([0-9]*\.[0-9]*\).*/\1/')
|
|
||||||
|
|
||||||
# git.unkin.net modules (golib) are fetched straight from Gitea, never via the
|
install: build
|
||||||
# public proxy or sum db, which have no view of them. Exported here rather than
|
|
||||||
# written with `go env -w`, so a fresh checkout needs no machine-local setup.
|
|
||||||
export GOPRIVATE := git.unkin.net
|
|
||||||
|
|
||||||
check-go:
|
docker-build: build
|
||||||
@if [ "$$(printf '%s\n%s' "$(GO_VERSION_REQUIRED)" "$(GO_VERSION_ACTUAL)" | sort -V | head -1)" != "$(GO_VERSION_REQUIRED)" ]; then \
|
|
||||||
echo "ERROR: Go >= $(GO_VERSION_REQUIRED) required, found $(GO_VERSION_ACTUAL)"; exit 1; \
|
|
||||||
fi
|
|
||||||
|
|
||||||
build: check-go tidy
|
dev: build
|
||||||
go build -ldflags="-s -w -X main.version=$(VERSION)" -o $(BINARY) ./cmd/artifactapi
|
uv sync --dev
|
||||||
|
|
||||||
test: check-go
|
|
||||||
go test -race -count=1 ./pkg/... ./internal/...
|
|
||||||
|
|
||||||
lint: check-go
|
|
||||||
golangci-lint run ./...
|
|
||||||
go vet ./...
|
|
||||||
|
|
||||||
fmt: check-go
|
|
||||||
gofmt -w .
|
|
||||||
goimports -w .
|
|
||||||
|
|
||||||
e2e: check-go
|
|
||||||
TESTCONTAINERS_RYUK_DISABLED=true go test -tags=e2e -race -count=1 -timeout=5m ./e2e/...
|
|
||||||
|
|
||||||
# Build the container, bring up the full docker-compose stack + a mock upstream,
|
|
||||||
# and run the black-box suite against the running product.
|
|
||||||
docker-e2e: check-go
|
|
||||||
./scripts/docker-e2e.sh
|
|
||||||
|
|
||||||
docker:
|
|
||||||
docker build -t artifactapi:$(VERSION) .
|
|
||||||
|
|
||||||
docker-ui:
|
|
||||||
docker build -t artifactapi-ui:$(VERSION) -f ui/Dockerfile.ui ui/
|
|
||||||
|
|
||||||
compose:
|
|
||||||
docker compose up -d
|
|
||||||
|
|
||||||
clean:
|
clean:
|
||||||
rm -rf bin/
|
rm -rf .venv
|
||||||
|
rm -rf build/
|
||||||
|
rm -rf dist/
|
||||||
|
rm -rf *.egg-info/
|
||||||
|
|
||||||
tidy:
|
test:
|
||||||
go mod tidy
|
uv run pytest
|
||||||
|
|
||||||
# Bump helpers — reads the latest semver tag and creates the next one.
|
lint:
|
||||||
_LATEST := $(shell git tag --sort=-v:refname | grep -E '^v[0-9]+\.[0-9]+\.[0-9]+$$' | head -1)
|
uv run ruff check --fix .
|
||||||
_BASE := $(if $(_LATEST),$(_LATEST),v0.0.0)
|
|
||||||
_MAJ := $(shell echo $(_BASE) | sed 's/^v//' | cut -d. -f1)
|
|
||||||
_MIN := $(shell echo $(_BASE) | sed 's/^v//' | cut -d. -f2)
|
|
||||||
_PAT := $(shell echo $(_BASE) | sed 's/^v//' | cut -d. -f3)
|
|
||||||
|
|
||||||
patch:
|
format:
|
||||||
@NEW=v$(_MAJ).$(_MIN).$(shell expr $(_PAT) + 1); \
|
uv run ruff format .
|
||||||
git tag $$NEW && echo "Tagged $$NEW" && $(MAKE) _tag TAG=$$NEW
|
|
||||||
|
|
||||||
minor:
|
run:
|
||||||
@NEW=v$(_MAJ).$(shell expr $(_MIN) + 1).0; \
|
uv venv --python 3.11 && \
|
||||||
git tag $$NEW && echo "Tagged $$NEW" && $(MAKE) _tag TAG=$$NEW
|
source .venv/bin/activate && \
|
||||||
|
uv run python -m src.artifactapi.main
|
||||||
|
|
||||||
major:
|
docker-up:
|
||||||
@NEW=v$(shell expr $(_MAJ) + 1).0.0; \
|
docker-compose up --build --force-recreate -d
|
||||||
git tag $$NEW && echo "Tagged $$NEW" && $(MAKE) _tag TAG=$$NEW
|
|
||||||
|
|
||||||
_tag:
|
docker-down:
|
||||||
git push origin $(TAG)
|
docker-compose down
|
||||||
|
|
||||||
|
docker-logs:
|
||||||
|
docker-compose logs -f
|
||||||
|
|
||||||
|
docker-rebuild:
|
||||||
|
docker-compose build --no-cache
|
||||||
|
|
||||||
|
docker-clean:
|
||||||
|
docker-compose down -v --remove-orphans
|
||||||
|
docker system prune -f
|
||||||
|
|
||||||
|
docker-restart: docker-down docker-up
|
||||||
|
|||||||
@@ -1,880 +0,0 @@
|
|||||||
# ArtifactAPI v3 — Go Rewrite Plan
|
|
||||||
|
|
||||||
## Context
|
|
||||||
|
|
||||||
ArtifactAPI is a production artifact proxy/cache serving ~42 remotes (Docker registries, Helm repos, RPM/Alpine repos, GitHub releases, PyPI, npm, Puppet Forge, Terraform registries, Go module proxies) across a Kubernetes cluster. The current Python (FastAPI) implementation works but has architectural debt: opaque hashed S3 paths, no UI for visibility, YAML config files that drift, no garbage collection, no access logging, and virtual repos limited to Helm only.
|
|
||||||
|
|
||||||
The v3 rewrite targets: a single Go binary (API + TUI), a separate React frontend (own Dockerfile), a Terraform provider (separate repo), content-addressable storage, and a cleaner data model that makes the cache inspectable and manageable.
|
|
||||||
|
|
||||||
**Repo**: Same repo (`git.unkin.net/unkin/artifactapi`), new branch.
|
|
||||||
**Module**: `git.unkin.net/unkin/artifactapi`
|
|
||||||
**Frontend**: React + Vite, separate Dockerfile, talks to API
|
|
||||||
**Terraform provider**: Separate repo (`terraform-provider-artifactapi`)
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Architecture Overview
|
|
||||||
|
|
||||||
```
|
|
||||||
┌───────────────────────────────────┐ ┌──────────────────────┐
|
|
||||||
│ Go Binary (API + TUI) │ │ Frontend Container │
|
|
||||||
│ │ │ │
|
|
||||||
│ ┌──────────┐ ┌───────────────┐ │ │ React + Vite SPA │
|
|
||||||
│ │ REST API │ │ Proxy Engine │ │◄───│ nginx / node serve │
|
|
||||||
│ │ /api/v2 │ │ /api/v1/... │ │ │ Dockerfile.ui │
|
|
||||||
│ │ │ │ /v2/... (OCI) │ │ └──────────────────────┘
|
|
||||||
│ └────┬─────┘ └──────┬────────┘ │
|
|
||||||
│ │ │ │ ┌──────────────────────┐
|
|
||||||
│ ┌────┴───────────────┴────────┐ │ │ Terraform Provider │
|
|
||||||
│ │ Data Layer │ │◄───│ (separate repo) │
|
|
||||||
│ │ PostgreSQL · Redis · S3 │ │ └──────────────────────┘
|
|
||||||
│ └─────────────────────────────┘ │
|
|
||||||
│ │ ┌──────────────────────┐
|
|
||||||
│ ┌─────────────────────────────┐ │ │ TUI (subcommand) │
|
|
||||||
│ │ artifactapi tui │──│───►│ artifactapi tui │
|
|
||||||
│ └─────────────────────────────┘ │ │ --endpoint <url> │
|
|
||||||
└───────────────────────────────────┘ └──────────────────────┘
|
|
||||||
```
|
|
||||||
|
|
||||||
Three independent deployment units:
|
|
||||||
1. **Go binary** — API server + TUI subcommand (single `Dockerfile`)
|
|
||||||
2. **React frontend** — SPA served by nginx (`Dockerfile.ui`), talks to `/api/v2`
|
|
||||||
3. **Terraform provider** — separate repo, calls `/api/v2` CRUD
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Project Structure (Modular)
|
|
||||||
|
|
||||||
```
|
|
||||||
artifactapi/
|
|
||||||
├── cmd/
|
|
||||||
│ └── artifactapi/
|
|
||||||
│ └── main.go # entrypoint: serve / tui subcommands
|
|
||||||
│
|
|
||||||
├── pkg/ # PUBLIC — importable by terraform provider, CLI tools
|
|
||||||
│ ├── models/ # shared domain types
|
|
||||||
│ │ ├── remote.go # Remote, RemoteConfig, PackageType enum
|
|
||||||
│ │ ├── virtual.go # Virtual, VirtualConfig
|
|
||||||
│ │ ├── artifact.go # Artifact, Blob, AccessLogEntry
|
|
||||||
│ │ ├── local.go # LocalFile, LocalRepo
|
|
||||||
│ │ └── stats.go # RemoteStats, OverviewStats
|
|
||||||
│ └── client/ # typed Go API client (used by TUI + Terraform provider)
|
|
||||||
│ ├── client.go # Client struct, base HTTP
|
|
||||||
│ ├── remotes.go # remote CRUD methods
|
|
||||||
│ ├── virtuals.go # virtual CRUD methods
|
|
||||||
│ ├── objects.go # object browse/evict methods
|
|
||||||
│ └── stats.go # stats methods
|
|
||||||
│
|
|
||||||
├── internal/ # PRIVATE — server internals
|
|
||||||
│ ├── server/
|
|
||||||
│ │ ├── server.go # HTTP server setup, router
|
|
||||||
│ │ └── middleware.go # logging, recovery, request-id, access logging
|
|
||||||
│ │
|
|
||||||
│ ├── api/
|
|
||||||
│ │ ├── v1/ # proxy endpoints (v1 compat)
|
|
||||||
│ │ │ ├── proxy.go # GET /api/v1/remote/{name}/{path}
|
|
||||||
│ │ │ ├── docker.go # /v2/{name}/{path}
|
|
||||||
│ │ │ ├── virtual.go # GET /api/v1/virtual/{name}/{path}
|
|
||||||
│ │ │ └── local.go # CRUD /api/v1/local/{name}/{path}
|
|
||||||
│ │ └── v2/ # management API
|
|
||||||
│ │ ├── remotes.go # CRUD + stats
|
|
||||||
│ │ ├── virtuals.go # CRUD
|
|
||||||
│ │ ├── objects.go # browse/evict cached objects
|
|
||||||
│ │ ├── stats.go # overview, top-remotes
|
|
||||||
│ │ ├── events.go # SSE stream
|
|
||||||
│ │ └── health.go # health, metrics
|
|
||||||
│ │
|
|
||||||
│ ├── provider/ # package-type providers (registry protocol handlers)
|
|
||||||
│ │ ├── provider.go # Provider interface + registry
|
|
||||||
│ │ ├── generic/
|
|
||||||
│ │ │ ├── generic.go
|
|
||||||
│ │ │ └── generic_test.go
|
|
||||||
│ │ ├── docker/
|
|
||||||
│ │ │ ├── docker.go # OCI Distribution v2 via go-containerregistry
|
|
||||||
│ │ │ ├── auth.go # Bearer token fetch + cache
|
|
||||||
│ │ │ └── docker_test.go
|
|
||||||
│ │ ├── helm/
|
|
||||||
│ │ │ ├── helm.go # index rewriting via helm.sh/helm/v3/pkg/repo
|
|
||||||
│ │ │ ├── merger.go # virtual index merge
|
|
||||||
│ │ │ └── helm_test.go
|
|
||||||
│ │ ├── pypi/
|
|
||||||
│ │ │ ├── pypi.go # simple index HTML rewriting
|
|
||||||
│ │ │ ├── merger.go # virtual simple index merge
|
|
||||||
│ │ │ └── pypi_test.go
|
|
||||||
│ │ ├── npm/
|
|
||||||
│ │ │ ├── npm.go # metadata JSON rewriting
|
|
||||||
│ │ │ └── npm_test.go
|
|
||||||
│ │ ├── rpm/
|
|
||||||
│ │ │ ├── rpm.go # repodata patterns
|
|
||||||
│ │ │ └── rpm_test.go
|
|
||||||
│ │ ├── alpine/
|
|
||||||
│ │ │ ├── alpine.go # APKINDEX patterns
|
|
||||||
│ │ │ └── alpine_test.go
|
|
||||||
│ │ ├── puppet/
|
|
||||||
│ │ │ ├── puppet.go # file_uri JSON rewriting
|
|
||||||
│ │ │ └── puppet_test.go
|
|
||||||
│ │ ├── terraform/
|
|
||||||
│ │ │ ├── terraform.go # registry protocol, download URL rewriting
|
|
||||||
│ │ │ └── terraform_test.go
|
|
||||||
│ │ └── goproxy/
|
|
||||||
│ │ ├── goproxy.go # Go module proxy protocol (GOPROXY)
|
|
||||||
│ │ └── goproxy_test.go
|
|
||||||
│ │
|
|
||||||
│ ├── proxy/
|
|
||||||
│ │ ├── engine.go # core fetch-or-cache logic
|
|
||||||
│ │ ├── engine_test.go
|
|
||||||
│ │ ├── classifier.go # immutable vs mutable classification
|
|
||||||
│ │ ├── classifier_test.go
|
|
||||||
│ │ ├── revalidator.go # conditional HEAD requests (ETag/Last-Modified)
|
|
||||||
│ │ └── circuit.go # per-remote circuit breaker
|
|
||||||
│ │
|
|
||||||
│ ├── storage/
|
|
||||||
│ │ ├── s3.go # S3 client (minio-go — works with MinIO, Ceph, AWS)
|
|
||||||
│ │ ├── s3_test.go
|
|
||||||
│ │ ├── cas.go # content-addressable store logic
|
|
||||||
│ │ └── cas_test.go
|
|
||||||
│ │
|
|
||||||
│ ├── cache/
|
|
||||||
│ │ ├── redis.go # TTL management, fetch locks
|
|
||||||
│ │ ├── redis_test.go
|
|
||||||
│ │ └── lock.go # distributed lock abstraction
|
|
||||||
│ │
|
|
||||||
│ ├── database/
|
|
||||||
│ │ ├── postgres.go # connection pool, migration runner
|
|
||||||
│ │ ├── queries/ # SQL query files or sqlc-generated code
|
|
||||||
│ │ │ ├── remotes.sql.go
|
|
||||||
│ │ │ ├── virtuals.sql.go
|
|
||||||
│ │ │ ├── artifacts.sql.go
|
|
||||||
│ │ │ └── access_log.sql.go
|
|
||||||
│ │ └── migrations/ # golang-migrate SQL files
|
|
||||||
│ │ ├── 001_initial.up.sql
|
|
||||||
│ │ └── 001_initial.down.sql
|
|
||||||
│ │
|
|
||||||
│ ├── metrics/
|
|
||||||
│ │ └── prometheus.go # counters, gauges, histograms
|
|
||||||
│ │
|
|
||||||
│ ├── gc/
|
|
||||||
│ │ ├── gc.go # background garbage collection goroutine
|
|
||||||
│ │ └── gc_test.go
|
|
||||||
│ │
|
|
||||||
│ ├── tui/
|
|
||||||
│ │ ├── app.go # Bubble Tea main model
|
|
||||||
│ │ ├── views/
|
|
||||||
│ │ │ ├── dashboard.go
|
|
||||||
│ │ │ ├── remotes.go
|
|
||||||
│ │ │ ├── objects.go
|
|
||||||
│ │ │ └── virtuals.go
|
|
||||||
│ │ └── components/
|
|
||||||
│ │ ├── table.go
|
|
||||||
│ │ └── statusbar.go
|
|
||||||
│ │
|
|
||||||
│ └── config/
|
|
||||||
│ └── env.go # environment variable parsing + validation
|
|
||||||
│
|
|
||||||
├── ui/ # React frontend — SEPARATE DOCKERFILE
|
|
||||||
│ ├── src/
|
|
||||||
│ │ ├── App.tsx
|
|
||||||
│ │ ├── pages/
|
|
||||||
│ │ │ ├── Dashboard.tsx
|
|
||||||
│ │ │ ├── Remotes.tsx
|
|
||||||
│ │ │ ├── RemoteDetail.tsx
|
|
||||||
│ │ │ ├── Virtuals.tsx
|
|
||||||
│ │ │ └── Objects.tsx
|
|
||||||
│ │ ├── components/
|
|
||||||
│ │ │ ├── RemoteTable.tsx
|
|
||||||
│ │ │ ├── ObjectBrowser.tsx
|
|
||||||
│ │ │ ├── StatsCard.tsx
|
|
||||||
│ │ │ └── EventFeed.tsx
|
|
||||||
│ │ └── api/
|
|
||||||
│ │ └── client.ts # typed API client
|
|
||||||
│ ├── package.json
|
|
||||||
│ ├── vite.config.ts
|
|
||||||
│ ├── tsconfig.json
|
|
||||||
│ ├── Dockerfile.ui # multi-stage: node build → nginx
|
|
||||||
│ └── nginx.conf # proxy /api/* to backend, serve SPA
|
|
||||||
│
|
|
||||||
├── e2e/ # end-to-end integration tests
|
|
||||||
│ ├── e2e_test.go # TestMain spins up docker-compose stack
|
|
||||||
│ ├── proxy_test.go # proxy through real remotes
|
|
||||||
│ ├── docker_test.go # Docker v2 protocol e2e
|
|
||||||
│ ├── management_test.go # v2 API CRUD
|
|
||||||
│ ├── virtual_test.go # virtual repo merge e2e
|
|
||||||
│ └── docker-compose.e2e.yml # postgres + redis + minio for tests
|
|
||||||
│
|
|
||||||
├── go.mod
|
|
||||||
├── go.sum
|
|
||||||
├── Makefile
|
|
||||||
├── Dockerfile # Go binary (API server + TUI)
|
|
||||||
├── Dockerfile.ui # symlink or copy → ui/Dockerfile.ui
|
|
||||||
└── docker-compose.yml
|
|
||||||
```
|
|
||||||
|
|
||||||
### Key Modularisation Decisions
|
|
||||||
|
|
||||||
- **`pkg/models/`** — Shared domain types importable by the Terraform provider and any external tooling. No dependencies on internal packages
|
|
||||||
- **`pkg/client/`** — Typed Go API client used by both the TUI and the Terraform provider. Depends only on `pkg/models/` and stdlib
|
|
||||||
- **`internal/provider/`** — Each package type is its own subpackage with isolated tests. A provider registry maps `PackageType → Provider`
|
|
||||||
- **`internal/database/queries/`** — Use [sqlc](https://sqlc.dev/) to generate type-safe query functions from SQL, or hand-written query files
|
|
||||||
- **`e2e/`** — Separate test binary that spins up a real docker-compose stack
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Go Ecosystem Libraries
|
|
||||||
|
|
||||||
Prefer existing, maintained Go modules over writing protocol handlers from scratch.
|
|
||||||
|
|
||||||
### Package-Type Libraries
|
|
||||||
|
|
||||||
| Package Type | Go Module | What It Gives Us |
|
|
||||||
|---|---|---|
|
|
||||||
| **Docker/OCI** | `github.com/google/go-containerregistry` | Full Registry v2/OCI client: manifest parsing, auth challenges, blob operations. `pkg/registry` can implement a v2 server. Reference: `github.com/regclient/regclient` |
|
|
||||||
| **Helm** | `helm.sh/helm/v3/pkg/repo` | Parse/generate `index.yaml`, `IndexFile`/`ChartVersion` types, URL entries. Used directly for merge |
|
|
||||||
| **Terraform** | `github.com/hashicorp/terraform-registry-address` | Provider/module address parsing, `ForRegistryProtocol()` URL generation. Protocol spec: provider registry protocol v1 |
|
|
||||||
| **Go Modules** | `github.com/goproxy/goproxy` | Minimalist GOPROXY protocol handler, implements full spec as `http.Handler`. Handles `/@v/list`, `/@v/{v}.info`, `/@v/{v}.mod`, `/@v/{v}.zip`, `/@latest` |
|
|
||||||
| **RPM** | `rs3.io/go/rpm/repomd` | Parse `repomd.xml`, `primary.xml` with proper XML namespace handling |
|
|
||||||
| **Alpine** | `gitlab.alpinelinux.org/alpine/go` | Official Alpine library: parse APKINDEX, `.apk` files |
|
|
||||||
| **PyPI** | stdlib `golang.org/x/net/html` | No dedicated Go PyPI library exists. Parse simple index HTML with `x/net/html`, extract `<a>` tags. Minimal — the rewriting is just href replacement |
|
|
||||||
| **npm** | stdlib `encoding/json` | npm metadata is JSON — parse with stdlib, rewrite `dist.tarball` URLs. No special library needed |
|
|
||||||
| **Puppet Forge** | stdlib `encoding/json` | Forge API is JSON — parse and rewrite `file_uri` fields. Community lib `github.com/johnmccabe/go-puppetforge` exists but is thin; stdlib suffices |
|
|
||||||
|
|
||||||
### Infrastructure Libraries
|
|
||||||
|
|
||||||
| Purpose | Go Module | Why This One |
|
|
||||||
|---|---|---|
|
|
||||||
| **HTTP router** | `github.com/go-chi/chi/v5` | Lightweight, stdlib `http.Handler` compatible, middleware chain |
|
|
||||||
| **PostgreSQL** | `github.com/jackc/pgx/v5` | Pure Go, connection pooling, COPY support, prepared statements |
|
|
||||||
| **SQL generation** | `github.com/sqlc-dev/sqlc` | Generate type-safe Go from SQL queries — no ORM, no reflection |
|
|
||||||
| **Redis** | `github.com/redis/go-redis/v9` | Full Redis client, pipelining, pub/sub |
|
|
||||||
| **S3 (MinIO/Ceph/AWS)** | `github.com/minio/minio-go/v7` | Native S3-compatible client. Works with MinIO, Ceph RGW, AWS S3, any S3-compatible backend out of the box. Lighter than aws-sdk-go-v2, purpose-built for S3 compat |
|
|
||||||
| **DB migrations** | `github.com/golang-migrate/migrate/v4` | SQL file-based migrations, CLI + library |
|
|
||||||
| **Prometheus** | `github.com/prometheus/client_golang` | Counters, gauges, histograms |
|
|
||||||
| **TUI** | `github.com/charmbracelet/bubbletea` | Elm-architecture TUI framework |
|
|
||||||
| **TUI styling** | `github.com/charmbracelet/lipgloss` | Terminal styling |
|
|
||||||
| **TUI components** | `github.com/charmbracelet/bubbles` | Table, text input, spinner, etc. |
|
|
||||||
| **Structured logging** | `log/slog` (stdlib) | Go 1.21+ structured logging, zero dependencies |
|
|
||||||
| **Testing** | `github.com/stretchr/testify` | Assertions + require for unit tests |
|
|
||||||
| **Test containers** | `github.com/testcontainers/testcontainers-go` | Spin up Postgres/Redis/MinIO in e2e tests |
|
|
||||||
|
|
||||||
### S3 Client: Multi-Backend Support
|
|
||||||
|
|
||||||
Using `minio-go/v7` as the S3 client because it natively supports:
|
|
||||||
- **MinIO** — primary development/production target
|
|
||||||
- **Ceph RGW** — S3-compatible via endpoint config
|
|
||||||
- **AWS S3** — via region + credential config
|
|
||||||
- **Any S3-compatible** — GCS (interop mode), Wasabi, DigitalOcean Spaces, etc.
|
|
||||||
|
|
||||||
No abstraction layer needed — `minio-go` handles endpoint differences internally. Config:
|
|
||||||
```go
|
|
||||||
client, _ := minio.New(endpoint, &minio.Options{
|
|
||||||
Creds: credentials.NewStaticV4(accessKey, secretKey, ""),
|
|
||||||
Secure: useTLS,
|
|
||||||
Region: region, // optional, for AWS
|
|
||||||
})
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Data Layer
|
|
||||||
|
|
||||||
### PostgreSQL Schema
|
|
||||||
|
|
||||||
```sql
|
|
||||||
-- Remotes: managed exclusively by Terraform
|
|
||||||
CREATE TABLE remotes (
|
|
||||||
name TEXT PRIMARY KEY,
|
|
||||||
package_type TEXT NOT NULL, -- generic, docker, helm, pypi, npm, rpm, alpine, puppet, terraform, goproxy
|
|
||||||
base_url TEXT NOT NULL,
|
|
||||||
description TEXT DEFAULT '',
|
|
||||||
username TEXT DEFAULT '',
|
|
||||||
password TEXT DEFAULT '',
|
|
||||||
immutable_ttl INTEGER DEFAULT 0,
|
|
||||||
mutable_ttl INTEGER DEFAULT 3600,
|
|
||||||
check_mutable BOOLEAN DEFAULT TRUE,
|
|
||||||
immutable_patterns TEXT[] DEFAULT '{}', -- user-defined immutable patterns
|
|
||||||
mutable_patterns TEXT[] DEFAULT '{}', -- user-defined mutable patterns (merged with provider built-ins)
|
|
||||||
allowlist TEXT[] DEFAULT '{}', -- if empty, allow all paths; if non-empty, only matching paths proxied
|
|
||||||
blocklist TEXT[] DEFAULT '{}', -- always denied, checked before allowlist
|
|
||||||
ban_tags_enabled BOOLEAN DEFAULT FALSE,
|
|
||||||
ban_tags TEXT[] DEFAULT '{}',
|
|
||||||
quarantine_enabled BOOLEAN DEFAULT FALSE,
|
|
||||||
quarantine_days INTEGER DEFAULT 3,
|
|
||||||
stale_on_error BOOLEAN DEFAULT TRUE,
|
|
||||||
releases_remote TEXT DEFAULT '', -- terraform type: name of CDN remote for download URL rewriting
|
|
||||||
managed_by TEXT DEFAULT '', -- 'terraform' or empty
|
|
||||||
created_at TIMESTAMPTZ DEFAULT NOW(),
|
|
||||||
updated_at TIMESTAMPTZ DEFAULT NOW()
|
|
||||||
);
|
|
||||||
|
|
||||||
-- Virtual repositories
|
|
||||||
CREATE TABLE virtuals (
|
|
||||||
name TEXT PRIMARY KEY,
|
|
||||||
package_type TEXT NOT NULL,
|
|
||||||
description TEXT DEFAULT '',
|
|
||||||
members TEXT[] NOT NULL,
|
|
||||||
managed_by TEXT DEFAULT '',
|
|
||||||
created_at TIMESTAMPTZ DEFAULT NOW(),
|
|
||||||
updated_at TIMESTAMPTZ DEFAULT NOW()
|
|
||||||
);
|
|
||||||
|
|
||||||
-- Content-addressable blob storage tracking
|
|
||||||
CREATE TABLE blobs (
|
|
||||||
content_hash TEXT PRIMARY KEY,
|
|
||||||
s3_key TEXT NOT NULL,
|
|
||||||
size_bytes BIGINT NOT NULL,
|
|
||||||
content_type TEXT DEFAULT 'application/octet-stream',
|
|
||||||
created_at TIMESTAMPTZ DEFAULT NOW()
|
|
||||||
);
|
|
||||||
|
|
||||||
-- Artifact metadata: maps (remote, path) → content blob
|
|
||||||
CREATE TABLE artifacts (
|
|
||||||
id BIGSERIAL PRIMARY KEY,
|
|
||||||
remote_name TEXT NOT NULL REFERENCES remotes(name) ON DELETE CASCADE,
|
|
||||||
path TEXT NOT NULL,
|
|
||||||
content_hash TEXT NOT NULL REFERENCES blobs(content_hash),
|
|
||||||
upstream_etag TEXT DEFAULT '',
|
|
||||||
upstream_last_modified TIMESTAMPTZ,
|
|
||||||
first_seen_at TIMESTAMPTZ DEFAULT NOW(),
|
|
||||||
last_fetched_at TIMESTAMPTZ DEFAULT NOW(),
|
|
||||||
last_accessed_at TIMESTAMPTZ DEFAULT NOW(),
|
|
||||||
fetch_count BIGINT DEFAULT 1,
|
|
||||||
access_count BIGINT DEFAULT 1,
|
|
||||||
UNIQUE(remote_name, path)
|
|
||||||
);
|
|
||||||
|
|
||||||
CREATE INDEX idx_artifacts_remote ON artifacts(remote_name);
|
|
||||||
CREATE INDEX idx_artifacts_last_accessed ON artifacts(last_accessed_at);
|
|
||||||
|
|
||||||
-- Local file uploads
|
|
||||||
CREATE TABLE local_files (
|
|
||||||
id BIGSERIAL PRIMARY KEY,
|
|
||||||
repo_name TEXT NOT NULL,
|
|
||||||
file_path TEXT NOT NULL,
|
|
||||||
content_hash TEXT NOT NULL REFERENCES blobs(content_hash),
|
|
||||||
created_at TIMESTAMPTZ DEFAULT NOW(),
|
|
||||||
UNIQUE(repo_name, file_path)
|
|
||||||
);
|
|
||||||
|
|
||||||
-- Access log (append-only, powers dashboards)
|
|
||||||
CREATE TABLE access_log (
|
|
||||||
id BIGSERIAL PRIMARY KEY,
|
|
||||||
remote_name TEXT NOT NULL,
|
|
||||||
path TEXT NOT NULL,
|
|
||||||
cache_hit BOOLEAN NOT NULL,
|
|
||||||
size_bytes BIGINT DEFAULT 0,
|
|
||||||
upstream_ms INTEGER DEFAULT 0,
|
|
||||||
client_ip TEXT DEFAULT '',
|
|
||||||
created_at TIMESTAMPTZ DEFAULT NOW()
|
|
||||||
);
|
|
||||||
|
|
||||||
CREATE INDEX idx_access_log_remote_time ON access_log(remote_name, created_at);
|
|
||||||
```
|
|
||||||
|
|
||||||
### Redis Usage (Ephemeral Only)
|
|
||||||
|
|
||||||
| Key pattern | Type | TTL | Purpose |
|
|
||||||
|---|---|---|---|
|
|
||||||
| `ttl:{remote}:{path}` | STRING | remote's immutable/mutable TTL | Artifact freshness — existence = still fresh |
|
|
||||||
| `lock:{remote}:{path}` | STRING (NX) | 30s | Fetch lock — prevents thundering herd |
|
|
||||||
| `etag:{remote}:{path}` | STRING | same as TTL key | Cached ETag for conditional revalidation |
|
|
||||||
| `circuit:{remote}` | STRING | configurable | Circuit breaker — consecutive failure count |
|
|
||||||
|
|
||||||
Losing Redis = all TTLs expire = next request re-validates upstream. No data loss.
|
|
||||||
|
|
||||||
### S3 Layout (Content-Addressable)
|
|
||||||
|
|
||||||
```
|
|
||||||
artifacts-bucket/
|
|
||||||
├── blobs/sha256/{content_hash} # immutable CAS blobs
|
|
||||||
├── indexes/{remote}/{path} # mutable index files (helm, pypi, rpm, etc.)
|
|
||||||
├── indexes/{virtual}/{path} # merged virtual indexes
|
|
||||||
└── local/{repo}/{path} # user uploads (CAS-backed via blobs table)
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Terraform Remote Type (New in v2)
|
|
||||||
|
|
||||||
The `terraform` package type proxies the Terraform Provider Registry Protocol:
|
|
||||||
|
|
||||||
- **URL construction**: prepends `/v1/providers/` to request paths
|
|
||||||
- **Built-in mutable pattern**: `[^/]+/[^/]+/versions$` (version listings change over time)
|
|
||||||
- **Built-in immutable pattern**: `[^/]+/[^/]+/[^/]+/download/[^/]+/[^/]+$` (per-version download info is fixed)
|
|
||||||
- **Response rewriting**: download info JSON — rewrites `download_url`, `shasums_url`, `shasums_signature_url` to route through a companion `releases_remote` (e.g., `hashicorp-releases` generic remote)
|
|
||||||
- **Config**: requires `releases_remote` field pointing to the CDN remote that serves the actual binaries
|
|
||||||
|
|
||||||
Uses `github.com/hashicorp/terraform-registry-address` for address parsing and protocol-compliant URL generation.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Go Module Proxy Remote Type (New)
|
|
||||||
|
|
||||||
The `goproxy` package type implements the GOPROXY protocol (Go module proxy):
|
|
||||||
|
|
||||||
| Endpoint | Mutability | Description |
|
|
||||||
|---|---|---|
|
|
||||||
| `{module}/@v/list` | Mutable | Plain text list of known versions |
|
|
||||||
| `{module}/@latest` | Mutable | JSON metadata for latest version |
|
|
||||||
| `{module}/@v/{version}.info` | Immutable | JSON version metadata (`Version`, `Time`) |
|
|
||||||
| `{module}/@v/{version}.mod` | Immutable | `go.mod` file for that version |
|
|
||||||
| `{module}/@v/{version}.zip` | Immutable | Source archive for that version |
|
|
||||||
|
|
||||||
- **No URL rewriting needed** — responses are self-contained (no embedded URLs)
|
|
||||||
- **Config**: `base_url` points to upstream proxy (e.g., `https://proxy.golang.org`)
|
|
||||||
- **Client usage**: set `GOPROXY=https://artifactapi.example.com/api/v1/remote/goproxy`
|
|
||||||
- Uses `github.com/goproxy/goproxy` for protocol handling
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Allowlist / Blocklist / Automatic Mutable Patterns
|
|
||||||
|
|
||||||
### Access Control (Per-Remote)
|
|
||||||
|
|
||||||
| Field | Default | Behavior |
|
|
||||||
|---|---|---|
|
|
||||||
| `blocklist` | `[]` (empty) | If a path matches any blocklist pattern → **403 Forbidden**. Checked first |
|
|
||||||
| `allowlist` | `[]` (empty) | If empty → **allow everything**. If non-empty → only matching paths are proxied; everything else → **403** |
|
|
||||||
|
|
||||||
Evaluation order: blocklist → allowlist → proxy. No allowlist + no blocklist = open proxy (default).
|
|
||||||
|
|
||||||
### Automatic Mutable Patterns (Per-Provider Built-ins)
|
|
||||||
|
|
||||||
Each provider declares built-in mutable patterns that are **always merged** with user-defined `mutable_patterns`. Users never need to configure these — the provider knows which paths change over time.
|
|
||||||
|
|
||||||
| Provider | Built-in Mutable Patterns | Rationale |
|
|
||||||
|---|---|---|
|
|
||||||
| **generic** | *(none)* | No convention for what's mutable |
|
|
||||||
| **docker** | `/manifests/(?!sha256:)[^/]+$`, `/tags/list$` | Tag manifests change; digest manifests don't |
|
|
||||||
| **helm** | `index\.yaml$` | Chart index changes when new charts are published |
|
|
||||||
| **pypi** | `simple/` | Package index pages change with new releases |
|
|
||||||
| **npm** | `^[^/]+$` (package metadata, not `.tgz`) | Package metadata changes; tarballs are immutable |
|
|
||||||
| **rpm** | `repomd\.xml$`, `repodata/.*`, `Packages\.gz$` | Repo metadata rebuilt on every publish |
|
|
||||||
| **alpine** | `APKINDEX\.tar\.gz$` | Package index rebuilt on every publish |
|
|
||||||
| **puppet** | `^v3/modules/`, `^v3/releases` | Module metadata changes with new releases |
|
|
||||||
| **terraform** | `[^/]+/[^/]+/versions$` | Provider version listings grow over time |
|
|
||||||
| **goproxy** | `@v/list$`, `@latest$` | Version list and latest pointer change |
|
|
||||||
|
|
||||||
These are returned by `Provider.BuiltinMutablePatterns()` and merged at classification time:
|
|
||||||
```
|
|
||||||
effective_mutable = provider.BuiltinMutablePatterns() ∪ remote.mutable_patterns
|
|
||||||
```
|
|
||||||
|
|
||||||
If a path matches `effective_mutable` → use `mutable_ttl`. If it matches `remote.immutable_patterns` → use `immutable_ttl`. Immutable patterns take precedence over mutable when both match.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## API Design
|
|
||||||
|
|
||||||
### v1 Proxy Endpoints (Backwards Compatible)
|
|
||||||
|
|
||||||
| Method | Path | Description |
|
|
||||||
|---|---|---|
|
|
||||||
| `GET` | `/api/v1/remote/{name}/{path}` | Proxy/cache artifact |
|
|
||||||
| `GET` | `/api/v1/virtual/{name}/{path}` | Virtual repo proxy |
|
|
||||||
| `GET/HEAD` | `/v2/{name}/{path}` | Docker Registry v2 |
|
|
||||||
| `GET` | `/v2/` | Docker v2 ping |
|
|
||||||
| `GET/PUT/HEAD/DELETE` | `/api/v1/local/{name}/{path}` | Local repo CRUD |
|
|
||||||
|
|
||||||
### v2 Management API (New)
|
|
||||||
|
|
||||||
```
|
|
||||||
GET /api/v2/remotes → [{name, package_type, base_url, description, stats}]
|
|
||||||
GET /api/v2/remotes/{name} → {full config + stats + health}
|
|
||||||
POST /api/v2/remotes → create remote (Terraform provider)
|
|
||||||
PUT /api/v2/remotes/{name} → update remote (Terraform provider)
|
|
||||||
DELETE /api/v2/remotes/{name} → delete remote — cascades artifacts, GC cleans S3
|
|
||||||
|
|
||||||
GET /api/v2/virtuals → [{name, package_type, members, stats}]
|
|
||||||
GET /api/v2/virtuals/{name} → {full config + member details}
|
|
||||||
POST /api/v2/virtuals → create virtual
|
|
||||||
PUT /api/v2/virtuals/{name} → update virtual
|
|
||||||
DELETE /api/v2/virtuals/{name} → delete virtual
|
|
||||||
|
|
||||||
GET /api/v2/remotes/{name}/objects → paginated objects
|
|
||||||
?q=pattern&sort=size|accessed|age&page=1&per_page=50
|
|
||||||
DELETE /api/v2/remotes/{name}/objects/{path} → evict specific cached object
|
|
||||||
DELETE /api/v2/remotes/{name}/cache → flush cache
|
|
||||||
?type=all|indexes|blobs
|
|
||||||
|
|
||||||
GET /api/v2/stats → overview stats
|
|
||||||
GET /api/v2/stats/top-remotes → top remotes by size/requests/hit-rate
|
|
||||||
|
|
||||||
GET /api/v2/health → {status, postgres, redis, s3, uptime}
|
|
||||||
GET /metrics → Prometheus format
|
|
||||||
GET /api/v2/events → SSE stream
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Proxy Engine
|
|
||||||
|
|
||||||
### Request Flow
|
|
||||||
|
|
||||||
```
|
|
||||||
Client Request
|
|
||||||
│
|
|
||||||
▼
|
|
||||||
Classify (immutable/mutable/denied)
|
|
||||||
│
|
|
||||||
├── blocklist match → 403
|
|
||||||
├── allowlist non-empty + no match → 403
|
|
||||||
│
|
|
||||||
▼
|
|
||||||
Check Redis TTL key
|
|
||||||
│
|
|
||||||
├── exists (fresh) → serve from S3, log access
|
|
||||||
│
|
|
||||||
├── missing (expired or uncached)
|
|
||||||
│ │
|
|
||||||
│ ▼
|
|
||||||
│ Acquire fetch lock (Redis SETNX, 30s TTL)
|
|
||||||
│ │
|
|
||||||
│ ├── lock acquired
|
|
||||||
│ │ ├── mutable + check_mutable + have ETag → HEAD upstream
|
|
||||||
│ │ │ ├── 304 → refresh TTL, serve from S3
|
|
||||||
│ │ │ └── changed → full fetch
|
|
||||||
│ │ └── full fetch from upstream
|
|
||||||
│ │ → provider.RewriteResponse() if needed
|
|
||||||
│ │ → CAS store (hash → check blobs → upload if new)
|
|
||||||
│ │ → upsert artifact in Postgres
|
|
||||||
│ │ → set Redis TTL + release lock
|
|
||||||
│ │ → on upstream error + stale_on_error → refresh TTL, serve stale
|
|
||||||
│ │
|
|
||||||
│ └── lock not acquired → poll S3 briefly, serve if another pod fetched it
|
|
||||||
│
|
|
||||||
▼
|
|
||||||
Stream response from S3, log access
|
|
||||||
```
|
|
||||||
|
|
||||||
### Circuit Breaker
|
|
||||||
|
|
||||||
Per-remote, tracked in Redis. Closed → Open (after N failures) → Half-open (after cooldown). Exposed via `GET /api/v2/remotes/{name}` health field.
|
|
||||||
|
|
||||||
### Content-Addressable Storage
|
|
||||||
|
|
||||||
1. Stream upstream → temp file, compute SHA256 inline
|
|
||||||
2. Check `blobs` table for hash
|
|
||||||
3. Exists → skip S3 upload, upsert `artifacts` row only
|
|
||||||
4. New → upload to `blobs/sha256/{hash}`, insert both rows
|
|
||||||
|
|
||||||
### Garbage Collection
|
|
||||||
|
|
||||||
Background goroutine (configurable interval, default 1h):
|
|
||||||
1. Orphaned blobs: delete S3 objects whose `content_hash` has no referencing `artifacts` or `local_files` rows
|
|
||||||
2. Cold artifacts: optional per-remote, delete artifacts not accessed in N days
|
|
||||||
3. Remote deletion: `ON DELETE CASCADE` handles Postgres; GC sweeps orphaned blobs
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Package Providers
|
|
||||||
|
|
||||||
### Provider Interface
|
|
||||||
|
|
||||||
```go
|
|
||||||
type Provider interface {
|
|
||||||
Type() models.PackageType
|
|
||||||
BuiltinMutablePatterns() []*regexp.Regexp
|
|
||||||
BuiltinImmutablePatterns() []*regexp.Regexp
|
|
||||||
ContentType(path string) string
|
|
||||||
UpstreamURL(remote models.Remote, path string) string
|
|
||||||
RewriteResponse(body []byte, remote models.Remote, proxyBaseURL string) ([]byte, error)
|
|
||||||
AuthHeaders(ctx context.Context, remote models.Remote) (http.Header, error)
|
|
||||||
}
|
|
||||||
|
|
||||||
type IndexMerger interface {
|
|
||||||
MergeIndexes(members []MemberIndex, proxyBaseURL string) ([]byte, error)
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
### Provider Registry
|
|
||||||
|
|
||||||
```go
|
|
||||||
var registry = map[models.PackageType]Provider{
|
|
||||||
models.PackageGeneric: &generic.Provider{},
|
|
||||||
models.PackageDocker: &docker.Provider{},
|
|
||||||
models.PackageHelm: &helm.Provider{},
|
|
||||||
models.PackagePyPI: &pypi.Provider{},
|
|
||||||
models.PackageNPM: &npm.Provider{},
|
|
||||||
models.PackageRPM: &rpm.Provider{},
|
|
||||||
models.PackageAlpine: &alpine.Provider{},
|
|
||||||
models.PackagePuppet: &puppet.Provider{},
|
|
||||||
models.PackageTerraform: &terraform.Provider{},
|
|
||||||
models.PackageGoProxy: &goproxy.Provider{},
|
|
||||||
}
|
|
||||||
|
|
||||||
func Get(t models.PackageType) (Provider, error) { ... }
|
|
||||||
```
|
|
||||||
|
|
||||||
Each provider lives in its own subpackage under `internal/provider/` with its own `_test.go`.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Testing Strategy
|
|
||||||
|
|
||||||
### Unit Tests
|
|
||||||
|
|
||||||
Every package gets `_test.go` files alongside the source. Run with `go test ./...`.
|
|
||||||
|
|
||||||
| Package | What's Tested |
|
|
||||||
|---|---|
|
|
||||||
| `internal/provider/docker/` | Auth token parsing/caching, manifest classification, tag banning, URL construction, blob key generation |
|
|
||||||
| `internal/provider/helm/` | `index.yaml` parsing (using `helm.sh/helm/v3/pkg/repo`), URL rewriting, index merging |
|
|
||||||
| `internal/provider/pypi/` | Simple index HTML parsing, URL rewriting, index merging |
|
|
||||||
| `internal/provider/npm/` | Metadata JSON rewriting (`dist.tarball` URLs) |
|
|
||||||
| `internal/provider/terraform/` | Registry URL construction, download info JSON rewriting, `releases_remote` URL extraction |
|
|
||||||
| `internal/provider/rpm/` | Mutable pattern matching (repodata) |
|
|
||||||
| `internal/provider/alpine/` | Mutable pattern matching (APKINDEX) |
|
|
||||||
| `internal/provider/puppet/` | `file_uri` JSON rewriting |
|
|
||||||
| `internal/proxy/` | Classifier (immutable vs mutable vs denied), circuit breaker state transitions, revalidator logic |
|
|
||||||
| `internal/storage/` | CAS key generation, dedup detection, S3 operation mocking |
|
|
||||||
| `internal/cache/` | Redis TTL set/check, fetch lock acquire/release/contention |
|
|
||||||
| `internal/gc/` | Orphan detection queries, cold artifact selection |
|
|
||||||
| `pkg/models/` | Model validation, PackageType enum |
|
|
||||||
| `pkg/client/` | API client request/response serialization |
|
|
||||||
|
|
||||||
### End-to-End Tests
|
|
||||||
|
|
||||||
Located in `e2e/`. Use `testcontainers-go` to spin up real Postgres, Redis, and MinIO containers. The test binary starts the actual `artifactapi` server against these backends.
|
|
||||||
|
|
||||||
```go
|
|
||||||
// e2e/e2e_test.go
|
|
||||||
func TestMain(m *testing.M) {
|
|
||||||
// Start postgres, redis, minio via testcontainers-go
|
|
||||||
// Run migrations
|
|
||||||
// Start artifactapi server on random port
|
|
||||||
// Run tests
|
|
||||||
// Tear down
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
| Test File | What's Tested |
|
|
||||||
|---|---|
|
|
||||||
| `e2e/proxy_test.go` | Proxy a real GitHub release through generic remote, verify S3 storage, verify Redis TTL, verify Postgres artifact row, verify cache hit on second request |
|
|
||||||
| `e2e/docker_test.go` | Pull a real image manifest + blob through Docker v2 proxy, verify blob deduplication, tag banning |
|
|
||||||
| `e2e/management_test.go` | Full CRUD lifecycle: create remote via v2 API, proxy through it, list objects, evict object, flush cache, delete remote |
|
|
||||||
| `e2e/virtual_test.go` | Create two helm remotes + virtual, fetch merged index, verify priority ordering |
|
|
||||||
| `e2e/terraform_test.go` | Proxy terraform provider version listing + download info, verify URL rewriting to releases_remote |
|
|
||||||
| `e2e/goproxy_test.go` | Proxy Go module `@v/list`, `.info`, `.mod`, `.zip` through GOPROXY remote, verify mutable vs immutable classification |
|
|
||||||
| `e2e/gc_test.go` | Create artifact, delete remote, trigger GC, verify S3 blob cleaned up |
|
|
||||||
|
|
||||||
### Code Quality
|
|
||||||
|
|
||||||
- `gofmt` / `goimports` — enforced in CI, run on save
|
|
||||||
- `golangci-lint` — comprehensive linter suite (staticcheck, errcheck, govet, etc.)
|
|
||||||
- `go vet ./...` — run in CI
|
|
||||||
- Makefile targets: `make test`, `make lint`, `make e2e`, `make fmt`
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Terraform Provider (Separate Repo)
|
|
||||||
|
|
||||||
**Repo**: `terraform-provider-artifactapi`
|
|
||||||
**Uses**: `pkg/client/` and `pkg/models/` from the main module
|
|
||||||
|
|
||||||
```hcl
|
|
||||||
provider "artifactapi" {
|
|
||||||
endpoint = "https://artifactapi.example.com"
|
|
||||||
}
|
|
||||||
|
|
||||||
resource "artifactapi_remote" "terraform_registry" {
|
|
||||||
name = "terraform-registry"
|
|
||||||
package_type = "terraform"
|
|
||||||
base_url = "https://registry.terraform.io"
|
|
||||||
description = "Terraform provider registry"
|
|
||||||
releases_remote = artifactapi_remote.hashicorp_releases.name
|
|
||||||
|
|
||||||
immutable_patterns = [
|
|
||||||
"[^/]+/[^/]+/[^/]+/download/[^/]+/[^/]+$",
|
|
||||||
]
|
|
||||||
|
|
||||||
cache {
|
|
||||||
immutable_ttl = 0
|
|
||||||
mutable_ttl = 300
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
resource "artifactapi_remote" "hashicorp_releases" {
|
|
||||||
name = "hashicorp-releases"
|
|
||||||
package_type = "generic"
|
|
||||||
base_url = "https://releases.hashicorp.com"
|
|
||||||
|
|
||||||
immutable_patterns = [
|
|
||||||
".*\\.zip$",
|
|
||||||
".*SHA256SUMS(\\.sig)?$",
|
|
||||||
]
|
|
||||||
|
|
||||||
cache {
|
|
||||||
immutable_ttl = 0
|
|
||||||
mutable_ttl = 0
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
resource "artifactapi_virtual" "helm" {
|
|
||||||
name = "helm"
|
|
||||||
package_type = "helm"
|
|
||||||
description = "All helm repos merged"
|
|
||||||
members = [
|
|
||||||
artifactapi_remote.jetstack.name,
|
|
||||||
artifactapi_remote.hashicorp_helm.name,
|
|
||||||
]
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Web UI (React + Vite — Separate Container)
|
|
||||||
|
|
||||||
### Deployment
|
|
||||||
|
|
||||||
Separate `Dockerfile.ui`: multi-stage build (node → nginx). Served as its own container/pod. nginx proxies `/api/*` to the Go backend.
|
|
||||||
|
|
||||||
### Pages
|
|
||||||
|
|
||||||
| Route | Content |
|
|
||||||
|---|---|
|
|
||||||
| `/` | Dashboard: total objects, storage used, dedup savings, bandwidth saved, top remotes chart, live SSE event feed, health indicators |
|
|
||||||
| `/remotes` | Remote table: name, type, description, object count, size, hit rate, health. Filter by type, sort any column |
|
|
||||||
| `/remotes/:name` | Config (read-only, "Managed by Terraform" badge), stats, object browser with search/sort/evict, flush actions |
|
|
||||||
| `/virtuals` | Virtual table: name, type, members, merged object count |
|
|
||||||
| `/virtuals/:name` | Member list with individual stats |
|
|
||||||
|
|
||||||
All config is read-only — managed by Terraform.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## TUI (Bubble Tea — Subcommand)
|
|
||||||
|
|
||||||
`artifactapi tui --endpoint http://localhost:8000` or via `ARTIFACTAPI_ENDPOINT` env.
|
|
||||||
|
|
||||||
Uses `pkg/client/` for all API calls (same client as Terraform provider).
|
|
||||||
|
|
||||||
| View | Key bindings |
|
|
||||||
|---|---|
|
|
||||||
| Dashboard | summary stats, top remotes |
|
|
||||||
| Remotes list | `j`/`k` navigate, `/` filter, `Enter` detail |
|
|
||||||
| Remote detail | config + stats, `Enter` → object browser |
|
|
||||||
| Object browser | `/` search, `d` evict, `f` flush |
|
|
||||||
| Virtuals | `j`/`k`, `Enter` detail |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Improvements Over v2
|
|
||||||
|
|
||||||
| Area | v2 (Python) | v3 (Go) |
|
|
||||||
|---|---|---|
|
|
||||||
| S3 paths | Hashed, opaque | Content-addressed CAS |
|
|
||||||
| Config | YAML files, mtime reload | Terraform via API |
|
|
||||||
| Package types | 8 types | 10 types (+ terraform, goproxy) |
|
|
||||||
| Virtual repos | Helm only | Helm + PyPI, extensible |
|
|
||||||
| Deduplication | Docker blobs only | All types via CAS |
|
|
||||||
| Revalidation | Opt-in flag | Default for all mutable |
|
|
||||||
| Access logging | None | Per-artifact in Postgres |
|
|
||||||
| GC | None | Background goroutine |
|
|
||||||
| Upstream health | Per-request | Circuit breaker |
|
|
||||||
| S3 backends | MinIO only | MinIO, Ceph, AWS (minio-go) |
|
|
||||||
| UI | None | Web dashboard + TUI |
|
|
||||||
| Binary | Python + venv | Static Go binary |
|
|
||||||
| Frontend | N/A | Separate container (React) |
|
|
||||||
| Testing | Mocked unit tests | Unit + e2e with real backends |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Implementation Phases
|
|
||||||
|
|
||||||
### Phase 1: Core Engine + Models
|
|
||||||
- Go module, Makefile (`make build test lint fmt e2e`), Dockerfile, docker-compose
|
|
||||||
- `pkg/models/` — all domain types
|
|
||||||
- PostgreSQL schema + migrations
|
|
||||||
- S3 storage layer with CAS (`minio-go/v7`)
|
|
||||||
- Redis cache layer (TTL, locks)
|
|
||||||
- Proxy engine: fetch-or-cache, classifier, revalidator
|
|
||||||
- Generic + Docker providers (most complexity: OCI auth, CAS, tag banning)
|
|
||||||
- Health + metrics endpoints
|
|
||||||
- Unit tests for all packages
|
|
||||||
- **Milestone**: proxy Docker + generic, cache in S3, track in Postgres
|
|
||||||
|
|
||||||
### Phase 2: All Providers
|
|
||||||
- Helm (using `helm.sh/helm/v3/pkg/repo`)
|
|
||||||
- PyPI (stdlib `x/net/html`)
|
|
||||||
- npm (stdlib `encoding/json`)
|
|
||||||
- RPM (using `rs3.io/go/rpm/repomd`)
|
|
||||||
- Alpine (using `gitlab.alpinelinux.org/alpine/go`)
|
|
||||||
- Puppet Forge (stdlib `encoding/json`)
|
|
||||||
- Terraform (using `hashicorp/terraform-registry-address`)
|
|
||||||
- Go Modules / GOPROXY (using `github.com/goproxy/goproxy`)
|
|
||||||
- Unit tests per provider
|
|
||||||
- **Milestone**: feature parity with v2 + goproxy
|
|
||||||
|
|
||||||
### Phase 3: Management API + Virtual Repos + GC
|
|
||||||
- `pkg/client/` — shared Go API client
|
|
||||||
- v2 CRUD endpoints
|
|
||||||
- Virtual repo engine: `IndexMerger` for Helm + PyPI
|
|
||||||
- Circuit breaker
|
|
||||||
- Access logging middleware
|
|
||||||
- GC goroutine
|
|
||||||
- **Milestone**: full API, virtuals, GC
|
|
||||||
|
|
||||||
### Phase 4: End-to-End Tests
|
|
||||||
- `e2e/` test suite with `testcontainers-go`
|
|
||||||
- Proxy, Docker, management, virtual, terraform, GC tests
|
|
||||||
- CI pipeline: `make e2e`
|
|
||||||
- **Milestone**: comprehensive e2e coverage
|
|
||||||
|
|
||||||
### Phase 5: Terraform Provider
|
|
||||||
- Separate repo: `terraform-provider-artifactapi`
|
|
||||||
- Imports `pkg/client/` and `pkg/models/`
|
|
||||||
- `artifactapi_remote` + `artifactapi_virtual` resources + data sources
|
|
||||||
- Import support
|
|
||||||
- **Milestone**: manage all config via Terraform
|
|
||||||
|
|
||||||
### Phase 6: Web UI
|
|
||||||
- React + Vite in `ui/`
|
|
||||||
- `Dockerfile.ui` (multi-stage → nginx)
|
|
||||||
- Dashboard, remotes, objects, virtuals pages
|
|
||||||
- SSE event feed
|
|
||||||
- **Milestone**: full web UI in separate container
|
|
||||||
|
|
||||||
### Phase 7: TUI
|
|
||||||
- Bubble Tea in `internal/tui/`
|
|
||||||
- Uses `pkg/client/`
|
|
||||||
- Dashboard, remotes, objects, virtuals views
|
|
||||||
- **Milestone**: TUI feature parity with web UI
|
|
||||||
|
|
||||||
### Phase 8: Migration + Cutover
|
|
||||||
- Migration tool: v2 YAML → Terraform HCL + `terraform import` commands
|
|
||||||
- S3 rehash script: `{remote}/{hash16}/{file}` → `blobs/sha256/{content_hash}`
|
|
||||||
- Parallel run, response comparison
|
|
||||||
- Cutover
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Makefile Targets
|
|
||||||
|
|
||||||
```makefile
|
|
||||||
.PHONY: build test lint fmt e2e docker docker-ui
|
|
||||||
|
|
||||||
build: ## Build Go binary
|
|
||||||
go build -o bin/artifactapi ./cmd/artifactapi
|
|
||||||
|
|
||||||
test: ## Run unit tests
|
|
||||||
go test ./...
|
|
||||||
|
|
||||||
lint: ## Run golangci-lint + go vet
|
|
||||||
golangci-lint run ./...
|
|
||||||
go vet ./...
|
|
||||||
|
|
||||||
fmt: ## Format code (gofmt + goimports)
|
|
||||||
gofmt -w .
|
|
||||||
goimports -w .
|
|
||||||
|
|
||||||
e2e: ## Run end-to-end tests (requires Docker)
|
|
||||||
go test -tags=e2e -count=1 -timeout=5m ./e2e/...
|
|
||||||
|
|
||||||
docker: ## Build API server Docker image
|
|
||||||
docker build -t artifactapi .
|
|
||||||
|
|
||||||
docker-ui: ## Build frontend Docker image
|
|
||||||
docker build -t artifactapi-ui -f ui/Dockerfile.ui ui/
|
|
||||||
|
|
||||||
compose: ## Start full stack (API + UI + Postgres + Redis + MinIO)
|
|
||||||
docker compose up -d
|
|
||||||
```
|
|
||||||
@@ -1,239 +1,664 @@
|
|||||||
# ArtifactAPI
|
# Artifact Storage System
|
||||||
|
|
||||||
Caching proxy for package repositories. Single Go binary, 12 package types, content-addressable storage, managed by Terraform.
|
A generic FastAPI-based artifact caching system that downloads and stores files from remote sources (GitHub, Gitea, HashiCorp, etc.) in S3-compatible storage with configuration-based access control.
|
||||||
|
|
||||||
## Quick Start
|
## Features
|
||||||
|
|
||||||
```bash
|
- **Generic Remote Support**: Works with any HTTP-based file server (GitHub, Gitea, HashiCorp, custom servers)
|
||||||
# Start backing services
|
- **Configuration-Based**: YAML configuration for remotes, patterns, and access control
|
||||||
docker compose up -d postgres redis minio
|
- **Direct URL API**: Access cached files via clean URLs like `/api/github/owner/repo/path/file.tar.gz`
|
||||||
|
- **Pattern Filtering**: Regex-based inclusion patterns for security and organization
|
||||||
# Build and run
|
- **Smart Caching**: Automatic download and cache on first access, serve from cache afterward
|
||||||
make build
|
- **S3 Storage**: MinIO/S3 backend with predictable paths
|
||||||
./bin/artifactapi
|
- **Content-Type Detection**: Automatic MIME type detection for downloads
|
||||||
|
|
||||||
# Frontend (separate container or dev server)
|
|
||||||
cd ui && npm install && npm run dev
|
|
||||||
```
|
|
||||||
|
|
||||||
API: `http://localhost:8000` | Frontend: `http://localhost:5173`
|
|
||||||
|
|
||||||
## Package Types
|
|
||||||
|
|
||||||
Providers classify paths automatically. Users only configure what to proxy and TTLs.
|
|
||||||
|
|
||||||
Classification precedence, TTLs and eviction for every remote: [docs/common/caching.md](docs/common/caching.md).
|
|
||||||
|
|
||||||
Each type's paths, Terraform examples and local/virtual behaviour are in `docs/<type>/`:
|
|
||||||
|
|
||||||
- `alpine`: [remote](docs/alpine/remote.md), [remote-github](docs/alpine/remote-github.md)
|
|
||||||
- `cargo`: [remote](docs/cargo/remote.md)
|
|
||||||
- `deb`: [remote](docs/deb/remote.md), [remote-github](docs/deb/remote-github.md)
|
|
||||||
- `docker`: [remote](docs/docker/remote.md), [local](docs/docker/local.md)
|
|
||||||
- `generic`: [remote](docs/generic/remote.md)
|
|
||||||
- `goproxy`: [remote](docs/goproxy/remote.md)
|
|
||||||
- `helm`: [remote](docs/helm/remote.md), [local](docs/helm/local.md), [virtual](docs/helm/virtual.md)
|
|
||||||
- `npm`: [remote](docs/npm/remote.md)
|
|
||||||
- `nuget`: [remote](docs/nuget/remote.md)
|
|
||||||
- `puppet`: [remote](docs/puppet/remote.md), [local](docs/puppet/local.md)
|
|
||||||
- `pypi`: [remote](docs/pypi/remote.md)
|
|
||||||
- `rpm`: [remote](docs/rpm/remote.md), [remote-github](docs/rpm/remote-github.md)
|
|
||||||
- `terraform`: [remote](docs/terraform/remote.md), [local](docs/terraform/local.md)
|
|
||||||
|
|
||||||
### GitHub authentication
|
|
||||||
|
|
||||||
Anonymous GitHub is capped at **60 requests/hour** and cannot read private
|
|
||||||
repositories. Configure a **server-level GitHub credential** to raise the ceiling
|
|
||||||
to roughly **5000 requests/hour** and to read private-repo release assets. The
|
|
||||||
credential is a process-wide machine identity applied by default to *every*
|
|
||||||
outbound GitHub request — the releases scan, the ranged asset-header fetches, and
|
|
||||||
the generic-github byte proxy that streams private release assets.
|
|
||||||
|
|
||||||
The credential is read from the environment (deliver it from a Vault or
|
|
||||||
Kubernetes secret). It is **never** stored per-remote in the database, **never**
|
|
||||||
returned by any API, and **never** logged. Configure **exactly one** mode.
|
|
||||||
|
|
||||||
**Precedence.** A remote's own `username`/`password` credential still wins for
|
|
||||||
that remote's requests; the server credential is the default for everything else.
|
|
||||||
With no credential configured at all, requests stay anonymous (current behavior).
|
|
||||||
Partial configuration (e.g. an App id with no private key) is a **startup error**
|
|
||||||
— artifactapi fails closed rather than silently falling back to anonymous.
|
|
||||||
|
|
||||||
Both modes share the syncer's single global rate limiter, so a token simply
|
|
||||||
raises the effective GitHub ceiling; the default limiter settings stay safe.
|
|
||||||
|
|
||||||
#### Mode 1 — Personal Access Token (minimum viable, recommended for free accounts)
|
|
||||||
|
|
||||||
Set `GITHUB_TOKEN`. It is sent as `Authorization: Bearer <token>`.
|
|
||||||
|
|
||||||
Recommended free-account setup — a **fine-grained PAT** scoped to just the target
|
|
||||||
repositories:
|
|
||||||
|
|
||||||
1. GitHub → *Settings → Developer settings → Personal access tokens →
|
|
||||||
Fine-grained tokens → Generate new token*.
|
|
||||||
2. Limit *Repository access* to the specific repo(s) serving releases.
|
|
||||||
3. Grant repository permissions **Contents: Read-only** and **Metadata:
|
|
||||||
Read-only** (Metadata is mandatory and auto-selected).
|
|
||||||
|
|
||||||
A classic PAT with the `repo` scope also works but is broader than necessary.
|
|
||||||
|
|
||||||
```bash
|
|
||||||
GITHUB_TOKEN=github_pat_xxxxxxxx
|
|
||||||
```
|
|
||||||
|
|
||||||
#### Mode 2 — GitHub App installation token (proper machine identity)
|
|
||||||
|
|
||||||
A GitHub App is not tied to a personal account and can be created and installed on
|
|
||||||
free personal repos. artifactapi mints a short-lived RS256 **JWT** from the app
|
|
||||||
private key, exchanges it at `POST /app/installations/{id}/access_tokens` for a
|
|
||||||
~1-hour **installation access token**, caches that token, and refreshes it a few
|
|
||||||
minutes before expiry (thread-safe, single-flighted).
|
|
||||||
|
|
||||||
1. GitHub → *Settings → Developer settings → GitHub Apps → New GitHub App*.
|
|
||||||
2. Under *Permissions → Repository permissions* grant **Contents: Read-only**
|
|
||||||
(Metadata: Read-only is implied).
|
|
||||||
3. Generate a **private key** (downloads a PEM) and note the **App ID**.
|
|
||||||
4. *Install* the App on the account and select the target repositories, then read
|
|
||||||
the **Installation ID** from the installation URL
|
|
||||||
(`.../settings/installations/<installation-id>`).
|
|
||||||
|
|
||||||
```bash
|
|
||||||
GITHUB_APP_ID=123456
|
|
||||||
GITHUB_APP_INSTALLATION_ID=7654321
|
|
||||||
GITHUB_APP_PRIVATE_KEY_PATH=/etc/artifactapi/github-app.pem
|
|
||||||
# or inline PEM (e.g. mounted from a secret):
|
|
||||||
# GITHUB_APP_PRIVATE_KEY="-----BEGIN RSA PRIVATE KEY-----\n...\n-----END RSA PRIVATE KEY-----"
|
|
||||||
```
|
|
||||||
|
|
||||||
## Terraform
|
|
||||||
|
|
||||||
Remotes and virtuals are managed by Terraform. Each package type has its own resource; see `docs/<type>/` for examples.
|
|
||||||
|
|
||||||
Provider: [terraform-provider-artifactapi](https://git.unkin.net/unkin/terraform-provider-artifactapi)
|
|
||||||
|
|
||||||
## Access Control
|
|
||||||
|
|
||||||
| Field | Default | Behaviour |
|
|
||||||
|---|---|---|
|
|
||||||
| `patterns` | empty (proxy all) | If set, only matching paths are proxied. Acts as allowlist. |
|
|
||||||
| `blocklist` | empty | Matching paths always denied. Checked first. |
|
|
||||||
| `mutable_patterns` | empty | Override: force paths to mutable TTL. |
|
|
||||||
| `immutable_patterns` | empty | Override: force paths to immutable TTL. |
|
|
||||||
|
|
||||||
No patterns + no blocklist = open proxy. Provider handles mutability classification automatically.
|
|
||||||
|
|
||||||
## API
|
|
||||||
|
|
||||||
### Proxy (v1)
|
|
||||||
|
|
||||||
```
|
|
||||||
GET /api/v1/remote/{name}/{path} Proxy/cache artifact
|
|
||||||
GET /api/v1/virtual/{name}/{path} Virtual repo (merged index)
|
|
||||||
GET /v2/{name}/{path} Docker Registry v2
|
|
||||||
```
|
|
||||||
|
|
||||||
### Management (v2)
|
|
||||||
|
|
||||||
```
|
|
||||||
GET/POST /api/v2/remotes List / create remotes
|
|
||||||
GET/PUT/DELETE /api/v2/remotes/{name} Read / update / delete remote
|
|
||||||
GET/DELETE /api/v2/remotes/{name}/objects Browse / evict cached objects
|
|
||||||
GET /api/v2/stats Overview stats
|
|
||||||
GET /api/v2/health Service health
|
|
||||||
POST /api/v2/probe Test a remote (fetch without streaming to client)
|
|
||||||
GET /api/v2/events SSE event stream
|
|
||||||
```
|
|
||||||
|
|
||||||
## Architecture
|
## Architecture
|
||||||
|
|
||||||
```
|
The system acts as a caching proxy that:
|
||||||
PostgreSQL ─── config (remotes, virtuals), artifact metadata, access log
|
1. Receives requests via the `/api/{remote}/{path}` endpoint
|
||||||
Redis ─── TTL keys, fetch locks, circuit breaker state
|
2. Checks if the file is already cached
|
||||||
S3/MinIO ─── content-addressable blob storage (blobs/sha256/{hash})
|
3. If not cached, downloads from the configured remote and caches it
|
||||||
```
|
4. Serves the file with appropriate headers and content types
|
||||||
|
5. Enforces access control via configurable regex patterns
|
||||||
|
|
||||||
S3 client supports MinIO, Ceph RGW, and AWS S3 (via minio-go).
|
## Quick Start
|
||||||
|
|
||||||
### Schema migrations
|
|
||||||
|
|
||||||
The SQL schema lives in `migrations/` as numbered `.sql` files, embedded into
|
|
||||||
the binary and applied at startup before the server listens, so there is no
|
|
||||||
mirrored copy of the schema in the deployment to drift out of sync.
|
|
||||||
|
|
||||||
The runner is [`golib/pg`](https://git.unkin.net/unkin/golib)'s `pg.NewMigrated`
|
|
||||||
— artifactapi owns the SQL, the shared library owns the mechanics.
|
|
||||||
|
|
||||||
Each start takes `pg_advisory_lock` on a fixed key (FNV-1a/64 of the lock name
|
|
||||||
`artifactapi-migrations`), creates `schema_migrations` (`version`, `applied_at`)
|
|
||||||
if missing, and applies every embedded file whose filename is not yet recorded —
|
|
||||||
in lexical (version) order, each file's SQL and its tracking row in one
|
|
||||||
transaction — then unlocks. Replicas starting together queue on the lock and
|
|
||||||
then find nothing to do.
|
|
||||||
|
|
||||||
A file absent from `schema_migrations` is re-run even when the database already
|
|
||||||
has the schema, which is how a database migrated by the old untracked inline DDL
|
|
||||||
picks `0001_init.sql` up: the statements are `IF NOT EXISTS`-guarded, so the
|
|
||||||
re-run is a no-op that only lands the tracking row. New migrations must stay
|
|
||||||
additive and idempotent for the same reason; a test enforces it.
|
|
||||||
|
|
||||||
## Environment Variables
|
|
||||||
|
|
||||||
| Variable | Default | Description |
|
|
||||||
|---|---|---|
|
|
||||||
| `LISTEN_ADDR` | `:8000` | Server listen address |
|
|
||||||
| `DBHOST` | `localhost` | PostgreSQL host |
|
|
||||||
| `DBPORT` | `5432` | PostgreSQL port |
|
|
||||||
| `DBUSER` | `artifacts` | PostgreSQL user |
|
|
||||||
| `DBPASS` | | PostgreSQL password |
|
|
||||||
| `DBNAME` | `artifacts` | PostgreSQL database |
|
|
||||||
| `DBSSL` | `disable` | PostgreSQL `sslmode` |
|
|
||||||
| `REDIS_URL` | `redis://localhost:6379` | Redis URL |
|
|
||||||
| `MINIO_ENDPOINT` | `localhost:9000` | S3 endpoint |
|
|
||||||
| `MINIO_ACCESS_KEY` | | S3 access key |
|
|
||||||
| `MINIO_SECRET_KEY` | | S3 secret key |
|
|
||||||
| `MINIO_BUCKET` | `artifacts` | S3 bucket |
|
|
||||||
| `MINIO_SECURE` | `false` | Use HTTPS for S3 |
|
|
||||||
| `MINIO_REGION` | | S3 region (AWS) |
|
|
||||||
| `GITHUB_SYNC_RATE` | `1` | `github_rpm` syncer global GitHub request rate (req/s), shared across all remotes. `1`/s = 3600/hr, under an authenticated token's ~5000/hr; unauthenticated (~60/hr) relies on ETag/304 |
|
|
||||||
| `GITHUB_SYNC_BURST` | `5` | Token-bucket burst for the shared limiter |
|
|
||||||
| `GITHUB_SYNC_WORKERS` | `3` | Concurrent `github_rpm` scan workers |
|
|
||||||
| `GITHUB_SYNC_POLL_INTERVAL` | `60` | Base scheduler tick in seconds; per-remote cadence is its `mutable_ttl`, enforced by the DB lease |
|
|
||||||
| `GITHUB_TOKEN` | | Server-level GitHub PAT (fine-grained or classic), sent as `Authorization: Bearer`. Applies to every GitHub request; per-remote creds override it. See [GitHub authentication](#github-authentication) |
|
|
||||||
| `GITHUB_APP_ID` | | GitHub App id (App auth mode; mutually exclusive with `GITHUB_TOKEN`) |
|
|
||||||
| `GITHUB_APP_INSTALLATION_ID` | | GitHub App installation id |
|
|
||||||
| `GITHUB_APP_PRIVATE_KEY` | | GitHub App private key, inline PEM |
|
|
||||||
| `GITHUB_APP_PRIVATE_KEY_PATH` | | GitHub App private key, file path (alternative to inline PEM) |
|
|
||||||
| `ARTIFACTAPI_OIDC_ISSUER` | | OIDC issuer URL (e.g. Vault `https://vault.service.consul:8200/v1/identity/oidc`). When set, `POST /api/v2/remotes`, `POST /api/v2/virtuals` and `PUT`/`DELETE` on `/api/v2/{remotes,virtuals}/{name}` require `Authorization: Bearer <jwt>` verified against the issuer's JWKS. Uploads, object/file deletes, probe, reads and `/v2` stay open. Unset = no auth |
|
|
||||||
| `ARTIFACTAPI_OIDC_AUDIENCE` | | Comma-separated allowed `aud` values (e.g. the Vault OIDC role's client_id). Required when `ARTIFACTAPI_OIDC_ISSUER` is set |
|
|
||||||
|
|
||||||
## Development
|
|
||||||
|
|
||||||
|
1. Start MinIO container:
|
||||||
```bash
|
```bash
|
||||||
make build # Build binary
|
docker-compose up -d
|
||||||
make test # Unit tests
|
|
||||||
make e2e # E2E tests (needs Docker)
|
|
||||||
make lint # golangci-lint + go vet
|
|
||||||
make fmt # gofmt + goimports
|
|
||||||
```
|
```
|
||||||
|
|
||||||
### `GOPRIVATE`
|
2. Create virtual environment and install dependencies:
|
||||||
|
|
||||||
artifactapi depends on `git.unkin.net/unkin/golib`, which is served by Gitea and
|
|
||||||
is unknown to `proxy.golang.org` / `sum.golang.org`. Module resolution therefore
|
|
||||||
needs:
|
|
||||||
|
|
||||||
```
|
|
||||||
export GOPRIVATE=git.unkin.net
|
|
||||||
```
|
|
||||||
|
|
||||||
The `Makefile` exports it for every target, and the `Dockerfile` and the
|
|
||||||
woodpecker Go steps set it themselves, so `make build|test|lint` and CI work on
|
|
||||||
a clean checkout. Only bare `go` commands run outside `make` need it in your
|
|
||||||
shell — set it there (or in your shell profile) rather than with `go env -w`,
|
|
||||||
which is machine state this repo cannot carry.
|
|
||||||
|
|
||||||
### TUI
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
./bin/artifactapi tui --endpoint http://localhost:8000
|
uv venv
|
||||||
|
source .venv/bin/activate
|
||||||
|
uv pip install -r requirements.txt
|
||||||
```
|
```
|
||||||
|
|
||||||
|
3. Start the API:
|
||||||
|
```bash
|
||||||
|
python main.py
|
||||||
|
```
|
||||||
|
|
||||||
|
4. Access artifacts directly via URL:
|
||||||
|
```bash
|
||||||
|
# This will download and cache the file on first access
|
||||||
|
xh GET localhost:8000/api/github/gruntwork-io/terragrunt/releases/download/v0.96.1/terragrunt_linux_amd64.tar.gz
|
||||||
|
|
||||||
|
# Subsequent requests serve from cache (see X-Artifact-Source: cache header)
|
||||||
|
curl -I localhost:8000/api/github/gruntwork-io/terragrunt/releases/download/v0.96.1/terragrunt_linux_amd64.tar.gz
|
||||||
|
```
|
||||||
|
|
||||||
|
## API Endpoints
|
||||||
|
|
||||||
|
### Direct Access
|
||||||
|
- `GET /api/{remote}/{path}` - Direct access to artifacts with auto-caching
|
||||||
|
|
||||||
|
### Management
|
||||||
|
- `GET /` - API info and available remotes
|
||||||
|
- `GET /health` - Health check
|
||||||
|
- `GET /config` - View current configuration
|
||||||
|
- `POST /cache-artifact` - Batch cache artifacts matching pattern
|
||||||
|
- `GET /artifacts/{remote}` - List cached artifacts
|
||||||
|
|
||||||
|
## Configuration
|
||||||
|
|
||||||
|
The system uses `remotes.yaml` to define remote repositories and access patterns. All other configuration is provided via environment variables.
|
||||||
|
|
||||||
|
### remotes.yaml Structure
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
remotes:
|
||||||
|
remote-name:
|
||||||
|
base_url: "https://example.com" # Base URL for the remote
|
||||||
|
type: "remote" # Type: "remote" or "local"
|
||||||
|
package: "generic" # Package type: "generic", "alpine", "rpm"
|
||||||
|
description: "Human readable description"
|
||||||
|
include_patterns: # Regex patterns for allowed files
|
||||||
|
- "pattern1"
|
||||||
|
- "pattern2"
|
||||||
|
cache: # Cache configuration (optional)
|
||||||
|
file_ttl: 0 # File cache TTL (0 = indefinite)
|
||||||
|
index_ttl: 300 # Index file TTL in seconds
|
||||||
|
```
|
||||||
|
|
||||||
|
### Remote Types
|
||||||
|
|
||||||
|
#### Generic Remotes
|
||||||
|
For general file hosting (GitHub releases, custom servers):
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
remotes:
|
||||||
|
github:
|
||||||
|
base_url: "https://github.com"
|
||||||
|
type: "remote"
|
||||||
|
package: "generic"
|
||||||
|
description: "GitHub releases and files"
|
||||||
|
include_patterns:
|
||||||
|
- "gruntwork-io/terragrunt/.*terragrunt_linux_amd64.*"
|
||||||
|
- "lxc/incus/.*\\.tar\\.gz$"
|
||||||
|
- "prometheus/node_exporter/.*/node_exporter-.*\\.linux-amd64\\.tar\\.gz$"
|
||||||
|
cache:
|
||||||
|
file_ttl: 0 # Cache files indefinitely
|
||||||
|
index_ttl: 0 # No index files for generic remotes
|
||||||
|
|
||||||
|
hashicorp-releases:
|
||||||
|
base_url: "https://releases.hashicorp.com"
|
||||||
|
type: "remote"
|
||||||
|
package: "generic"
|
||||||
|
description: "HashiCorp product releases"
|
||||||
|
include_patterns:
|
||||||
|
- "terraform/.*terraform_.*_linux_amd64\\.zip$"
|
||||||
|
- "vault/.*vault_.*_linux_amd64\\.zip$"
|
||||||
|
- "consul/.*/consul_.*_linux_amd64\\.zip$"
|
||||||
|
cache:
|
||||||
|
file_ttl: 0
|
||||||
|
index_ttl: 0
|
||||||
|
```
|
||||||
|
|
||||||
|
#### Package Repository Remotes
|
||||||
|
For Linux package repositories with index files:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
remotes:
|
||||||
|
alpine:
|
||||||
|
base_url: "https://dl-cdn.alpinelinux.org"
|
||||||
|
type: "remote"
|
||||||
|
package: "alpine"
|
||||||
|
description: "Alpine Linux APK package repository"
|
||||||
|
include_patterns:
|
||||||
|
- ".*/x86_64/.*\\.apk$" # Only x86_64 packages
|
||||||
|
cache:
|
||||||
|
file_ttl: 0 # Cache packages indefinitely
|
||||||
|
index_ttl: 7200 # Cache APKINDEX.tar.gz for 2 hours
|
||||||
|
|
||||||
|
almalinux:
|
||||||
|
base_url: "http://mirror.aarnet.edu.au/pub/almalinux"
|
||||||
|
type: "remote"
|
||||||
|
package: "rpm"
|
||||||
|
description: "AlmaLinux RPM package repository"
|
||||||
|
include_patterns:
|
||||||
|
- ".*/x86_64/.*\\.rpm$"
|
||||||
|
- ".*/noarch/.*\\.rpm$"
|
||||||
|
cache:
|
||||||
|
file_ttl: 0
|
||||||
|
index_ttl: 7200 # Cache metadata files for 2 hours
|
||||||
|
```
|
||||||
|
|
||||||
|
#### Local Repositories
|
||||||
|
For storing custom artifacts:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
remotes:
|
||||||
|
local-generic:
|
||||||
|
type: "local"
|
||||||
|
package: "generic"
|
||||||
|
description: "Local generic file repository"
|
||||||
|
cache:
|
||||||
|
file_ttl: 0
|
||||||
|
index_ttl: 0
|
||||||
|
```
|
||||||
|
|
||||||
|
### Include Patterns
|
||||||
|
|
||||||
|
Include patterns are regular expressions that control which files can be accessed:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
include_patterns:
|
||||||
|
# Specific project patterns
|
||||||
|
- "gruntwork-io/terragrunt/.*terragrunt_linux_amd64.*"
|
||||||
|
|
||||||
|
# File extension patterns
|
||||||
|
- ".*\\.tar\\.gz$"
|
||||||
|
- ".*\\.zip$"
|
||||||
|
- ".*\\.rpm$"
|
||||||
|
|
||||||
|
# Architecture-specific patterns
|
||||||
|
- ".*/x86_64/.*"
|
||||||
|
- ".*/linux-amd64/.*"
|
||||||
|
|
||||||
|
# Version-specific patterns
|
||||||
|
- "prometheus/node_exporter/.*/node_exporter-.*\\.linux-amd64\\.tar\\.gz$"
|
||||||
|
```
|
||||||
|
|
||||||
|
**Security Note**: Only files matching at least one include pattern are accessible. Files not matching any pattern return HTTP 403.
|
||||||
|
|
||||||
|
### Cache Configuration
|
||||||
|
|
||||||
|
Control how long different file types are cached:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
cache:
|
||||||
|
file_ttl: 0 # Regular files (0 = cache indefinitely)
|
||||||
|
index_ttl: 300 # Index files like APKINDEX.tar.gz (seconds)
|
||||||
|
```
|
||||||
|
|
||||||
|
**Index Files**: Repository metadata files that change frequently:
|
||||||
|
- Alpine: `APKINDEX.tar.gz`
|
||||||
|
- RPM: `repomd.xml`, `*-primary.xml.gz`, etc.
|
||||||
|
- These are automatically detected and use `index_ttl`
|
||||||
|
|
||||||
|
### Environment Variables
|
||||||
|
|
||||||
|
All runtime configuration comes from environment variables:
|
||||||
|
|
||||||
|
**Database Configuration:**
|
||||||
|
- `DBHOST` - PostgreSQL host
|
||||||
|
- `DBPORT` - PostgreSQL port
|
||||||
|
- `DBUSER` - PostgreSQL username
|
||||||
|
- `DBPASS` - PostgreSQL password
|
||||||
|
- `DBNAME` - PostgreSQL database name
|
||||||
|
|
||||||
|
**Redis Configuration:**
|
||||||
|
- `REDIS_URL` - Redis connection URL (e.g., `redis://localhost:6379`)
|
||||||
|
|
||||||
|
**S3/MinIO Configuration:**
|
||||||
|
- `MINIO_ENDPOINT` - MinIO/S3 endpoint
|
||||||
|
- `MINIO_ACCESS_KEY` - S3 access key
|
||||||
|
- `MINIO_SECRET_KEY` - S3 secret key
|
||||||
|
- `MINIO_BUCKET` - S3 bucket name
|
||||||
|
- `MINIO_SECURE` - Use HTTPS (`true`/`false`)
|
||||||
|
|
||||||
|
## Usage Examples
|
||||||
|
|
||||||
|
### Direct File Access
|
||||||
|
```bash
|
||||||
|
# Access GitHub releases
|
||||||
|
curl localhost:8000/api/github/gruntwork-io/terragrunt/releases/download/v0.96.1/terragrunt_linux_amd64.tar.gz
|
||||||
|
|
||||||
|
# Access HashiCorp releases (when configured)
|
||||||
|
curl localhost:8000/api/hashicorp/terraform/1.6.0/terraform_1.6.0_linux_amd64.zip
|
||||||
|
|
||||||
|
# Access custom remotes
|
||||||
|
curl localhost:8000/api/custom/path/to/file.tar.gz
|
||||||
|
```
|
||||||
|
|
||||||
|
### Response Headers
|
||||||
|
- `X-Artifact-Source: cache|remote` - Indicates if served from cache or freshly downloaded
|
||||||
|
- `Content-Type` - Automatically detected (application/gzip, application/zip, etc.)
|
||||||
|
- `Content-Disposition` - Download filename
|
||||||
|
- `Content-Length` - File size
|
||||||
|
|
||||||
|
### Pattern Enforcement
|
||||||
|
Access is controlled by regex patterns in the configuration. Requests for files not matching any pattern return HTTP 403.
|
||||||
|
|
||||||
|
## Storage Path Format
|
||||||
|
|
||||||
|
Files are stored with keys like:
|
||||||
|
- `{remote_name}/{path_hash}/{filename}` for direct API access
|
||||||
|
- `{hostname}/{url_hash}/{filename}` for legacy batch operations
|
||||||
|
|
||||||
|
Example: `github/a1b2c3d4e5f6g7h8/terragrunt_linux_amd64.tar.gz`
|
||||||
|
|
||||||
|
## Kubernetes Deployment
|
||||||
|
|
||||||
|
Deploy the artifact storage system to Kubernetes using the following manifests:
|
||||||
|
|
||||||
|
### 1. Namespace
|
||||||
|
```yaml
|
||||||
|
apiVersion: v1
|
||||||
|
kind: Namespace
|
||||||
|
metadata:
|
||||||
|
name: artifact-storage
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. ConfigMap for remotes.yaml
|
||||||
|
```yaml
|
||||||
|
apiVersion: v1
|
||||||
|
kind: ConfigMap
|
||||||
|
metadata:
|
||||||
|
name: artifactapi-config
|
||||||
|
namespace: artifact-storage
|
||||||
|
data:
|
||||||
|
remotes.yaml: |
|
||||||
|
remotes:
|
||||||
|
github:
|
||||||
|
base_url: "https://github.com"
|
||||||
|
type: "remote"
|
||||||
|
package: "generic"
|
||||||
|
description: "GitHub releases and files"
|
||||||
|
include_patterns:
|
||||||
|
- "gruntwork-io/terragrunt/.*terragrunt_linux_amd64.*"
|
||||||
|
- "lxc/incus/.*\\.tar\\.gz$"
|
||||||
|
- "prometheus/node_exporter/.*/node_exporter-.*\\.linux-amd64\\.tar\\.gz$"
|
||||||
|
cache:
|
||||||
|
file_ttl: 0
|
||||||
|
index_ttl: 0
|
||||||
|
|
||||||
|
hashicorp-releases:
|
||||||
|
base_url: "https://releases.hashicorp.com"
|
||||||
|
type: "remote"
|
||||||
|
package: "generic"
|
||||||
|
description: "HashiCorp product releases"
|
||||||
|
include_patterns:
|
||||||
|
- "terraform/.*terraform_.*_linux_amd64\\.zip$"
|
||||||
|
- "vault/.*vault_.*_linux_amd64\\.zip$"
|
||||||
|
- "consul/.*/consul_.*_linux_amd64\\.zip$"
|
||||||
|
cache:
|
||||||
|
file_ttl: 0
|
||||||
|
index_ttl: 0
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. Secret for Environment Variables
|
||||||
|
```yaml
|
||||||
|
apiVersion: v1
|
||||||
|
kind: Secret
|
||||||
|
metadata:
|
||||||
|
name: artifactapi-secret
|
||||||
|
namespace: artifact-storage
|
||||||
|
type: Opaque
|
||||||
|
stringData:
|
||||||
|
DBHOST: "postgres-service"
|
||||||
|
DBPORT: "5432"
|
||||||
|
DBUSER: "artifacts"
|
||||||
|
DBPASS: "artifacts123"
|
||||||
|
DBNAME: "artifacts"
|
||||||
|
REDIS_URL: "redis://redis-service:6379"
|
||||||
|
MINIO_ENDPOINT: "minio-service:9000"
|
||||||
|
MINIO_ACCESS_KEY: "minioadmin"
|
||||||
|
MINIO_SECRET_KEY: "minioadmin"
|
||||||
|
MINIO_BUCKET: "artifacts"
|
||||||
|
MINIO_SECURE: "false"
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4. PostgreSQL Deployment
|
||||||
|
```yaml
|
||||||
|
apiVersion: apps/v1
|
||||||
|
kind: Deployment
|
||||||
|
metadata:
|
||||||
|
name: postgres
|
||||||
|
namespace: artifact-storage
|
||||||
|
spec:
|
||||||
|
replicas: 1
|
||||||
|
selector:
|
||||||
|
matchLabels:
|
||||||
|
app: postgres
|
||||||
|
template:
|
||||||
|
metadata:
|
||||||
|
labels:
|
||||||
|
app: postgres
|
||||||
|
spec:
|
||||||
|
containers:
|
||||||
|
- name: postgres
|
||||||
|
image: postgres:15-alpine
|
||||||
|
env:
|
||||||
|
- name: POSTGRES_DB
|
||||||
|
value: artifacts
|
||||||
|
- name: POSTGRES_USER
|
||||||
|
value: artifacts
|
||||||
|
- name: POSTGRES_PASSWORD
|
||||||
|
value: artifacts123
|
||||||
|
ports:
|
||||||
|
- containerPort: 5432
|
||||||
|
volumeMounts:
|
||||||
|
- name: postgres-storage
|
||||||
|
mountPath: /var/lib/postgresql/data
|
||||||
|
livenessProbe:
|
||||||
|
exec:
|
||||||
|
command: ["pg_isready", "-U", "artifacts", "-d", "artifacts"]
|
||||||
|
initialDelaySeconds: 30
|
||||||
|
periodSeconds: 30
|
||||||
|
volumes:
|
||||||
|
- name: postgres-storage
|
||||||
|
persistentVolumeClaim:
|
||||||
|
claimName: postgres-pvc
|
||||||
|
---
|
||||||
|
apiVersion: v1
|
||||||
|
kind: Service
|
||||||
|
metadata:
|
||||||
|
name: postgres-service
|
||||||
|
namespace: artifact-storage
|
||||||
|
spec:
|
||||||
|
selector:
|
||||||
|
app: postgres
|
||||||
|
ports:
|
||||||
|
- port: 5432
|
||||||
|
targetPort: 5432
|
||||||
|
---
|
||||||
|
apiVersion: v1
|
||||||
|
kind: PersistentVolumeClaim
|
||||||
|
metadata:
|
||||||
|
name: postgres-pvc
|
||||||
|
namespace: artifact-storage
|
||||||
|
spec:
|
||||||
|
accessModes:
|
||||||
|
- ReadWriteOnce
|
||||||
|
resources:
|
||||||
|
requests:
|
||||||
|
storage: 10Gi
|
||||||
|
```
|
||||||
|
|
||||||
|
### 5. Redis Deployment
|
||||||
|
```yaml
|
||||||
|
apiVersion: apps/v1
|
||||||
|
kind: Deployment
|
||||||
|
metadata:
|
||||||
|
name: redis
|
||||||
|
namespace: artifact-storage
|
||||||
|
spec:
|
||||||
|
replicas: 1
|
||||||
|
selector:
|
||||||
|
matchLabels:
|
||||||
|
app: redis
|
||||||
|
template:
|
||||||
|
metadata:
|
||||||
|
labels:
|
||||||
|
app: redis
|
||||||
|
spec:
|
||||||
|
containers:
|
||||||
|
- name: redis
|
||||||
|
image: redis:7-alpine
|
||||||
|
command: ["redis-server", "--save", "20", "1"]
|
||||||
|
ports:
|
||||||
|
- containerPort: 6379
|
||||||
|
volumeMounts:
|
||||||
|
- name: redis-storage
|
||||||
|
mountPath: /data
|
||||||
|
livenessProbe:
|
||||||
|
exec:
|
||||||
|
command: ["redis-cli", "ping"]
|
||||||
|
initialDelaySeconds: 30
|
||||||
|
periodSeconds: 30
|
||||||
|
volumes:
|
||||||
|
- name: redis-storage
|
||||||
|
persistentVolumeClaim:
|
||||||
|
claimName: redis-pvc
|
||||||
|
---
|
||||||
|
apiVersion: v1
|
||||||
|
kind: Service
|
||||||
|
metadata:
|
||||||
|
name: redis-service
|
||||||
|
namespace: artifact-storage
|
||||||
|
spec:
|
||||||
|
selector:
|
||||||
|
app: redis
|
||||||
|
ports:
|
||||||
|
- port: 6379
|
||||||
|
targetPort: 6379
|
||||||
|
---
|
||||||
|
apiVersion: v1
|
||||||
|
kind: PersistentVolumeClaim
|
||||||
|
metadata:
|
||||||
|
name: redis-pvc
|
||||||
|
namespace: artifact-storage
|
||||||
|
spec:
|
||||||
|
accessModes:
|
||||||
|
- ReadWriteOnce
|
||||||
|
resources:
|
||||||
|
requests:
|
||||||
|
storage: 5Gi
|
||||||
|
```
|
||||||
|
|
||||||
|
### 6. MinIO Deployment
|
||||||
|
```yaml
|
||||||
|
apiVersion: apps/v1
|
||||||
|
kind: Deployment
|
||||||
|
metadata:
|
||||||
|
name: minio
|
||||||
|
namespace: artifact-storage
|
||||||
|
spec:
|
||||||
|
replicas: 1
|
||||||
|
selector:
|
||||||
|
matchLabels:
|
||||||
|
app: minio
|
||||||
|
template:
|
||||||
|
metadata:
|
||||||
|
labels:
|
||||||
|
app: minio
|
||||||
|
spec:
|
||||||
|
containers:
|
||||||
|
- name: minio
|
||||||
|
image: minio/minio:latest
|
||||||
|
command: ["minio", "server", "/data", "--console-address", ":9001"]
|
||||||
|
env:
|
||||||
|
- name: MINIO_ROOT_USER
|
||||||
|
value: minioadmin
|
||||||
|
- name: MINIO_ROOT_PASSWORD
|
||||||
|
value: minioadmin
|
||||||
|
ports:
|
||||||
|
- containerPort: 9000
|
||||||
|
- containerPort: 9001
|
||||||
|
volumeMounts:
|
||||||
|
- name: minio-storage
|
||||||
|
mountPath: /data
|
||||||
|
livenessProbe:
|
||||||
|
httpGet:
|
||||||
|
path: /minio/health/live
|
||||||
|
port: 9000
|
||||||
|
initialDelaySeconds: 30
|
||||||
|
periodSeconds: 30
|
||||||
|
volumes:
|
||||||
|
- name: minio-storage
|
||||||
|
persistentVolumeClaim:
|
||||||
|
claimName: minio-pvc
|
||||||
|
---
|
||||||
|
apiVersion: v1
|
||||||
|
kind: Service
|
||||||
|
metadata:
|
||||||
|
name: minio-service
|
||||||
|
namespace: artifact-storage
|
||||||
|
spec:
|
||||||
|
selector:
|
||||||
|
app: minio
|
||||||
|
ports:
|
||||||
|
- name: api
|
||||||
|
port: 9000
|
||||||
|
targetPort: 9000
|
||||||
|
- name: console
|
||||||
|
port: 9001
|
||||||
|
targetPort: 9001
|
||||||
|
---
|
||||||
|
apiVersion: v1
|
||||||
|
kind: PersistentVolumeClaim
|
||||||
|
metadata:
|
||||||
|
name: minio-pvc
|
||||||
|
namespace: artifact-storage
|
||||||
|
spec:
|
||||||
|
accessModes:
|
||||||
|
- ReadWriteOnce
|
||||||
|
resources:
|
||||||
|
requests:
|
||||||
|
storage: 50Gi
|
||||||
|
```
|
||||||
|
|
||||||
|
### 7. Artifact API Deployment
|
||||||
|
```yaml
|
||||||
|
apiVersion: apps/v1
|
||||||
|
kind: Deployment
|
||||||
|
metadata:
|
||||||
|
name: artifactapi
|
||||||
|
namespace: artifact-storage
|
||||||
|
spec:
|
||||||
|
replicas: 2
|
||||||
|
selector:
|
||||||
|
matchLabels:
|
||||||
|
app: artifactapi
|
||||||
|
template:
|
||||||
|
metadata:
|
||||||
|
labels:
|
||||||
|
app: artifactapi
|
||||||
|
spec:
|
||||||
|
containers:
|
||||||
|
- name: artifactapi
|
||||||
|
image: artifactapi:latest
|
||||||
|
ports:
|
||||||
|
- containerPort: 8000
|
||||||
|
envFrom:
|
||||||
|
- secretRef:
|
||||||
|
name: artifactapi-secret
|
||||||
|
volumeMounts:
|
||||||
|
- name: config-volume
|
||||||
|
mountPath: /app/remotes.yaml
|
||||||
|
subPath: remotes.yaml
|
||||||
|
livenessProbe:
|
||||||
|
httpGet:
|
||||||
|
path: /health
|
||||||
|
port: 8000
|
||||||
|
initialDelaySeconds: 30
|
||||||
|
periodSeconds: 30
|
||||||
|
readinessProbe:
|
||||||
|
httpGet:
|
||||||
|
path: /health
|
||||||
|
port: 8000
|
||||||
|
initialDelaySeconds: 10
|
||||||
|
periodSeconds: 5
|
||||||
|
resources:
|
||||||
|
requests:
|
||||||
|
memory: "256Mi"
|
||||||
|
cpu: "250m"
|
||||||
|
limits:
|
||||||
|
memory: "512Mi"
|
||||||
|
cpu: "500m"
|
||||||
|
volumes:
|
||||||
|
- name: config-volume
|
||||||
|
configMap:
|
||||||
|
name: artifactapi-config
|
||||||
|
---
|
||||||
|
apiVersion: v1
|
||||||
|
kind: Service
|
||||||
|
metadata:
|
||||||
|
name: artifactapi-service
|
||||||
|
namespace: artifact-storage
|
||||||
|
spec:
|
||||||
|
selector:
|
||||||
|
app: artifactapi
|
||||||
|
ports:
|
||||||
|
- port: 8000
|
||||||
|
targetPort: 8000
|
||||||
|
type: ClusterIP
|
||||||
|
```
|
||||||
|
|
||||||
|
### 8. Ingress (Optional)
|
||||||
|
```yaml
|
||||||
|
apiVersion: networking.k8s.io/v1
|
||||||
|
kind: Ingress
|
||||||
|
metadata:
|
||||||
|
name: artifactapi-ingress
|
||||||
|
namespace: artifact-storage
|
||||||
|
annotations:
|
||||||
|
nginx.ingress.kubernetes.io/rewrite-target: /
|
||||||
|
nginx.ingress.kubernetes.io/proxy-body-size: "10g"
|
||||||
|
nginx.ingress.kubernetes.io/proxy-read-timeout: "600"
|
||||||
|
spec:
|
||||||
|
rules:
|
||||||
|
- host: artifacts.example.com
|
||||||
|
http:
|
||||||
|
paths:
|
||||||
|
- path: /
|
||||||
|
pathType: Prefix
|
||||||
|
backend:
|
||||||
|
service:
|
||||||
|
name: artifactapi-service
|
||||||
|
port:
|
||||||
|
number: 8000
|
||||||
|
```
|
||||||
|
|
||||||
|
### Deployment Commands
|
||||||
|
```bash
|
||||||
|
# Create namespace
|
||||||
|
kubectl apply -f namespace.yaml
|
||||||
|
|
||||||
|
# Deploy PostgreSQL, Redis, and MinIO
|
||||||
|
kubectl apply -f postgres.yaml
|
||||||
|
kubectl apply -f redis.yaml
|
||||||
|
kubectl apply -f minio.yaml
|
||||||
|
|
||||||
|
# Wait for databases to be ready
|
||||||
|
kubectl wait --for=condition=ready pod -l app=postgres -n artifact-storage --timeout=300s
|
||||||
|
kubectl wait --for=condition=ready pod -l app=redis -n artifact-storage --timeout=300s
|
||||||
|
kubectl wait --for=condition=ready pod -l app=minio -n artifact-storage --timeout=300s
|
||||||
|
|
||||||
|
# Deploy configuration and application
|
||||||
|
kubectl apply -f configmap.yaml
|
||||||
|
kubectl apply -f secret.yaml
|
||||||
|
kubectl apply -f artifactapi.yaml
|
||||||
|
|
||||||
|
# Optional: Deploy ingress
|
||||||
|
kubectl apply -f ingress.yaml
|
||||||
|
|
||||||
|
# Check deployment status
|
||||||
|
kubectl get pods -n artifact-storage
|
||||||
|
kubectl logs -f deployment/artifactapi -n artifact-storage
|
||||||
|
```
|
||||||
|
|
||||||
|
### Access the API
|
||||||
|
```bash
|
||||||
|
# Port-forward to access locally
|
||||||
|
kubectl port-forward service/artifactapi-service 8000:8000 -n artifact-storage
|
||||||
|
|
||||||
|
# Test the API
|
||||||
|
curl http://localhost:8000/health
|
||||||
|
curl http://localhost:8000/
|
||||||
|
|
||||||
|
# Access artifacts
|
||||||
|
curl "http://localhost:8000/api/github/gruntwork-io/terragrunt/releases/download/v0.96.1/terragrunt_linux_amd64"
|
||||||
|
```
|
||||||
|
|
||||||
|
### Notes for Production
|
||||||
|
- Use proper secrets management (e.g., Vault, Sealed Secrets)
|
||||||
|
- Configure resource limits and requests appropriately
|
||||||
|
- Set up monitoring and alerting
|
||||||
|
- Use external managed databases for production workloads
|
||||||
|
- Configure backup strategies for persistent volumes
|
||||||
|
- Set up proper TLS certificates for ingress
|
||||||
|
- Consider using StatefulSets for databases with persistent storage
|
||||||
@@ -1,57 +0,0 @@
|
|||||||
package main
|
|
||||||
|
|
||||||
import (
|
|
||||||
"context"
|
|
||||||
"fmt"
|
|
||||||
"log/slog"
|
|
||||||
"os"
|
|
||||||
"os/signal"
|
|
||||||
"syscall"
|
|
||||||
|
|
||||||
"git.unkin.net/unkin/artifactapi/internal/config"
|
|
||||||
"git.unkin.net/unkin/artifactapi/internal/server"
|
|
||||||
"git.unkin.net/unkin/artifactapi/internal/tui"
|
|
||||||
)
|
|
||||||
|
|
||||||
var version = "dev"
|
|
||||||
|
|
||||||
func main() {
|
|
||||||
if len(os.Args) > 1 && os.Args[1] == "tui" {
|
|
||||||
endpoint := os.Getenv("ARTIFACTAPI_ENDPOINT")
|
|
||||||
if endpoint == "" {
|
|
||||||
endpoint = "http://localhost:8000"
|
|
||||||
}
|
|
||||||
for i, arg := range os.Args {
|
|
||||||
if arg == "--endpoint" && i+1 < len(os.Args) {
|
|
||||||
endpoint = os.Args[i+1]
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
app := tui.New(endpoint)
|
|
||||||
if err := app.Run(); err != nil {
|
|
||||||
fmt.Fprintf(os.Stderr, "tui error: %v\n", err)
|
|
||||||
os.Exit(1)
|
|
||||||
}
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
cfg, err := config.Load()
|
|
||||||
if err != nil {
|
|
||||||
slog.Error("failed to load config", "error", err)
|
|
||||||
os.Exit(1)
|
|
||||||
}
|
|
||||||
|
|
||||||
ctx, cancel := signal.NotifyContext(context.Background(), syscall.SIGINT, syscall.SIGTERM)
|
|
||||||
defer cancel()
|
|
||||||
|
|
||||||
srv, err := server.New(cfg, version)
|
|
||||||
if err != nil {
|
|
||||||
slog.Error("failed to create server", "error", err)
|
|
||||||
os.Exit(1)
|
|
||||||
}
|
|
||||||
|
|
||||||
if err := srv.Run(ctx); err != nil {
|
|
||||||
slog.Error("server exited with error", "error", err)
|
|
||||||
os.Exit(1)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,34 +0,0 @@
|
|||||||
# Overlay for the dockerised end-to-end suite (scripts/docker-e2e.sh).
|
|
||||||
# Adds a static mock upstream that the artifactapi container proxies, so the
|
|
||||||
# caching tests are hermetic and need no internet access.
|
|
||||||
services:
|
|
||||||
mockupstream:
|
|
||||||
image: nginx:alpine
|
|
||||||
volumes:
|
|
||||||
- ./e2e-docker/fixtures:/usr/share/nginx/html:ro,z
|
|
||||||
# No host port needed: only the artifactapi container talks to it, and the
|
|
||||||
# tests compare served bytes against the on-disk fixtures.
|
|
||||||
|
|
||||||
# Two constant-body upstreams for the multi-base_url suite: each returns a
|
|
||||||
# distinct, upstream-identifying body for any path, so round-robin
|
|
||||||
# distribution across a two-mirror remote is directly observable.
|
|
||||||
mockupstreama:
|
|
||||||
image: nginx:alpine
|
|
||||||
volumes:
|
|
||||||
- ./e2e-docker/mirror-conf/a.conf:/etc/nginx/conf.d/default.conf:ro,z
|
|
||||||
mockupstreamb:
|
|
||||||
image: nginx:alpine
|
|
||||||
volumes:
|
|
||||||
- ./e2e-docker/mirror-conf/b.conf:/etc/nginx/conf.d/default.conf:ro,z
|
|
||||||
|
|
||||||
artifactapi:
|
|
||||||
# The host port is set via ARTIFACTAPI_PORT (see scripts/docker-e2e.sh),
|
|
||||||
# defaulting to 8000; the e2e run uses 8001 to avoid colliding with a
|
|
||||||
# locally-running instance.
|
|
||||||
depends_on:
|
|
||||||
mockupstream:
|
|
||||||
condition: service_started
|
|
||||||
mockupstreama:
|
|
||||||
condition: service_started
|
|
||||||
mockupstreamb:
|
|
||||||
condition: service_started
|
|
||||||
+51
-56
@@ -1,22 +1,26 @@
|
|||||||
|
version: '3.8'
|
||||||
|
|
||||||
services:
|
services:
|
||||||
artifactapi:
|
artifactapi:
|
||||||
build: .
|
build:
|
||||||
|
context: .
|
||||||
|
dockerfile: Dockerfile
|
||||||
|
no_cache: true
|
||||||
ports:
|
ports:
|
||||||
- "${ARTIFACTAPI_PORT:-8000}:8000"
|
- "8000:8000"
|
||||||
environment:
|
environment:
|
||||||
LISTEN_ADDR: ":8000"
|
- CONFIG_PATH=/app/remotes.yaml
|
||||||
DBHOST: postgres
|
- DBHOST=postgres
|
||||||
DBPORT: "5432"
|
- DBPORT=5432
|
||||||
DBUSER: artifacts
|
- DBUSER=artifacts
|
||||||
DBPASS: artifacts123
|
- DBPASS=artifacts123
|
||||||
DBNAME: artifacts
|
- DBNAME=artifacts
|
||||||
DBSSL: disable
|
- REDIS_URL=redis://redis:6379
|
||||||
REDIS_URL: redis://redis:6379
|
- MINIO_ENDPOINT=minio:9000
|
||||||
MINIO_ENDPOINT: minio:9000
|
- MINIO_ACCESS_KEY=minioadmin
|
||||||
MINIO_ACCESS_KEY: minioadmin
|
- MINIO_SECRET_KEY=minioadmin
|
||||||
MINIO_SECRET_KEY: minioadmin
|
- MINIO_BUCKET=artifacts
|
||||||
MINIO_BUCKET: artifacts
|
- MINIO_SECURE=false
|
||||||
MINIO_SECURE: "false"
|
|
||||||
depends_on:
|
depends_on:
|
||||||
postgres:
|
postgres:
|
||||||
condition: service_healthy
|
condition: service_healthy
|
||||||
@@ -25,35 +29,27 @@ services:
|
|||||||
minio:
|
minio:
|
||||||
condition: service_healthy
|
condition: service_healthy
|
||||||
healthcheck:
|
healthcheck:
|
||||||
test: ["CMD", "wget", "-q", "--spider", "http://localhost:8000/health"]
|
test: ["CMD", "curl", "-f", "http://localhost:8000/health"]
|
||||||
interval: 10s
|
interval: 30s
|
||||||
timeout: 5s
|
timeout: 10s
|
||||||
retries: 3
|
retries: 3
|
||||||
|
|
||||||
ui:
|
minio:
|
||||||
build:
|
image: minio/minio:latest
|
||||||
context: ui
|
|
||||||
dockerfile: Dockerfile.ui
|
|
||||||
ports:
|
ports:
|
||||||
- "8080:80"
|
- "9000:9000"
|
||||||
depends_on:
|
- "9001:9001"
|
||||||
- artifactapi
|
|
||||||
|
|
||||||
postgres:
|
|
||||||
image: postgres:17-alpine
|
|
||||||
ports:
|
|
||||||
- "5432:5432"
|
|
||||||
environment:
|
environment:
|
||||||
POSTGRES_USER: artifacts
|
MINIO_ROOT_USER: minioadmin
|
||||||
POSTGRES_PASSWORD: artifacts123
|
MINIO_ROOT_PASSWORD: minioadmin
|
||||||
POSTGRES_DB: artifacts
|
command: server /data --console-address ":9001"
|
||||||
volumes:
|
volumes:
|
||||||
- postgres_data:/var/lib/postgresql/data
|
- minio_data:/data
|
||||||
healthcheck:
|
healthcheck:
|
||||||
test: ["CMD-SHELL", "pg_isready -U artifacts -d artifacts"]
|
test: ["CMD", "curl", "-f", "http://localhost:9000/minio/health/live"]
|
||||||
interval: 5s
|
interval: 30s
|
||||||
timeout: 5s
|
timeout: 20s
|
||||||
retries: 5
|
retries: 3
|
||||||
|
|
||||||
redis:
|
redis:
|
||||||
image: redis:7-alpine
|
image: redis:7-alpine
|
||||||
@@ -64,28 +60,27 @@ services:
|
|||||||
command: redis-server --save 20 1
|
command: redis-server --save 20 1
|
||||||
healthcheck:
|
healthcheck:
|
||||||
test: ["CMD", "redis-cli", "ping"]
|
test: ["CMD", "redis-cli", "ping"]
|
||||||
interval: 5s
|
interval: 30s
|
||||||
timeout: 5s
|
timeout: 10s
|
||||||
retries: 5
|
retries: 3
|
||||||
|
|
||||||
minio:
|
postgres:
|
||||||
image: minio/minio:latest
|
image: postgres:15-alpine
|
||||||
command: server /data --console-address ":9001"
|
|
||||||
environment:
|
|
||||||
MINIO_ROOT_USER: minioadmin
|
|
||||||
MINIO_ROOT_PASSWORD: minioadmin
|
|
||||||
ports:
|
ports:
|
||||||
- "9000:9000"
|
- "5432:5432"
|
||||||
- "9001:9001"
|
environment:
|
||||||
|
POSTGRES_DB: artifacts
|
||||||
|
POSTGRES_USER: artifacts
|
||||||
|
POSTGRES_PASSWORD: artifacts123
|
||||||
volumes:
|
volumes:
|
||||||
- minio_data:/data
|
- postgres_data:/var/lib/postgresql/data
|
||||||
healthcheck:
|
healthcheck:
|
||||||
test: ["CMD", "mc", "ready", "local"]
|
test: ["CMD-SHELL", "pg_isready -U artifacts -d artifacts"]
|
||||||
interval: 5s
|
interval: 30s
|
||||||
timeout: 5s
|
timeout: 10s
|
||||||
retries: 5
|
retries: 3
|
||||||
|
|
||||||
volumes:
|
volumes:
|
||||||
postgres_data:
|
|
||||||
redis_data:
|
|
||||||
minio_data:
|
minio_data:
|
||||||
|
redis_data:
|
||||||
|
postgres_data:
|
||||||
|
|||||||
@@ -1,7 +0,0 @@
|
|||||||
# `github_alpine` remote
|
|
||||||
|
|
||||||
Shared classification, TTL and eviction rules: [caching](../common/caching.md).
|
|
||||||
|
|
||||||
| Type | Mutable (auto-detected) | Immutable (auto-detected) |
|
|
||||||
|---|---|---|
|
|
||||||
| `github_alpine` | `APKINDEX.tar.gz` (synthesized) | `.apk` (redirected) |
|
|
||||||
@@ -1,7 +0,0 @@
|
|||||||
# `alpine` remote
|
|
||||||
|
|
||||||
Shared classification, TTL and eviction rules: [caching](../common/caching.md).
|
|
||||||
|
|
||||||
| Type | Mutable (auto-detected) | Immutable (auto-detected) |
|
|
||||||
|---|---|---|
|
|
||||||
| `alpine` | `APKINDEX.tar.gz` | `.apk` |
|
|
||||||
@@ -1,7 +0,0 @@
|
|||||||
# `cargo` remote
|
|
||||||
|
|
||||||
Shared classification, TTL and eviction rules: [caching](../common/caching.md).
|
|
||||||
|
|
||||||
| Type | Mutable (auto-detected) | Immutable (auto-detected) |
|
|
||||||
|---|---|---|
|
|
||||||
| `cargo` | sparse index files (`config.json` synthesized) | `crates/*/*.crate` |
|
|
||||||
@@ -1,100 +0,0 @@
|
|||||||
# Caching and classification (all remotes)
|
|
||||||
|
|
||||||
Every proxied request on a remote is classified as **denied**, **immutable** or
|
|
||||||
**mutable**. The class picks the storage path and the freshness TTL.
|
|
||||||
|
|
||||||
## Fields
|
|
||||||
|
|
||||||
| Field | Meaning |
|
|
||||||
|---|---|
|
|
||||||
| `patterns` | Allowlist of regexes. Empty allows every path; otherwise a non-matching path is denied (403). |
|
|
||||||
| `blocklist` | Regexes; a match is denied (403). |
|
|
||||||
| `immutable_patterns` | Regexes forcing a path immutable. |
|
|
||||||
| `mutable_patterns` | Regexes forcing a path mutable. |
|
|
||||||
| `immutable_ttl` | Seconds an immutable path stays fresh. `0` = forever. |
|
|
||||||
| `mutable_ttl` | Seconds a mutable path stays fresh. `0` also means never expires, and the API stores `0` when the field is omitted. |
|
|
||||||
| `check_mutable` | Stores the upstream ETag and tries a conditional `HEAD` (`If-None-Match`) when a mutable path is fetched. The ETag expires with the `mutable_ttl` freshness key, so an expired mutable path is refetched in full, not revalidated. |
|
|
||||||
| `stale_on_error` | On an upstream network error, serve the stored copy instead of failing. |
|
|
||||||
| `quarantine_enabled` / `quarantine_days` | Stored on the remote but not enforced by the proxy yet. |
|
|
||||||
| `mirrorlist` / `mirror_strategy` | rpm/deb/alpine only. Upstream pool is `[base_url] + mirrorlist`; `round_robin` (default) rotates the starting mirror, `least_conn` starts at the one with the fewest in-flight requests. Network errors and 5xx fail over to the next mirror; other statuses return as-is. |
|
|
||||||
|
|
||||||
## Precedence
|
|
||||||
|
|
||||||
The first rule that matches wins:
|
|
||||||
|
|
||||||
1. `blocklist` matches: **denied**
|
|
||||||
2. `patterns` is non-empty and nothing matches: **denied**
|
|
||||||
3. `immutable_patterns` matches: **immutable**
|
|
||||||
4. `mutable_patterns` matches: **mutable**
|
|
||||||
5. the provider's built-in `Classify` says mutable: **mutable**
|
|
||||||
6. anything else: **immutable**
|
|
||||||
|
|
||||||
So `blocklist` beats the allowlist, and `immutable_patterns` beats
|
|
||||||
`mutable_patterns`. Either user list overrides the built-in rules. `GET` and
|
|
||||||
`HEAD` both apply this order.
|
|
||||||
|
|
||||||
## Matching rules
|
|
||||||
|
|
||||||
- Regexes are Go `regexp`, matched **unanchored** (`MatchString`). Add `^` or `$` yourself when you need them.
|
|
||||||
- They match the path after `/api/v1/remote/<name>/`, without a leading slash, e.g. `9/BaseOS/x86_64/os/repodata/repomd.xml`.
|
|
||||||
- The query string is not part of the path. It is dropped and not forwarded upstream.
|
|
||||||
- `create` and `update` reject an invalid regex in `patterns`, `blocklist`, `mutable_patterns`, `immutable_patterns` or `ban_tags` with a 400. Only invalid regexes already stored before that check are skipped at match time.
|
|
||||||
|
|
||||||
## Lifecycles
|
|
||||||
|
|
||||||
| | Immutable | Mutable |
|
|
||||||
|---|---|---|
|
|
||||||
| Stored as | content-addressed blob (sha256), streamed | per-path index object, buffered and rewritten by the provider |
|
|
||||||
| Fresh for | `immutable_ttl` (`0` = forever) | `mutable_ttl` |
|
|
||||||
| After expiry | refetched from upstream | refetched from upstream (the ETag expires with the TTL, so `check_mutable` does not revalidate it) |
|
|
||||||
| Upstream down | `stale_on_error` serves the stored copy and re-arms the TTL; an open circuit breaker always serves stale if a copy exists, else 503 | same |
|
|
||||||
|
|
||||||
Concurrent misses on one path share a fetch lock. Waiters poll the store for
|
|
||||||
up to 5s instead of all going upstream.
|
|
||||||
|
|
||||||
## Eviction
|
|
||||||
|
|
||||||
```sh
|
|
||||||
curl -X DELETE https://artifactapi.example.com/api/v2/remotes/<name>/objects/<path>
|
|
||||||
curl -X DELETE https://artifactapi.example.com/api/v2/remotes/<name>/objects/<dir>/*
|
|
||||||
```
|
|
||||||
|
|
||||||
- Evict drops the artifact row, the index object and the Redis TTL and ETag keys, so the next request goes upstream whatever the class or TTL.
|
|
||||||
- A single-path evict takes the fetch lock first, so an in-flight fetch can't re-cache the path. It returns 503 if the lock stays busy.
|
|
||||||
- A wildcard must end in `<dir>/*` and takes no lock.
|
|
||||||
- Returns 204, or 404 for an unknown remote.
|
|
||||||
|
|
||||||
## Examples
|
|
||||||
|
|
||||||
Bodies for `POST https://artifactapi.example.com/api/v2/remotes`.
|
|
||||||
|
|
||||||
GitHub release assets through a `generic` remote, allowlisted:
|
|
||||||
|
|
||||||
```json
|
|
||||||
{"name": "github", "package_type": "generic", "base_url": "https://github.com",
|
|
||||||
"immutable_ttl": 0, "mutable_ttl": 7200,
|
|
||||||
"patterns": ["^mikefarah/yq/releases/download/.*/yq_linux_amd64$"]}
|
|
||||||
```
|
|
||||||
|
|
||||||
rpm remote: `repodata/*` and `repomd.xml` are mutable by default, so only the TTLs are needed:
|
|
||||||
|
|
||||||
```json
|
|
||||||
{"name": "almalinux", "package_type": "rpm", "base_url": "https://repo.almalinux.org/almalinux",
|
|
||||||
"immutable_ttl": 0, "mutable_ttl": 3600, "check_mutable": true, "stale_on_error": true}
|
|
||||||
```
|
|
||||||
|
|
||||||
Force a moving path mutable, e.g. branch tarballs on `generic`:
|
|
||||||
|
|
||||||
```json
|
|
||||||
{"mutable_patterns": ["/archive/refs/heads/.*\\.tar\\.gz$"], "mutable_ttl": 600}
|
|
||||||
```
|
|
||||||
|
|
||||||
## Built-in classification per type
|
|
||||||
|
|
||||||
Each type's page lists its auto-detected mutable and immutable paths:
|
|
||||||
[alpine](../alpine/remote.md), [alpine github](../alpine/remote-github.md),
|
|
||||||
[cargo](../cargo/remote.md), [deb](../deb/remote.md), [deb github](../deb/remote-github.md),
|
|
||||||
[docker](../docker/remote.md), [generic](../generic/remote.md), [goproxy](../goproxy/remote.md),
|
|
||||||
[helm](../helm/remote.md), [npm](../npm/remote.md), [nuget](../nuget/remote.md),
|
|
||||||
[puppet](../puppet/remote.md), [pypi](../pypi/remote.md), [rpm](../rpm/remote.md),
|
|
||||||
[rpm github](../rpm/remote-github.md), [terraform](../terraform/remote.md).
|
|
||||||
@@ -1,7 +0,0 @@
|
|||||||
# `github_deb` remote
|
|
||||||
|
|
||||||
Shared classification, TTL and eviction rules: [caching](../common/caching.md).
|
|
||||||
|
|
||||||
| Type | Mutable (auto-detected) | Immutable (auto-detected) |
|
|
||||||
|---|---|---|
|
|
||||||
| `github_deb` | `Packages*`, `Release*` (synthesized) | `.deb` (redirected) |
|
|
||||||
@@ -1,7 +0,0 @@
|
|||||||
# `deb` remote
|
|
||||||
|
|
||||||
Shared classification, TTL and eviction rules: [caching](../common/caching.md).
|
|
||||||
|
|
||||||
| Type | Mutable (auto-detected) | Immutable (auto-detected) |
|
|
||||||
|---|---|---|
|
|
||||||
| `deb` | `Packages*`, `Sources*`, `Release`, `InRelease`, `Release.gpg`, `Contents-*` | `.deb` |
|
|
||||||
@@ -1,17 +0,0 @@
|
|||||||
# Local docker registry
|
|
||||||
|
|
||||||
A local `docker` repo is a real container registry, not a mirror: it serves the
|
|
||||||
Docker Registry HTTP API V2 for both push and pull, so any client (`docker`,
|
|
||||||
`podman`, `skopeo`, `buildah`) can use it directly.
|
|
||||||
|
|
||||||
```sh
|
|
||||||
docker tag myapp:latest artifactapi.example.com/docker-internal/myapp:latest
|
|
||||||
docker push artifactapi.example.com/docker-internal/myapp:latest
|
|
||||||
docker pull artifactapi.example.com/docker-internal/myapp:latest
|
|
||||||
```
|
|
||||||
|
|
||||||
The first path segment after `/v2/` is the artifactapi repo name; the remainder
|
|
||||||
is the image name. Blobs and manifests are stored through the shared
|
|
||||||
content-addressable store (deduplicated by digest, reaped by GC once
|
|
||||||
unreferenced); tags are mutable references and re-pushing a tag moves it. Blob
|
|
||||||
uploads support both the monolithic and chunked (`POST`/`PATCH`/`PUT`) flows.
|
|
||||||
@@ -1,26 +0,0 @@
|
|||||||
# `docker` remote
|
|
||||||
|
|
||||||
Shared classification, TTL and eviction rules: [caching](../common/caching.md).
|
|
||||||
|
|
||||||
| Type | Mutable (auto-detected) | Immutable (auto-detected) |
|
|
||||||
|---|---|---|
|
|
||||||
| `docker` | tag manifests, `/tags/list` | blobs, digest manifests |
|
|
||||||
|
|
||||||
## Terraform
|
|
||||||
|
|
||||||
```hcl
|
|
||||||
resource "artifactapi_remote_docker" "dockerhub" {
|
|
||||||
name = "dockerhub"
|
|
||||||
base_url = "https://registry-1.docker.io"
|
|
||||||
|
|
||||||
immutable_ttl = 0
|
|
||||||
mutable_ttl = 300
|
|
||||||
ban_tags_enabled = true
|
|
||||||
ban_tags = ["latest"]
|
|
||||||
|
|
||||||
patterns = [
|
|
||||||
"^library/postgres",
|
|
||||||
"^library/redis",
|
|
||||||
]
|
|
||||||
}
|
|
||||||
```
|
|
||||||
@@ -1,28 +0,0 @@
|
|||||||
# `generic` remote
|
|
||||||
|
|
||||||
Shared classification, TTL and eviction rules: [caching](../common/caching.md).
|
|
||||||
|
|
||||||
| Type | Mutable (auto-detected) | Immutable (auto-detected) |
|
|
||||||
|---|---|---|
|
|
||||||
| `generic` | nothing | everything |
|
|
||||||
|
|
||||||
## Terraform
|
|
||||||
|
|
||||||
```hcl
|
|
||||||
resource "artifactapi_remote_generic" "github" {
|
|
||||||
name = "github"
|
|
||||||
base_url = "https://github.com"
|
|
||||||
|
|
||||||
immutable_ttl = 0
|
|
||||||
mutable_ttl = 7200
|
|
||||||
|
|
||||||
patterns = [
|
|
||||||
"ducaale/xh/.*/xh-.*-x86_64-unknown-linux-musl.tar.gz$",
|
|
||||||
"mikefarah/yq/.*/yq_linux_amd64$",
|
|
||||||
]
|
|
||||||
|
|
||||||
mutable_patterns = [
|
|
||||||
".*/archive/refs/heads/.*\\.tar\\.gz$",
|
|
||||||
]
|
|
||||||
}
|
|
||||||
```
|
|
||||||
@@ -1,7 +0,0 @@
|
|||||||
# `goproxy` remote
|
|
||||||
|
|
||||||
Shared classification, TTL and eviction rules: [caching](../common/caching.md).
|
|
||||||
|
|
||||||
| Type | Mutable (auto-detected) | Immutable (auto-detected) |
|
|
||||||
|---|---|---|
|
|
||||||
| `goproxy` | `@v/list`, `@latest` | `.info`, `.mod`, `.zip` |
|
|
||||||
@@ -1,15 +0,0 @@
|
|||||||
# Local helm repository
|
|
||||||
|
|
||||||
A local `helm` repo is a real chart repository: `PUT` a packaged chart to
|
|
||||||
`/api/v2/remotes/<repo>/files/<chart>-<version>.tgz` and `index.yaml` is
|
|
||||||
generated from each chart's `Chart.yaml` (with sha256 digests) at
|
|
||||||
`/api/v1/local/<repo>/index.yaml`; a file not named after its `Chart.yaml`
|
|
||||||
name and version is stored but left out of the index. Add the local as a
|
|
||||||
member of a helm virtual to serve it alongside remotes.
|
|
||||||
|
|
||||||
```bash
|
|
||||||
helm package ./mychart
|
|
||||||
curl -fsSL --upload-file mychart-0.1.0.tgz \
|
|
||||||
https://artifactapi.example.com/api/v2/remotes/<repo>/files/mychart-0.1.0.tgz
|
|
||||||
helm repo add <repo> https://artifactapi.example.com/api/v1/local/<repo>
|
|
||||||
```
|
|
||||||
@@ -1,19 +0,0 @@
|
|||||||
# `helm` remote
|
|
||||||
|
|
||||||
Shared classification, TTL and eviction rules: [caching](../common/caching.md).
|
|
||||||
|
|
||||||
| Type | Mutable (auto-detected) | Immutable (auto-detected) |
|
|
||||||
|---|---|---|
|
|
||||||
| `helm` | `index.yaml` | `.tgz` charts |
|
|
||||||
|
|
||||||
## Terraform
|
|
||||||
|
|
||||||
```hcl
|
|
||||||
resource "artifactapi_remote_helm" "jetstack" {
|
|
||||||
name = "jetstack"
|
|
||||||
base_url = "https://charts.jetstack.io"
|
|
||||||
|
|
||||||
immutable_ttl = 0
|
|
||||||
mutable_ttl = 3600
|
|
||||||
}
|
|
||||||
```
|
|
||||||
@@ -1,9 +0,0 @@
|
|||||||
# `helm` virtual
|
|
||||||
|
|
||||||
```hcl
|
|
||||||
resource "artifactapi_virtual" "helm" {
|
|
||||||
name = "helm"
|
|
||||||
package_type = "helm"
|
|
||||||
members = [artifactapi_remote_helm.jetstack.name]
|
|
||||||
}
|
|
||||||
```
|
|
||||||
@@ -1,7 +0,0 @@
|
|||||||
# `npm` remote
|
|
||||||
|
|
||||||
Shared classification, TTL and eviction rules: [caching](../common/caching.md).
|
|
||||||
|
|
||||||
| Type | Mutable (auto-detected) | Immutable (auto-detected) |
|
|
||||||
|---|---|---|
|
|
||||||
| `npm` | package metadata | `.tgz` tarballs |
|
|
||||||
@@ -1,7 +0,0 @@
|
|||||||
# `nuget` remote
|
|
||||||
|
|
||||||
Shared classification, TTL and eviction rules: [caching](../common/caching.md).
|
|
||||||
|
|
||||||
| Type | Mutable (auto-detected) | Immutable (auto-detected) |
|
|
||||||
|---|---|---|
|
|
||||||
| `nuget` | `index.json` (service index), registration and flat container indexes | `.nupkg`, `.nuspec` |
|
|
||||||
@@ -1,14 +0,0 @@
|
|||||||
# Local puppet forge
|
|
||||||
|
|
||||||
A local `puppet` repo is a Forge: `PUT` a module tarball to
|
|
||||||
`/api/v2/remotes/<repo>/files/<owner>-<module>-<version>.tar.gz` and the Forge
|
|
||||||
v3 API (`/v3/modules`, `/v3/releases`, `/v3/files`) is served from each
|
|
||||||
release's `metadata.json` at `/api/v1/local/<repo>`. Versions are immutable.
|
|
||||||
|
|
||||||
```bash
|
|
||||||
puppet module build ./hello
|
|
||||||
curl -fsSL --upload-file pkg/unkin-hello-0.1.0.tar.gz \
|
|
||||||
https://artifactapi.example.com/api/v2/remotes/<repo>/files/unkin-hello-0.1.0.tar.gz
|
|
||||||
puppet module install unkin-hello \
|
|
||||||
--module_repository https://artifactapi.example.com/api/v1/local/<repo>
|
|
||||||
```
|
|
||||||
@@ -1,7 +0,0 @@
|
|||||||
# `puppet` remote
|
|
||||||
|
|
||||||
Shared classification, TTL and eviction rules: [caching](../common/caching.md).
|
|
||||||
|
|
||||||
| Type | Mutable (auto-detected) | Immutable (auto-detected) |
|
|
||||||
|---|---|---|
|
|
||||||
| `puppet` | `v3/modules/*`, `v3/releases*` | `.tar.gz` |
|
|
||||||
@@ -1,7 +0,0 @@
|
|||||||
# `pypi` remote
|
|
||||||
|
|
||||||
Shared classification, TTL and eviction rules: [caching](../common/caching.md).
|
|
||||||
|
|
||||||
| Type | Mutable (auto-detected) | Immutable (auto-detected) |
|
|
||||||
|---|---|---|
|
|
||||||
| `pypi` | `simple/*` index pages | `.whl`, `.tar.gz` |
|
|
||||||
@@ -1,82 +0,0 @@
|
|||||||
# `github_rpm` remote
|
|
||||||
|
|
||||||
Shared classification, TTL and eviction rules: [caching](../common/caching.md).
|
|
||||||
|
|
||||||
| Type | Mutable (auto-detected) | Immutable (auto-detected) |
|
|
||||||
|---|---|---|
|
|
||||||
| `github_rpm` | `repodata/*` (synthesized) | `.rpm` (redirected) |
|
|
||||||
|
|
||||||
## GitHub releases as a yum repo (metadata-only, no precache)
|
|
||||||
|
|
||||||
A `github_rpm` remote turns a GitHub repo's **releases** into a real `dnf`/`yum`
|
|
||||||
repository without ever caching the packages. It scans releases for `.rpm`
|
|
||||||
assets, derives each package's metadata (NEVRA, requires/provides/conflicts/
|
|
||||||
obsoletes, files, checksum) and **synthesizes `repodata/` on the fly**. Package
|
|
||||||
metadata comes from a **ranged GET of just the RPM header** (the header sits at
|
|
||||||
the front of the file, so the whole package is never downloaded); the sha256
|
|
||||||
checksum comes from the GitHub asset `digest` when present, else a one-time
|
|
||||||
lazy stream. Derived metadata is cached (keyed by asset) so repodata generation
|
|
||||||
is served from primed DB rows, never a cold on-demand derive.
|
|
||||||
|
|
||||||
Each package's `<location>` points back at the remote, which **302-redirects**
|
|
||||||
the download to the `releases_remote` — an existing generic `github.com` remote
|
|
||||||
that streams the actual bytes. `dnf` follows the redirect transparently.
|
|
||||||
|
|
||||||
### Background syncer
|
|
||||||
|
|
||||||
A single process-wide **background syncer** keeps every `github_rpm` remote's
|
|
||||||
derived metadata current off the client request path:
|
|
||||||
|
|
||||||
- **Prime on create.** Creating a `github_rpm` remote enqueues a background prime
|
|
||||||
scan, so its metadata is derived right away without blocking the create call.
|
|
||||||
The first `dnf` request is served from cache. If a request arrives before the
|
|
||||||
prime lands, it returns a retryable `503` (with `Retry-After`) rather than
|
|
||||||
serving an empty repo or blocking on a multi-minute derive.
|
|
||||||
- **Periodic re-check, driven by `mutable_ttl`.** Each remote is re-checked for
|
|
||||||
new or changed releases no more often than its `mutable_ttl`. New/changed
|
|
||||||
assets are derived incrementally; assets already cached are never re-fetched,
|
|
||||||
and assets that disappear upstream are pruned.
|
|
||||||
- **ETag / 304 conditional requests.** The releases-list `ETag` is stored per
|
|
||||||
remote and sent as `If-None-Match`; a `304 Not Modified` means nothing changed
|
|
||||||
and the syncer derives nothing. GitHub does not count `304` conditional
|
|
||||||
responses against the rate limit, so an unchanged repo is nearly free — this is
|
|
||||||
the main lever keeping GitHub traffic low.
|
|
||||||
- **Global rate limit.** Every GitHub call (releases list + each ranged asset
|
|
||||||
header GET) passes through a single token-bucket limiter **shared across all
|
|
||||||
remotes**, so GitHub is never hammered. Configure a token (`password`) on the
|
|
||||||
remote for the higher authenticated rate limit (~5000/hr vs ~60/hr
|
|
||||||
unauthenticated).
|
|
||||||
- **Multi-replica coordination.** State is shared through the database. Before a
|
|
||||||
periodic scan a replica must atomically claim a per-remote lease
|
|
||||||
(`github_rpm_sync_state`: `last_synced_at`, `etag`, `sync_lease_owner`,
|
|
||||||
`sync_lease_expires`); only the winner scans. This bounds total GitHub load to
|
|
||||||
~once per `mutable_ttl` regardless of replica count, and the shared `etag`
|
|
||||||
lets any replica issue the conditional request.
|
|
||||||
|
|
||||||
```hcl
|
|
||||||
# Backend that serves the actual .rpm bytes from github.com.
|
|
||||||
resource "artifactapi_remote_generic" "github" {
|
|
||||||
name = "github"
|
|
||||||
base_url = "https://github.com"
|
|
||||||
patterns = [
|
|
||||||
"acme/tools/releases/download/.*\\.rpm$", # allowlist the repo's release assets
|
|
||||||
]
|
|
||||||
}
|
|
||||||
|
|
||||||
resource "artifactapi_remote_github_rpm" "acme-tools" {
|
|
||||||
name = "acme-tools"
|
|
||||||
base_url = "https://api.github.com/repos/acme/tools" # the releases API root
|
|
||||||
releases_remote = "github" # backend for downloads
|
|
||||||
mutable_ttl = 3600 # release re-scan interval
|
|
||||||
|
|
||||||
# Optional: restrict which release assets become packages (regex on filename).
|
|
||||||
patterns = [".*\\.x86_64\\.rpm$", ".*\\.noarch\\.rpm$"]
|
|
||||||
|
|
||||||
# Optional: a token for private repos / higher API rate limits.
|
|
||||||
# password = "ghp_..."
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
`dnf` config: `baseurl=https://artifactapi.example/api/v1/remote/acme-tools`.
|
|
||||||
The repo is multi-arch (no `$basearch` needed) — `dnf` selects matching packages
|
|
||||||
from the synthesized metadata.
|
|
||||||
@@ -1,7 +0,0 @@
|
|||||||
# `rpm` remote
|
|
||||||
|
|
||||||
Shared classification, TTL and eviction rules: [caching](../common/caching.md).
|
|
||||||
|
|
||||||
| Type | Mutable (auto-detected) | Immutable (auto-detected) |
|
|
||||||
|---|---|---|
|
|
||||||
| `rpm` | `repomd.xml`, `repodata/*` | `.rpm` |
|
|
||||||
@@ -1,29 +0,0 @@
|
|||||||
# Serving providers as a registry
|
|
||||||
|
|
||||||
A local `terraform` repo is a real provider registry: upload
|
|
||||||
`terraform-provider-{type}_{version}_{os}_{arch}.zip` files under
|
|
||||||
`{namespace}/{type}/`, and Terraform installs them from a bare source address —
|
|
||||||
no `.terraformrc` mirror config:
|
|
||||||
|
|
||||||
```hcl
|
|
||||||
terraform {
|
|
||||||
required_providers {
|
|
||||||
artifactapi = {
|
|
||||||
source = "artifactapi.example.com/<repo>/<type>"
|
|
||||||
version = "0.1.2"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
The Terraform *namespace* segment is the artifactapi repo name; the provider is
|
|
||||||
matched by *type*. The registry serves service discovery
|
|
||||||
(`/.well-known/terraform.json`), the `providers.v1` version/download endpoints,
|
|
||||||
and a GPG-signed `SHA256SUMS` per the provider registry protocol.
|
|
||||||
|
|
||||||
Signing needs a GPG key. By default artifactapi generates one on first start and
|
|
||||||
stores it in the database (`signing_keys` table), so every replica shares it and
|
|
||||||
there's nothing to provision. To bring your own key instead, point
|
|
||||||
`TF_SIGNING_KEY_PATH` at an armored private key (optionally
|
|
||||||
`TF_SIGNING_KEY_PASSPHRASE`), which takes precedence over the generated one.
|
|
||||||
`TF_PROVIDER_PROTOCOLS` (default `5.0,6.0`) sets the advertised plugin protocols.
|
|
||||||
@@ -1,7 +0,0 @@
|
|||||||
# `terraform` remote
|
|
||||||
|
|
||||||
Shared classification, TTL and eviction rules: [caching](../common/caching.md).
|
|
||||||
|
|
||||||
| Type | Mutable (auto-detected) | Immutable (auto-detected) |
|
|
||||||
|---|---|---|
|
|
||||||
| `terraform` | `*/versions` | `*/download/*/*` |
|
|
||||||
@@ -1,51 +0,0 @@
|
|||||||
# Dockerised end-to-end suite
|
|
||||||
|
|
||||||
Black-box tests that run against a fully **containerised** artifactapi stack
|
|
||||||
(built image + Postgres + Redis + MinIO) plus a static mock upstream. Unlike the
|
|
||||||
in-process `e2e/` suite (testcontainers, server run in-process), these only speak
|
|
||||||
HTTP to the running product, so they exercise the shipped container image.
|
|
||||||
|
|
||||||
## Run
|
|
||||||
|
|
||||||
```bash
|
|
||||||
make docker-e2e # build image, compose up, run suite, compose down
|
|
||||||
```
|
|
||||||
|
|
||||||
`scripts/docker-e2e.sh` builds and starts `docker-compose.yml` +
|
|
||||||
`docker-compose.e2e.yml`, waits for `/health`, then runs
|
|
||||||
`go test -tags=dockere2e ./e2e-docker/...` and tears everything down.
|
|
||||||
|
|
||||||
The stack publishes artifactapi on host port **8001** (to avoid colliding with a
|
|
||||||
local instance on 8000). Override with `ARTIFACTAPI_URL` to point the tests at an
|
|
||||||
already-running stack.
|
|
||||||
|
|
||||||
## Coverage
|
|
||||||
|
|
||||||
- **Repository lifecycle** — add / change / delete for remote, local and virtual repos.
|
|
||||||
- **Caching** — one immutable artifact per remote package type (one
|
|
||||||
`caching_<type>_test.go` case each) proxied through the mock upstream: first fetch `X-Artifact-Source: remote`, second `cache`, bytes
|
|
||||||
verified against the origin fixture.
|
|
||||||
- **Local uploads** — puppet (Forge v3 API via real `r10k` and `puppet module install`),
|
|
||||||
generic (upload/download), pypi (wheel + generated `simple/`
|
|
||||||
index), rpm (real package + **automatic repodata** generation).
|
|
||||||
- **Virtual repositories** — pypi simple-index merge and helm `index.yaml` merge
|
|
||||||
across two members.
|
|
||||||
- **Mirrorlist** — an rpm remote with a `mirrorlist` of extra upstream mirrors
|
|
||||||
(pool = `base_url` + `mirrorlist`): round-robin distribution across both mirrors
|
|
||||||
(constant-body `mockupstreama` / `mockupstreamb`), failover past a dead primary,
|
|
||||||
no-mirrorlist regression, and a real `dnf` (stock `rockylinux:9` container)
|
|
||||||
`makecache` + `install` through a two-mirror rpm remote whose `base_url` is dead
|
|
||||||
— a dead mirror must not break the client.
|
|
||||||
- **Mirror strategy (`least_conn`)** — a `mirror_strategy: least_conn` rpm remote
|
|
||||||
over the two constant-body mirrors exercises the least-connections selection
|
|
||||||
path end-to-end (both mirrors serve, all requests succeed), plus a real `dnf`
|
|
||||||
install through a `least_conn` remote with a dead primary (failover unchanged).
|
|
||||||
The precise least-loaded pick is asserted deterministically in the proxy unit
|
|
||||||
test, since an in-flight-skew assertion over HTTP is timing-sensitive.
|
|
||||||
|
|
||||||
## Fixtures
|
|
||||||
|
|
||||||
`fixtures/` is served by the mock upstream at its web root. Paths mirror each
|
|
||||||
provider's upstream URL layout (e.g. `v2/...` for docker, `v1/providers/...` for
|
|
||||||
terraform). The RPM under `fixtures/rpmrepo/Packages/` is a real package so the
|
|
||||||
rpm provider can parse its metadata for repodata generation.
|
|
||||||
@@ -1,7 +0,0 @@
|
|||||||
//go:build dockere2e
|
|
||||||
|
|
||||||
package e2edocker
|
|
||||||
|
|
||||||
func init() {
|
|
||||||
cachingCases = append(cachingCases, cachingCase{"alpine", "alpine/x86_64/testpkg-1.0-r0.apk", "alpine/x86_64/testpkg-1.0-r0.apk"})
|
|
||||||
}
|
|
||||||
@@ -1,7 +0,0 @@
|
|||||||
//go:build dockere2e
|
|
||||||
|
|
||||||
package e2edocker
|
|
||||||
|
|
||||||
func init() {
|
|
||||||
cachingCases = append(cachingCases, cachingCase{"cargo", "crates/mycrate/mycrate-1.0.0.crate", "crates/mycrate/mycrate-1.0.0.crate"})
|
|
||||||
}
|
|
||||||
@@ -1,7 +0,0 @@
|
|||||||
//go:build dockere2e
|
|
||||||
|
|
||||||
package e2edocker
|
|
||||||
|
|
||||||
func init() {
|
|
||||||
cachingCases = append(cachingCases, cachingCase{"docker", "library/testimg/blobs/blobdata", "v2/library/testimg/blobs/blobdata"})
|
|
||||||
}
|
|
||||||
@@ -1,7 +0,0 @@
|
|||||||
//go:build dockere2e
|
|
||||||
|
|
||||||
package e2edocker
|
|
||||||
|
|
||||||
func init() {
|
|
||||||
cachingCases = append(cachingCases, cachingCase{"generic", "blobs/hello.bin", "blobs/hello.bin"})
|
|
||||||
}
|
|
||||||
@@ -1,7 +0,0 @@
|
|||||||
//go:build dockere2e
|
|
||||||
|
|
||||||
package e2edocker
|
|
||||||
|
|
||||||
func init() {
|
|
||||||
cachingCases = append(cachingCases, cachingCase{"goproxy", "goproxy/example.com/mod/@v/v1.0.0.zip", "goproxy/example.com/mod/@v/v1.0.0.zip"})
|
|
||||||
}
|
|
||||||
@@ -1,7 +0,0 @@
|
|||||||
//go:build dockere2e
|
|
||||||
|
|
||||||
package e2edocker
|
|
||||||
|
|
||||||
func init() {
|
|
||||||
cachingCases = append(cachingCases, cachingCase{"helm", "charts/mychart-1.0.0.tgz", "charts/mychart-1.0.0.tgz"})
|
|
||||||
}
|
|
||||||
@@ -1,7 +0,0 @@
|
|||||||
//go:build dockere2e
|
|
||||||
|
|
||||||
package e2edocker
|
|
||||||
|
|
||||||
func init() {
|
|
||||||
cachingCases = append(cachingCases, cachingCase{"npm", "mypkg/-/mypkg-1.0.0.tgz", "mypkg/-/mypkg-1.0.0.tgz"})
|
|
||||||
}
|
|
||||||
@@ -1,7 +0,0 @@
|
|||||||
//go:build dockere2e
|
|
||||||
|
|
||||||
package e2edocker
|
|
||||||
|
|
||||||
func init() {
|
|
||||||
cachingCases = append(cachingCases, cachingCase{"nuget", "nuget/e2epkg/1.0.0/e2epkg.1.0.0.nupkg", "nuget/e2epkg/1.0.0/e2epkg.1.0.0.nupkg"})
|
|
||||||
}
|
|
||||||
@@ -1,7 +0,0 @@
|
|||||||
//go:build dockere2e
|
|
||||||
|
|
||||||
package e2edocker
|
|
||||||
|
|
||||||
func init() {
|
|
||||||
cachingCases = append(cachingCases, cachingCase{"puppet", "puppet-releases/author-mod-1.0.0.tar.gz", "puppet-releases/author-mod-1.0.0.tar.gz"})
|
|
||||||
}
|
|
||||||
@@ -1,7 +0,0 @@
|
|||||||
//go:build dockere2e
|
|
||||||
|
|
||||||
package e2edocker
|
|
||||||
|
|
||||||
func init() {
|
|
||||||
cachingCases = append(cachingCases, cachingCase{"pypi", "packages/foo-1.0-py3-none-any.whl", "packages/foo-1.0-py3-none-any.whl"})
|
|
||||||
}
|
|
||||||
@@ -1,7 +0,0 @@
|
|||||||
//go:build dockere2e
|
|
||||||
|
|
||||||
package e2edocker
|
|
||||||
|
|
||||||
func init() {
|
|
||||||
cachingCases = append(cachingCases, cachingCase{"rpm", "rpmrepo/Packages/e2e-testpkg-1.0-1.noarch.rpm", "rpmrepo/Packages/e2e-testpkg-1.0-1.noarch.rpm"})
|
|
||||||
}
|
|
||||||
@@ -1,7 +0,0 @@
|
|||||||
//go:build dockere2e
|
|
||||||
|
|
||||||
package e2edocker
|
|
||||||
|
|
||||||
func init() {
|
|
||||||
cachingCases = append(cachingCases, cachingCase{"terraform", "hashicorp/aws/download/pkg.zip", "v1/providers/hashicorp/aws/download/pkg.zip"})
|
|
||||||
}
|
|
||||||
@@ -1,68 +0,0 @@
|
|||||||
//go:build dockere2e
|
|
||||||
|
|
||||||
package e2edocker
|
|
||||||
|
|
||||||
import (
|
|
||||||
"bytes"
|
|
||||||
"fmt"
|
|
||||||
"net/http"
|
|
||||||
"testing"
|
|
||||||
)
|
|
||||||
|
|
||||||
type cachingCase struct {
|
|
||||||
pkgType string
|
|
||||||
// path is the request path under /api/v1/remote/<name>/. The provider
|
|
||||||
// derives the upstream URL from it (docker prepends /v2/, terraform
|
|
||||||
// prepends /v1/providers/), and the fixture lives at that resolved path.
|
|
||||||
path string
|
|
||||||
fixture string
|
|
||||||
}
|
|
||||||
|
|
||||||
// cachingCases is filled by one caching_<type>_test.go file per package type.
|
|
||||||
var cachingCases []cachingCase
|
|
||||||
|
|
||||||
// TestCachingPerProvider proxies one immutable artifact for every remote
|
|
||||||
// package type through the mock upstream and asserts: first fetch is served
|
|
||||||
// from the remote, the second from cache, and the bytes match the origin.
|
|
||||||
func TestCachingPerProvider(t *testing.T) {
|
|
||||||
for _, tc := range cachingCases {
|
|
||||||
t.Run(tc.pkgType, func(t *testing.T) {
|
|
||||||
name := "cache-" + tc.pkgType
|
|
||||||
createRepo(t, fmt.Sprintf(`{
|
|
||||||
"name": %q,
|
|
||||||
"package_type": %q,
|
|
||||||
"repo_type": "remote",
|
|
||||||
"base_url": %q,
|
|
||||||
"stale_on_error": true
|
|
||||||
}`, name, tc.pkgType, mockUpstream()))
|
|
||||||
defer deleteRepo(t, name)
|
|
||||||
|
|
||||||
want := fixtureBytes(t, tc.fixture)
|
|
||||||
url := api("/api/v1/remote/" + name + "/" + tc.path)
|
|
||||||
|
|
||||||
// First fetch: from remote.
|
|
||||||
resp, body := doRequest(t, http.MethodGet, url, nil, "")
|
|
||||||
if resp.StatusCode != http.StatusOK {
|
|
||||||
t.Fatalf("first fetch: status %d: %s", resp.StatusCode, body)
|
|
||||||
}
|
|
||||||
if src := resp.Header.Get("X-Artifact-Source"); src != "remote" {
|
|
||||||
t.Fatalf("first fetch source = %q, want remote", src)
|
|
||||||
}
|
|
||||||
if !bytes.Equal(body, want) {
|
|
||||||
t.Fatalf("first fetch body mismatch: got %d bytes, want %d", len(body), len(want))
|
|
||||||
}
|
|
||||||
|
|
||||||
// Second fetch: from cache, identical bytes.
|
|
||||||
resp, body = doRequest(t, http.MethodGet, url, nil, "")
|
|
||||||
if resp.StatusCode != http.StatusOK {
|
|
||||||
t.Fatalf("second fetch: status %d: %s", resp.StatusCode, body)
|
|
||||||
}
|
|
||||||
if src := resp.Header.Get("X-Artifact-Source"); src != "cache" {
|
|
||||||
t.Fatalf("second fetch source = %q, want cache", src)
|
|
||||||
}
|
|
||||||
if !bytes.Equal(body, want) {
|
|
||||||
t.Fatalf("cached body mismatch: got %d bytes, want %d", len(body), len(want))
|
|
||||||
}
|
|
||||||
})
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,177 +0,0 @@
|
|||||||
//go:build dockere2e
|
|
||||||
|
|
||||||
package e2edocker
|
|
||||||
|
|
||||||
import (
|
|
||||||
"bytes"
|
|
||||||
"crypto/sha256"
|
|
||||||
"encoding/hex"
|
|
||||||
"fmt"
|
|
||||||
"net/http"
|
|
||||||
"strings"
|
|
||||||
"testing"
|
|
||||||
)
|
|
||||||
|
|
||||||
func digestOf(b []byte) string {
|
|
||||||
sum := sha256.Sum256(b)
|
|
||||||
return "sha256:" + hex.EncodeToString(sum[:])
|
|
||||||
}
|
|
||||||
|
|
||||||
// pushBlobMonolithic uploads a blob with POST (open session) then PUT?digest
|
|
||||||
// (whole body) — the monolithic-after-POST flow.
|
|
||||||
func pushBlobMonolithic(t *testing.T, repo, image string, blob []byte) {
|
|
||||||
t.Helper()
|
|
||||||
dgst := digestOf(blob)
|
|
||||||
|
|
||||||
resp, body := doRequest(t, http.MethodPost, api("/v2/"+repo+"/"+image+"/blobs/uploads/"), nil, "")
|
|
||||||
if resp.StatusCode != http.StatusAccepted {
|
|
||||||
t.Fatalf("start upload: status %d: %s", resp.StatusCode, body)
|
|
||||||
}
|
|
||||||
loc := resp.Header.Get("Location")
|
|
||||||
if loc == "" {
|
|
||||||
t.Fatalf("start upload: no Location header")
|
|
||||||
}
|
|
||||||
|
|
||||||
resp, body = doRequest(t, http.MethodPut, baseURL()+loc+"?digest="+dgst, blob, "application/octet-stream")
|
|
||||||
if resp.StatusCode != http.StatusCreated {
|
|
||||||
t.Fatalf("finish upload: status %d: %s", resp.StatusCode, body)
|
|
||||||
}
|
|
||||||
if got := resp.Header.Get("Docker-Content-Digest"); got != dgst {
|
|
||||||
t.Fatalf("finish upload: digest mismatch: got %q want %q", got, dgst)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// pushBlobChunked uploads a blob with POST then PATCH (body) then PUT?digest
|
|
||||||
// (empty) — the chunked flow a real docker daemon uses.
|
|
||||||
func pushBlobChunked(t *testing.T, repo, image string, blob []byte) {
|
|
||||||
t.Helper()
|
|
||||||
dgst := digestOf(blob)
|
|
||||||
|
|
||||||
resp, body := doRequest(t, http.MethodPost, api("/v2/"+repo+"/"+image+"/blobs/uploads/"), nil, "")
|
|
||||||
if resp.StatusCode != http.StatusAccepted {
|
|
||||||
t.Fatalf("start upload: status %d: %s", resp.StatusCode, body)
|
|
||||||
}
|
|
||||||
loc := resp.Header.Get("Location")
|
|
||||||
|
|
||||||
resp, body = doRequest(t, http.MethodPatch, baseURL()+loc, blob, "application/octet-stream")
|
|
||||||
if resp.StatusCode != http.StatusAccepted {
|
|
||||||
t.Fatalf("patch upload: status %d: %s", resp.StatusCode, body)
|
|
||||||
}
|
|
||||||
if got := resp.Header.Get("Range"); got != fmt.Sprintf("0-%d", len(blob)-1) {
|
|
||||||
t.Fatalf("patch upload: unexpected Range %q", got)
|
|
||||||
}
|
|
||||||
loc = resp.Header.Get("Location")
|
|
||||||
|
|
||||||
resp, body = doRequest(t, http.MethodPut, baseURL()+loc+"?digest="+dgst, nil, "")
|
|
||||||
if resp.StatusCode != http.StatusCreated {
|
|
||||||
t.Fatalf("finish upload: status %d: %s", resp.StatusCode, body)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// TestLocalDockerPushPull exercises a full container push and pull against a
|
|
||||||
// local docker repo using the Docker Registry HTTP API V2, the way a docker
|
|
||||||
// client would: upload the config and layer blobs, push the manifest under a
|
|
||||||
// tag, then pull the manifest and blobs back byte-identically.
|
|
||||||
func TestLocalDockerPushPull(t *testing.T) {
|
|
||||||
createRepo(t, `{"name":"docker-internal","package_type":"docker","repo_type":"local"}`)
|
|
||||||
defer deleteRepo(t, "docker-internal")
|
|
||||||
|
|
||||||
const image = "team/app"
|
|
||||||
const tag = "v1.0.0"
|
|
||||||
|
|
||||||
// /v2/ version check.
|
|
||||||
resp, _ := doRequest(t, http.MethodGet, api("/v2/"), nil, "")
|
|
||||||
if resp.StatusCode != http.StatusOK {
|
|
||||||
t.Fatalf("/v2/ ping: status %d", resp.StatusCode)
|
|
||||||
}
|
|
||||||
|
|
||||||
config := []byte(`{"architecture":"amd64","os":"linux","config":{},"rootfs":{"type":"layers","diff_ids":["sha256:0000000000000000000000000000000000000000000000000000000000000000"]}}`)
|
|
||||||
layer := bytes.Repeat([]byte("artifactapi-layer-data-"), 4096) // ~90 KB opaque layer
|
|
||||||
|
|
||||||
configDigest := digestOf(config)
|
|
||||||
layerDigest := digestOf(layer)
|
|
||||||
|
|
||||||
// A brand-new blob should be absent (this is the client's mount check).
|
|
||||||
resp, _ = doRequest(t, http.MethodHead, api("/v2/"+"docker-internal/"+image+"/blobs/"+configDigest), nil, "")
|
|
||||||
if resp.StatusCode != http.StatusNotFound {
|
|
||||||
t.Fatalf("pre-push blob HEAD: expected 404, got %d", resp.StatusCode)
|
|
||||||
}
|
|
||||||
|
|
||||||
pushBlobMonolithic(t, "docker-internal", image, config)
|
|
||||||
pushBlobChunked(t, "docker-internal", image, layer)
|
|
||||||
|
|
||||||
manifest := []byte(fmt.Sprintf(`{"schemaVersion":2,"mediaType":"application/vnd.docker.distribution.manifest.v2+json","config":{"mediaType":"application/vnd.docker.container.image.v1+json","size":%d,"digest":%q},"layers":[{"mediaType":"application/vnd.docker.image.rootfs.diff.tar.gzip","size":%d,"digest":%q}]}`,
|
|
||||||
len(config), configDigest, len(layer), layerDigest))
|
|
||||||
manifestDigest := digestOf(manifest)
|
|
||||||
manifestType := "application/vnd.docker.distribution.manifest.v2+json"
|
|
||||||
|
|
||||||
resp, body := doRequest(t, http.MethodPut, api("/v2/docker-internal/"+image+"/manifests/"+tag), manifest, manifestType)
|
|
||||||
if resp.StatusCode != http.StatusCreated {
|
|
||||||
t.Fatalf("push manifest: status %d: %s", resp.StatusCode, body)
|
|
||||||
}
|
|
||||||
if got := resp.Header.Get("Docker-Content-Digest"); got != manifestDigest {
|
|
||||||
t.Fatalf("push manifest: digest %q want %q", got, manifestDigest)
|
|
||||||
}
|
|
||||||
|
|
||||||
// --- pull back ---
|
|
||||||
|
|
||||||
// Manifest by tag.
|
|
||||||
resp, body = doRequest(t, http.MethodGet, api("/v2/docker-internal/"+image+"/manifests/"+tag), nil, "")
|
|
||||||
if resp.StatusCode != http.StatusOK {
|
|
||||||
t.Fatalf("pull manifest by tag: status %d: %s", resp.StatusCode, body)
|
|
||||||
}
|
|
||||||
if !bytes.Equal(body, manifest) {
|
|
||||||
t.Fatalf("pulled manifest bytes differ from pushed")
|
|
||||||
}
|
|
||||||
if ct := resp.Header.Get("Content-Type"); ct != manifestType {
|
|
||||||
t.Fatalf("pulled manifest content-type %q want %q", ct, manifestType)
|
|
||||||
}
|
|
||||||
if got := resp.Header.Get("Docker-Content-Digest"); got != manifestDigest {
|
|
||||||
t.Fatalf("pulled manifest digest %q want %q", got, manifestDigest)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Manifest by digest.
|
|
||||||
resp, body = doRequest(t, http.MethodGet, api("/v2/docker-internal/"+image+"/manifests/"+manifestDigest), nil, "")
|
|
||||||
if resp.StatusCode != http.StatusOK || !bytes.Equal(body, manifest) {
|
|
||||||
t.Fatalf("pull manifest by digest: status %d, equal=%v", resp.StatusCode, bytes.Equal(body, manifest))
|
|
||||||
}
|
|
||||||
|
|
||||||
// Blobs by digest.
|
|
||||||
for _, tc := range []struct {
|
|
||||||
name string
|
|
||||||
digest string
|
|
||||||
want []byte
|
|
||||||
}{
|
|
||||||
{"config", configDigest, config},
|
|
||||||
{"layer", layerDigest, layer},
|
|
||||||
} {
|
|
||||||
resp, body = doRequest(t, http.MethodGet, api("/v2/docker-internal/"+image+"/blobs/"+tc.digest), nil, "")
|
|
||||||
if resp.StatusCode != http.StatusOK {
|
|
||||||
t.Fatalf("pull %s blob: status %d", tc.name, resp.StatusCode)
|
|
||||||
}
|
|
||||||
if !bytes.Equal(body, tc.want) {
|
|
||||||
t.Fatalf("pulled %s blob bytes differ", tc.name)
|
|
||||||
}
|
|
||||||
if got := resp.Header.Get("Docker-Content-Digest"); got != tc.digest {
|
|
||||||
t.Fatalf("pulled %s blob digest %q want %q", tc.name, got, tc.digest)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// tags/list reflects the pushed tag.
|
|
||||||
resp, body = doRequest(t, http.MethodGet, api("/v2/docker-internal/"+image+"/tags/list"), nil, "")
|
|
||||||
if resp.StatusCode != http.StatusOK {
|
|
||||||
t.Fatalf("tags/list: status %d: %s", resp.StatusCode, body)
|
|
||||||
}
|
|
||||||
if !strings.Contains(string(body), `"`+tag+`"`) {
|
|
||||||
t.Fatalf("tags/list missing tag %q: %s", tag, body)
|
|
||||||
}
|
|
||||||
if !strings.Contains(string(body), `"docker-internal/`+image+`"`) {
|
|
||||||
t.Fatalf("tags/list wrong repository name: %s", body)
|
|
||||||
}
|
|
||||||
|
|
||||||
// A now-present blob HEAD should succeed (client would skip re-upload).
|
|
||||||
resp, _ = doRequest(t, http.MethodHead, api("/v2/docker-internal/"+image+"/blobs/"+layerDigest), nil, "")
|
|
||||||
if resp.StatusCode != http.StatusOK {
|
|
||||||
t.Fatalf("post-push blob HEAD: expected 200, got %d", resp.StatusCode)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
Binary file not shown.
@@ -1 +0,0 @@
|
|||||||
hello artifactapi generic blob
|
|
||||||
Binary file not shown.
Binary file not shown.
Binary file not shown.
@@ -1,8 +0,0 @@
|
|||||||
apiVersion: v1
|
|
||||||
entries:
|
|
||||||
alpha:
|
|
||||||
- name: alpha
|
|
||||||
version: 1.0.0
|
|
||||||
urls:
|
|
||||||
- charts/alpha-1.0.0.tgz
|
|
||||||
generated: "2026-01-01T00:00:00Z"
|
|
||||||
@@ -1,8 +0,0 @@
|
|||||||
apiVersion: v1
|
|
||||||
entries:
|
|
||||||
beta:
|
|
||||||
- name: beta
|
|
||||||
version: 2.0.0
|
|
||||||
urls:
|
|
||||||
- charts/beta-2.0.0.tgz
|
|
||||||
generated: "2026-01-01T00:00:00Z"
|
|
||||||
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
BIN
Binary file not shown.
BIN
Binary file not shown.
BIN
Binary file not shown.
BIN
Binary file not shown.
BIN
Binary file not shown.
BIN
Binary file not shown.
@@ -1,55 +0,0 @@
|
|||||||
<?xml version="1.0" encoding="UTF-8"?>
|
|
||||||
<repomd xmlns="http://linux.duke.edu/metadata/repo" xmlns:rpm="http://linux.duke.edu/metadata/rpm">
|
|
||||||
<revision>1786573032</revision>
|
|
||||||
<data type="primary">
|
|
||||||
<checksum type="sha256">d82f717e4da1afe96b8e7857de9e852f5785c0d75734e50d0f8afdcbc6261b08</checksum>
|
|
||||||
<open-checksum type="sha256">3345bb631380ae6c0620fe2a29cf7dff2ed4e28c5cb06c91e8a1628ba1979bcb</open-checksum>
|
|
||||||
<location href="repodata/d82f717e4da1afe96b8e7857de9e852f5785c0d75734e50d0f8afdcbc6261b08-primary.xml.gz"/>
|
|
||||||
<timestamp>1786573032</timestamp>
|
|
||||||
<size>631</size>
|
|
||||||
<open-size>1192</open-size>
|
|
||||||
</data>
|
|
||||||
<data type="filelists">
|
|
||||||
<checksum type="sha256">daa313cc5eeb7df556e1d4885d7701b10b9f012f436ef239fa46827f966222be</checksum>
|
|
||||||
<open-checksum type="sha256">648bd0ce00fda09abbc6e9c3ff3278518a76f258576ac24cd10c12e41e0e5bd7</open-checksum>
|
|
||||||
<location href="repodata/daa313cc5eeb7df556e1d4885d7701b10b9f012f436ef239fa46827f966222be-filelists.xml.gz"/>
|
|
||||||
<timestamp>1786573032</timestamp>
|
|
||||||
<size>256</size>
|
|
||||||
<open-size>338</open-size>
|
|
||||||
</data>
|
|
||||||
<data type="other">
|
|
||||||
<checksum type="sha256">8510c74a6f288828bbc92abee5d0d8ae9687d3c31a2579ea95e31a4c3a320d85</checksum>
|
|
||||||
<open-checksum type="sha256">c42cfd3843e9c53a60ad84bded44aa46c65faae7b3da99a099a9ca0b018872a9</open-checksum>
|
|
||||||
<location href="repodata/8510c74a6f288828bbc92abee5d0d8ae9687d3c31a2579ea95e31a4c3a320d85-other.xml.gz"/>
|
|
||||||
<timestamp>1786573032</timestamp>
|
|
||||||
<size>296</size>
|
|
||||||
<open-size>399</open-size>
|
|
||||||
</data>
|
|
||||||
<data type="primary_db">
|
|
||||||
<checksum type="sha256">f6bd7755da13d9726381048f467992869104a4c5521338ef740dc35eb85b9b71</checksum>
|
|
||||||
<open-checksum type="sha256">c45c85d12ccb0f8172b7bfae466362c08ac1867559574a9fb9cb2118c04daddb</open-checksum>
|
|
||||||
<location href="repodata/f6bd7755da13d9726381048f467992869104a4c5521338ef740dc35eb85b9b71-primary.sqlite.bz2"/>
|
|
||||||
<timestamp>1786573032</timestamp>
|
|
||||||
<size>1740</size>
|
|
||||||
<open-size>106496</open-size>
|
|
||||||
<database_version>10</database_version>
|
|
||||||
</data>
|
|
||||||
<data type="filelists_db">
|
|
||||||
<checksum type="sha256">be3c6e4c7a13ece48bd5d6a4d6d5e6a2395fe006ef9c5f217f5b87144f465e57</checksum>
|
|
||||||
<open-checksum type="sha256">1ccfa3dff532d782ce3225aae807506a4ce4534291386f1c47455dcc6b70cfd6</open-checksum>
|
|
||||||
<location href="repodata/be3c6e4c7a13ece48bd5d6a4d6d5e6a2395fe006ef9c5f217f5b87144f465e57-filelists.sqlite.bz2"/>
|
|
||||||
<timestamp>1786573032</timestamp>
|
|
||||||
<size>764</size>
|
|
||||||
<open-size>28672</open-size>
|
|
||||||
<database_version>10</database_version>
|
|
||||||
</data>
|
|
||||||
<data type="other_db">
|
|
||||||
<checksum type="sha256">ba593cd8ab5ec1e127888707c1fd882920996f1ce173fd7a589d647918fd7da4</checksum>
|
|
||||||
<open-checksum type="sha256">5d4d38380f0e359bfc0a50033d4faa84c75c5ae8fe2ef11c1c82d64748e9b8e2</open-checksum>
|
|
||||||
<location href="repodata/ba593cd8ab5ec1e127888707c1fd882920996f1ce173fd7a589d647918fd7da4-other.sqlite.bz2"/>
|
|
||||||
<timestamp>1786573032</timestamp>
|
|
||||||
<size>738</size>
|
|
||||||
<open-size>24576</open-size>
|
|
||||||
<database_version>10</database_version>
|
|
||||||
</data>
|
|
||||||
</repomd>
|
|
||||||
Binary file not shown.
Binary file not shown.
Binary file not shown.
@@ -1,71 +0,0 @@
|
|||||||
//go:build dockere2e
|
|
||||||
|
|
||||||
package e2edocker
|
|
||||||
|
|
||||||
import (
|
|
||||||
"net/http"
|
|
||||||
"os"
|
|
||||||
"os/exec"
|
|
||||||
"strings"
|
|
||||||
"testing"
|
|
||||||
"time"
|
|
||||||
)
|
|
||||||
|
|
||||||
// TestLocalHelmRealClient packages a chart with the real helm CLI, publishes it
|
|
||||||
// to a helm local, then drives helm repo add/search/pull/template against the
|
|
||||||
// local and against a helm virtual that has the local as a member.
|
|
||||||
func TestLocalHelmRealClient(t *testing.T) {
|
|
||||||
network := os.Getenv("COMPOSE_NETWORK")
|
|
||||||
internal := strings.TrimRight(os.Getenv("ARTIFACTAPI_INTERNAL"), "/")
|
|
||||||
if network == "" || internal == "" {
|
|
||||||
t.Skip("COMPOSE_NETWORK/ARTIFACTAPI_INTERNAL not set; run via scripts/docker-e2e.sh")
|
|
||||||
}
|
|
||||||
if _, err := exec.LookPath("docker"); err != nil {
|
|
||||||
t.Skip("docker not available on the test host")
|
|
||||||
}
|
|
||||||
|
|
||||||
createRepo(t, `{"name":"local-helm","package_type":"helm","repo_type":"local"}`)
|
|
||||||
defer deleteRepo(t, "local-helm")
|
|
||||||
createVirtual(t, `{"name":"vhelm","package_type":"helm","members":["local-helm"]}`)
|
|
||||||
defer deleteVirtual(t, "vhelm")
|
|
||||||
|
|
||||||
helm := func(script string) string {
|
|
||||||
t.Helper()
|
|
||||||
out, err := exec.Command("docker", "run", "--rm", "--network", network, "--entrypoint", "sh",
|
|
||||||
"alpine/helm:3.16.4", "-c", "set -eu; "+script).Output()
|
|
||||||
if err != nil {
|
|
||||||
stderr := ""
|
|
||||||
if ee, ok := err.(*exec.ExitError); ok {
|
|
||||||
stderr = string(ee.Stderr)
|
|
||||||
}
|
|
||||||
t.Fatalf("helm script failed: %v\n%s%s", err, out, stderr)
|
|
||||||
}
|
|
||||||
return string(out)
|
|
||||||
}
|
|
||||||
|
|
||||||
chart := helm("cd /tmp && helm create e2echart >/dev/null && helm package e2echart >/dev/null && cat e2echart-0.1.0.tgz")
|
|
||||||
uploadFile(t, "local-helm", "e2echart-0.1.0.tgz", []byte(chart), "application/gzip")
|
|
||||||
|
|
||||||
// Chart metadata is recorded asynchronously after upload; poll the index.
|
|
||||||
var body []byte
|
|
||||||
for deadline := time.Now().Add(15 * time.Second); time.Now().Before(deadline); time.Sleep(500 * time.Millisecond) {
|
|
||||||
var resp *http.Response
|
|
||||||
resp, body = doRequest(t, http.MethodGet, api("/api/v1/local/local-helm/index.yaml"), nil, "")
|
|
||||||
if resp.StatusCode == http.StatusOK && strings.Contains(string(body), "e2echart-0.1.0.tgz") {
|
|
||||||
break
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if !strings.Contains(string(body), "e2echart-0.1.0.tgz") || !strings.Contains(string(body), "digest: ") {
|
|
||||||
t.Fatalf("index.yaml never listed the chart:\n%s", body)
|
|
||||||
}
|
|
||||||
|
|
||||||
for _, repoURL := range []string{internal + "/api/v1/local/local-helm", internal + "/api/v1/virtual/vhelm"} {
|
|
||||||
out := helm("helm repo add e2e " + repoURL + " >/dev/null && " +
|
|
||||||
"helm search repo e2e/e2echart && " +
|
|
||||||
"cd /tmp && helm pull e2e/e2echart --version 0.1.0 && " +
|
|
||||||
"helm template rel e2echart-0.1.0.tgz | grep -c 'kind: Deployment'")
|
|
||||||
if !strings.Contains(out, "e2e/e2echart") || !strings.Contains(out, "0.1.0") || !strings.HasSuffix(strings.TrimSpace(out), "1") {
|
|
||||||
t.Fatalf("helm via %s:\n%s", repoURL, out)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,108 +0,0 @@
|
|||||||
//go:build dockere2e
|
|
||||||
|
|
||||||
// Package e2edocker holds the black-box end-to-end suite that runs against a
|
|
||||||
// fully dockerised artifactapi stack (see scripts/docker-e2e.sh). Unlike the
|
|
||||||
// in-process e2e suite, these tests only speak HTTP to the running container.
|
|
||||||
package e2edocker
|
|
||||||
|
|
||||||
import (
|
|
||||||
"bytes"
|
|
||||||
"io"
|
|
||||||
"net/http"
|
|
||||||
"os"
|
|
||||||
"path/filepath"
|
|
||||||
"strings"
|
|
||||||
"testing"
|
|
||||||
"time"
|
|
||||||
)
|
|
||||||
|
|
||||||
func baseURL() string {
|
|
||||||
if v := os.Getenv("ARTIFACTAPI_URL"); v != "" {
|
|
||||||
return strings.TrimRight(v, "/")
|
|
||||||
}
|
|
||||||
return "http://localhost:8000"
|
|
||||||
}
|
|
||||||
|
|
||||||
// mockUpstream is the base URL the artifactapi *container* uses to reach the
|
|
||||||
// static mock upstream. It is resolved on the compose network, not the host.
|
|
||||||
func mockUpstream() string {
|
|
||||||
if v := os.Getenv("MOCK_UPSTREAM_INTERNAL"); v != "" {
|
|
||||||
return strings.TrimRight(v, "/")
|
|
||||||
}
|
|
||||||
return "http://mockupstream"
|
|
||||||
}
|
|
||||||
|
|
||||||
func api(path string) string { return baseURL() + path }
|
|
||||||
|
|
||||||
func fixtureBytes(t *testing.T, rel string) []byte {
|
|
||||||
t.Helper()
|
|
||||||
b, err := os.ReadFile(filepath.Join("fixtures", rel))
|
|
||||||
if err != nil {
|
|
||||||
t.Fatalf("read fixture %s: %v", rel, err)
|
|
||||||
}
|
|
||||||
return b
|
|
||||||
}
|
|
||||||
|
|
||||||
func doRequest(t *testing.T, method, url string, body []byte, contentType string) (*http.Response, []byte) {
|
|
||||||
t.Helper()
|
|
||||||
var r io.Reader
|
|
||||||
if body != nil {
|
|
||||||
r = bytes.NewReader(body)
|
|
||||||
}
|
|
||||||
req, err := http.NewRequest(method, url, r)
|
|
||||||
if err != nil {
|
|
||||||
t.Fatalf("%s %s: %v", method, url, err)
|
|
||||||
}
|
|
||||||
if contentType != "" {
|
|
||||||
req.Header.Set("Content-Type", contentType)
|
|
||||||
}
|
|
||||||
resp, err := http.DefaultClient.Do(req)
|
|
||||||
if err != nil {
|
|
||||||
t.Fatalf("%s %s: %v", method, url, err)
|
|
||||||
}
|
|
||||||
defer resp.Body.Close()
|
|
||||||
respBody, _ := io.ReadAll(resp.Body)
|
|
||||||
return resp, respBody
|
|
||||||
}
|
|
||||||
|
|
||||||
func createRepo(t *testing.T, jsonBody string) {
|
|
||||||
t.Helper()
|
|
||||||
resp, body := doRequest(t, http.MethodPost, api("/api/v2/remotes"), []byte(jsonBody), "application/json")
|
|
||||||
if resp.StatusCode != http.StatusCreated {
|
|
||||||
t.Fatalf("create repo: status %d: %s", resp.StatusCode, body)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func deleteRepo(t *testing.T, name string) {
|
|
||||||
t.Helper()
|
|
||||||
doRequest(t, http.MethodDelete, api("/api/v2/remotes/"+name), nil, "")
|
|
||||||
}
|
|
||||||
|
|
||||||
func createVirtual(t *testing.T, jsonBody string) {
|
|
||||||
t.Helper()
|
|
||||||
resp, body := doRequest(t, http.MethodPost, api("/api/v2/virtuals"), []byte(jsonBody), "application/json")
|
|
||||||
if resp.StatusCode != http.StatusCreated {
|
|
||||||
t.Fatalf("create virtual: status %d: %s", resp.StatusCode, body)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func deleteVirtual(t *testing.T, name string) {
|
|
||||||
t.Helper()
|
|
||||||
doRequest(t, http.MethodDelete, api("/api/v2/virtuals/"+name), nil, "")
|
|
||||||
}
|
|
||||||
|
|
||||||
// getEventually retries a GET until it returns 200 or the deadline passes. Used
|
|
||||||
// for asynchronously-generated artifacts (e.g. rpm repodata after upload).
|
|
||||||
func getEventually(t *testing.T, url string, timeout time.Duration) (*http.Response, []byte) {
|
|
||||||
t.Helper()
|
|
||||||
deadline := time.Now().Add(timeout)
|
|
||||||
var resp *http.Response
|
|
||||||
var body []byte
|
|
||||||
for {
|
|
||||||
resp, body = doRequest(t, http.MethodGet, url, nil, "")
|
|
||||||
if resp.StatusCode == http.StatusOK || time.Now().After(deadline) {
|
|
||||||
return resp, body
|
|
||||||
}
|
|
||||||
time.Sleep(250 * time.Millisecond)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,105 +0,0 @@
|
|||||||
//go:build dockere2e
|
|
||||||
|
|
||||||
package e2edocker
|
|
||||||
|
|
||||||
import (
|
|
||||||
"fmt"
|
|
||||||
"net/http"
|
|
||||||
"os"
|
|
||||||
"os/exec"
|
|
||||||
"strings"
|
|
||||||
"testing"
|
|
||||||
)
|
|
||||||
|
|
||||||
// TestLeastConnMultiBaseURL configures an rpm remote with mirror_strategy =
|
|
||||||
// least_conn over a two-mirror pool and drives distinct cache-miss paths through
|
|
||||||
// it, asserting every request succeeds and both mirrors serve traffic. This
|
|
||||||
// exercises the least-connections selection path (leastConnOrder + the in-flight
|
|
||||||
// gauge inc/dec around each upstream call) end-to-end through a real HTTP client.
|
|
||||||
// A precise least-loaded assertion is timing-sensitive over HTTP and is covered
|
|
||||||
// deterministically by the proxy unit test (TestLeastConnPicksLeastLoaded);
|
|
||||||
// here, with requests issued serially, in-flight counts return to zero between
|
|
||||||
// them so equal-load mirrors are spread by the round-robin tie-break.
|
|
||||||
func TestLeastConnMultiBaseURL(t *testing.T) {
|
|
||||||
name := "e2e-leastconn"
|
|
||||||
createRepo(t, fmt.Sprintf(`{
|
|
||||||
"name": %q,
|
|
||||||
"package_type": "rpm",
|
|
||||||
"repo_type": "remote",
|
|
||||||
"base_url": %q,
|
|
||||||
"mirrorlist": [%q],
|
|
||||||
"mirror_strategy": "least_conn",
|
|
||||||
"stale_on_error": false
|
|
||||||
}`, name, mockUpstreamA(), mockUpstreamB()))
|
|
||||||
defer deleteRepo(t, name)
|
|
||||||
|
|
||||||
seenA, seenB := false, false
|
|
||||||
const n = 12
|
|
||||||
for i := 0; i < n; i++ {
|
|
||||||
url := api(fmt.Sprintf("/api/v1/remote/%s/lc/%d", name, i))
|
|
||||||
resp, body := doRequest(t, http.MethodGet, url, nil, "")
|
|
||||||
if resp.StatusCode != http.StatusOK {
|
|
||||||
t.Fatalf("request %d: status %d: %s", i, resp.StatusCode, body)
|
|
||||||
}
|
|
||||||
switch strings.TrimSpace(string(body)) {
|
|
||||||
case "UPSTREAM-A":
|
|
||||||
seenA = true
|
|
||||||
case "UPSTREAM-B":
|
|
||||||
seenB = true
|
|
||||||
default:
|
|
||||||
t.Fatalf("request %d: unexpected body %q", i, body)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if !seenA || !seenB {
|
|
||||||
t.Fatalf("least_conn remote did not reach both upstreams: A=%v B=%v", seenA, seenB)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// TestLeastConnDnfInstall drives a real dnf (stock rockylinux container) at a
|
|
||||||
// two-mirror rpm remote configured with mirror_strategy = least_conn whose
|
|
||||||
// primary base_url is dead: makecache + install must succeed via the live mirror.
|
|
||||||
// This proves a real package-manager client installs correctly through a
|
|
||||||
// least_conn remote and that failover semantics are unchanged under the new
|
|
||||||
// strategy. Requires the compose network exported by scripts/docker-e2e.sh.
|
|
||||||
func TestLeastConnDnfInstall(t *testing.T) {
|
|
||||||
network := os.Getenv("COMPOSE_NETWORK")
|
|
||||||
internal := os.Getenv("ARTIFACTAPI_INTERNAL")
|
|
||||||
if network == "" || internal == "" {
|
|
||||||
t.Skip("COMPOSE_NETWORK/ARTIFACTAPI_INTERNAL not set; run via scripts/docker-e2e.sh")
|
|
||||||
}
|
|
||||||
if _, err := exec.LookPath("docker"); err != nil {
|
|
||||||
t.Skip("docker not available on the test host")
|
|
||||||
}
|
|
||||||
|
|
||||||
name := "e2e-leastconn-dnf"
|
|
||||||
createRepo(t, fmt.Sprintf(`{
|
|
||||||
"name": %q,
|
|
||||||
"package_type": "rpm",
|
|
||||||
"repo_type": "remote",
|
|
||||||
"base_url": "http://mockupstream-dead:80",
|
|
||||||
"mirrorlist": [%q],
|
|
||||||
"mirror_strategy": "least_conn",
|
|
||||||
"stale_on_error": false
|
|
||||||
}`, name, mockUpstream()))
|
|
||||||
defer deleteRepo(t, name)
|
|
||||||
|
|
||||||
repoURL := strings.TrimRight(internal, "/") + "/api/v1/remote/" + name + "/rpm-mirror"
|
|
||||||
repoConf := fmt.Sprintf("[dnflc]\nname=dnflc\nbaseurl=%s\nenabled=1\ngpgcheck=0\nsslverify=0\nmetadata_expire=0\n", repoURL)
|
|
||||||
script := "set -euo pipefail; " +
|
|
||||||
"printf '%s' \"$REPO\" > /etc/yum.repos.d/dnflc.repo; " +
|
|
||||||
"dnf -y --disablerepo='*' --enablerepo=dnflc makecache; " +
|
|
||||||
"dnf -y --disablerepo='*' --enablerepo=dnflc install e2e-testpkg; " +
|
|
||||||
"rpm -q e2e-testpkg"
|
|
||||||
|
|
||||||
cmd := exec.Command("docker", "run", "--rm",
|
|
||||||
"--network", network,
|
|
||||||
"-e", "REPO="+repoConf,
|
|
||||||
"rockylinux:9", "bash", "-c", script)
|
|
||||||
out, err := cmd.CombinedOutput()
|
|
||||||
if err != nil {
|
|
||||||
t.Fatalf("real dnf install through a least_conn remote failed: %v\n%s", err, out)
|
|
||||||
}
|
|
||||||
if !strings.Contains(string(out), "e2e-testpkg-1.0-1") {
|
|
||||||
t.Fatalf("dnf did not install the expected package via least_conn remote; output:\n%s", out)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,193 +0,0 @@
|
|||||||
//go:build dockere2e
|
|
||||||
|
|
||||||
package e2edocker
|
|
||||||
|
|
||||||
import (
|
|
||||||
"archive/tar"
|
|
||||||
"bytes"
|
|
||||||
"compress/gzip"
|
|
||||||
"io"
|
|
||||||
"net/http"
|
|
||||||
"strings"
|
|
||||||
"testing"
|
|
||||||
"time"
|
|
||||||
|
|
||||||
"git.unkin.net/unkin/artifactapi/internal/testsupport"
|
|
||||||
)
|
|
||||||
|
|
||||||
func uploadFile(t *testing.T, repo, filePath string, body []byte, contentType string) {
|
|
||||||
t.Helper()
|
|
||||||
url := api("/api/v2/remotes/" + repo + "/files/" + filePath)
|
|
||||||
resp, respBody := doRequest(t, http.MethodPut, url, body, contentType)
|
|
||||||
if resp.StatusCode != http.StatusCreated {
|
|
||||||
t.Fatalf("upload %s: status %d: %s", filePath, resp.StatusCode, respBody)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// TestLocalGenericUpload uploads a generic file and downloads it back.
|
|
||||||
func TestLocalGenericUpload(t *testing.T) {
|
|
||||||
createRepo(t, `{"name":"local-generic","package_type":"generic","repo_type":"local"}`)
|
|
||||||
defer deleteRepo(t, "local-generic")
|
|
||||||
|
|
||||||
content := []byte("artifactapi local generic upload payload")
|
|
||||||
uploadFile(t, "local-generic", "data/hello.bin", content, "application/octet-stream")
|
|
||||||
|
|
||||||
resp, body := doRequest(t, http.MethodGet, api("/api/v1/local/local-generic/data/hello.bin"), nil, "")
|
|
||||||
if resp.StatusCode != http.StatusOK {
|
|
||||||
t.Fatalf("download: status %d: %s", resp.StatusCode, body)
|
|
||||||
}
|
|
||||||
if !bytes.Equal(body, content) {
|
|
||||||
t.Fatalf("downloaded content mismatch")
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// TestLocalPyPIUpload uploads a wheel and validates the generated simple index.
|
|
||||||
func TestLocalPyPIUpload(t *testing.T) {
|
|
||||||
createRepo(t, `{"name":"local-pypi","package_type":"pypi","repo_type":"local"}`)
|
|
||||||
defer deleteRepo(t, "local-pypi")
|
|
||||||
|
|
||||||
wheel := fixtureBytes(t, "packages/foo-1.0-py3-none-any.whl")
|
|
||||||
uploadFile(t, "local-pypi", "foo-1.0-py3-none-any.whl", wheel, "application/zip")
|
|
||||||
|
|
||||||
// Root index lists the package.
|
|
||||||
resp, body := doRequest(t, http.MethodGet, api("/api/v1/local/local-pypi/simple/"), nil, "")
|
|
||||||
if resp.StatusCode != http.StatusOK {
|
|
||||||
t.Fatalf("simple index: status %d: %s", resp.StatusCode, body)
|
|
||||||
}
|
|
||||||
if !strings.Contains(string(body), "foo") {
|
|
||||||
t.Fatalf("simple index missing package 'foo': %s", body)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Per-package index lists the wheel file.
|
|
||||||
resp, body = doRequest(t, http.MethodGet, api("/api/v1/local/local-pypi/simple/foo/"), nil, "")
|
|
||||||
if resp.StatusCode != http.StatusOK {
|
|
||||||
t.Fatalf("package index: status %d: %s", resp.StatusCode, body)
|
|
||||||
}
|
|
||||||
if !strings.Contains(string(body), "foo-1.0-py3-none-any.whl") {
|
|
||||||
t.Fatalf("package index missing wheel: %s", body)
|
|
||||||
}
|
|
||||||
|
|
||||||
// The wheel downloads back byte-identical.
|
|
||||||
resp, body = doRequest(t, http.MethodGet, api("/api/v1/local/local-pypi/foo/foo-1.0-py3-none-any.whl"), nil, "")
|
|
||||||
if resp.StatusCode != http.StatusOK {
|
|
||||||
t.Fatalf("download wheel: status %d: %s", resp.StatusCode, body)
|
|
||||||
}
|
|
||||||
if !bytes.Equal(body, wheel) {
|
|
||||||
t.Fatalf("wheel content mismatch")
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// TestLocalRPMRepodata uploads a real RPM and validates that repodata is
|
|
||||||
// generated automatically (the special rpm-local feature).
|
|
||||||
func TestLocalRPMRepodata(t *testing.T) {
|
|
||||||
createRepo(t, `{"name":"local-rpm","package_type":"rpm","repo_type":"local"}`)
|
|
||||||
defer deleteRepo(t, "local-rpm")
|
|
||||||
|
|
||||||
rpm := fixtureBytes(t, "rpmrepo/Packages/e2e-testpkg-1.0-1.noarch.rpm")
|
|
||||||
uploadFile(t, "local-rpm", "e2e-testpkg-1.0-1.noarch.rpm", rpm, "application/x-rpm")
|
|
||||||
|
|
||||||
// repodata is generated asynchronously after upload; poll for it.
|
|
||||||
resp, body := getEventually(t, api("/api/v1/local/local-rpm/repodata/repomd.xml"), 15*time.Second)
|
|
||||||
if resp.StatusCode != http.StatusOK {
|
|
||||||
t.Fatalf("repomd.xml: status %d: %s", resp.StatusCode, body)
|
|
||||||
}
|
|
||||||
s := string(body)
|
|
||||||
if !strings.Contains(s, "<repomd") || !strings.Contains(s, "primary") {
|
|
||||||
t.Fatalf("repomd.xml not a valid repodata document: %s", s)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// TestLocalDebRepo uploads a .deb and validates that the flat apt index
|
|
||||||
// (Packages / Release) is generated automatically from the parsed control
|
|
||||||
// stanza (the deb-local analog of rpm repodata generation).
|
|
||||||
func TestLocalDebRepo(t *testing.T) {
|
|
||||||
createRepo(t, `{"name":"local-deb","package_type":"deb","repo_type":"local"}`)
|
|
||||||
defer deleteRepo(t, "local-deb")
|
|
||||||
|
|
||||||
deb := testsupport.MinimalDeb("e2e-testpkg", "1.0.0", "amd64")
|
|
||||||
uploadFile(t, "local-deb", "e2e-testpkg_1.0.0_amd64.deb", deb, "application/vnd.debian.binary-package")
|
|
||||||
|
|
||||||
// The index is generated asynchronously after upload; poll for it.
|
|
||||||
resp, body := getEventually(t, api("/api/v1/local/local-deb/Packages"), 15*time.Second)
|
|
||||||
if resp.StatusCode != http.StatusOK {
|
|
||||||
t.Fatalf("Packages: status %d: %s", resp.StatusCode, body)
|
|
||||||
}
|
|
||||||
pkgs := string(body)
|
|
||||||
for _, want := range []string{"Package: e2e-testpkg", "Version: 1.0.0", "Architecture: amd64", "Filename: pool/e2e-testpkg_1.0.0_amd64.deb", "SHA256:"} {
|
|
||||||
if !strings.Contains(pkgs, want) {
|
|
||||||
t.Fatalf("Packages missing %q:\n%s", want, pkgs)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
resp, body = doRequest(t, http.MethodGet, api("/api/v1/local/local-deb/Release"), nil, "")
|
|
||||||
if resp.StatusCode != http.StatusOK {
|
|
||||||
t.Fatalf("Release: status %d: %s", resp.StatusCode, body)
|
|
||||||
}
|
|
||||||
rel := string(body)
|
|
||||||
for _, want := range []string{"Architectures: amd64", "SHA256:", "Packages"} {
|
|
||||||
if !strings.Contains(rel, want) {
|
|
||||||
t.Fatalf("Release missing %q:\n%s", want, rel)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// The .deb downloads back byte-identical from its pool path.
|
|
||||||
resp, body = doRequest(t, http.MethodGet, api("/api/v1/local/local-deb/pool/e2e-testpkg_1.0.0_amd64.deb"), nil, "")
|
|
||||||
if resp.StatusCode != http.StatusOK {
|
|
||||||
t.Fatalf("download deb: status %d: %s", resp.StatusCode, body)
|
|
||||||
}
|
|
||||||
if !bytes.Equal(body, deb) {
|
|
||||||
t.Fatalf("deb content mismatch")
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// TestLocalAlpineIndex uploads an .apk to an alpine local repo and validates
|
|
||||||
// that a per-arch APKINDEX.tar.gz is generated automatically from the parsed
|
|
||||||
// .PKGINFO (the apk-local analog of rpm repodata / deb Packages generation).
|
|
||||||
func TestLocalAlpineIndex(t *testing.T) {
|
|
||||||
createRepo(t, `{"name":"local-alpine","package_type":"alpine","repo_type":"local"}`)
|
|
||||||
defer deleteRepo(t, "local-alpine")
|
|
||||||
|
|
||||||
apk := testsupport.MinimalApk("e2e-testpkg", "1.0-r0", "x86_64")
|
|
||||||
uploadFile(t, "local-alpine", "x86_64/e2e-testpkg-1.0-r0.apk", apk, "application/vnd.android.package-archive")
|
|
||||||
|
|
||||||
// The index is generated asynchronously after upload; poll for it.
|
|
||||||
resp, body := getEventually(t, api("/api/v1/local/local-alpine/x86_64/APKINDEX.tar.gz"), 15*time.Second)
|
|
||||||
if resp.StatusCode != http.StatusOK {
|
|
||||||
t.Fatalf("APKINDEX: status %d: %s", resp.StatusCode, body)
|
|
||||||
}
|
|
||||||
|
|
||||||
zr, err := gzip.NewReader(bytes.NewReader(body))
|
|
||||||
if err != nil {
|
|
||||||
t.Fatalf("APKINDEX not gzip: %v", err)
|
|
||||||
}
|
|
||||||
tarBytes, _ := io.ReadAll(zr)
|
|
||||||
tr := tar.NewReader(bytes.NewReader(tarBytes))
|
|
||||||
var index string
|
|
||||||
for {
|
|
||||||
hdr, err := tr.Next()
|
|
||||||
if err == io.EOF {
|
|
||||||
break
|
|
||||||
}
|
|
||||||
if err != nil {
|
|
||||||
t.Fatalf("APKINDEX not tar: %v", err)
|
|
||||||
}
|
|
||||||
if hdr.Name == "APKINDEX" {
|
|
||||||
b, _ := io.ReadAll(tr)
|
|
||||||
index = string(b)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
for _, want := range []string{"P:e2e-testpkg", "V:1.0-r0", "A:x86_64", "C:Q1", "S:", "I:"} {
|
|
||||||
if !strings.Contains(index, want) {
|
|
||||||
t.Fatalf("APKINDEX missing %q:\n%s", want, index)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// The .apk downloads back byte-identical from its arch path.
|
|
||||||
resp, body = doRequest(t, http.MethodGet, api("/api/v1/local/local-alpine/x86_64/e2e-testpkg-1.0-r0.apk"), nil, "")
|
|
||||||
if resp.StatusCode != http.StatusOK {
|
|
||||||
t.Fatalf("download apk: status %d: %s", resp.StatusCode, body)
|
|
||||||
}
|
|
||||||
if !bytes.Equal(body, apk) {
|
|
||||||
t.Fatalf("apk content mismatch")
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,9 +0,0 @@
|
|||||||
# Mock upstream A for the multi-base_url e2e: any path returns a constant,
|
|
||||||
# upstream-identifying body so round-robin distribution is observable.
|
|
||||||
server {
|
|
||||||
listen 80;
|
|
||||||
location / {
|
|
||||||
default_type text/plain;
|
|
||||||
return 200 "UPSTREAM-A";
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,8 +0,0 @@
|
|||||||
# Mock upstream B for the multi-base_url e2e (see a.conf).
|
|
||||||
server {
|
|
||||||
listen 80;
|
|
||||||
location / {
|
|
||||||
default_type text/plain;
|
|
||||||
return 200 "UPSTREAM-B";
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,163 +0,0 @@
|
|||||||
//go:build dockere2e
|
|
||||||
|
|
||||||
package e2edocker
|
|
||||||
|
|
||||||
import (
|
|
||||||
"fmt"
|
|
||||||
"net/http"
|
|
||||||
"os"
|
|
||||||
"os/exec"
|
|
||||||
"strings"
|
|
||||||
"testing"
|
|
||||||
)
|
|
||||||
|
|
||||||
// mockUpstreamA/B are the constant-body upstreams (see docker-compose.e2e.yml)
|
|
||||||
// that let the round-robin test observe which mirror served each request.
|
|
||||||
func mockUpstreamA() string {
|
|
||||||
if v := os.Getenv("MOCK_UPSTREAM_A_INTERNAL"); v != "" {
|
|
||||||
return strings.TrimRight(v, "/")
|
|
||||||
}
|
|
||||||
return "http://mockupstreama"
|
|
||||||
}
|
|
||||||
|
|
||||||
func mockUpstreamB() string {
|
|
||||||
if v := os.Getenv("MOCK_UPSTREAM_B_INTERNAL"); v != "" {
|
|
||||||
return strings.TrimRight(v, "/")
|
|
||||||
}
|
|
||||||
return "http://mockupstreamb"
|
|
||||||
}
|
|
||||||
|
|
||||||
// TestMultiBaseURLRoundRobin configures an rpm remote with base_url = mirror A
|
|
||||||
// and mirrorlist = [mirror B] and drives distinct paths through it, asserting
|
|
||||||
// both mirrors serve traffic. Each path is a cache miss, so every request reaches
|
|
||||||
// upstream and the round-robin cursor alternates mirrors.
|
|
||||||
func TestMultiBaseURLRoundRobin(t *testing.T) {
|
|
||||||
name := "e2e-rr"
|
|
||||||
createRepo(t, fmt.Sprintf(`{
|
|
||||||
"name": %q,
|
|
||||||
"package_type": "rpm",
|
|
||||||
"repo_type": "remote",
|
|
||||||
"base_url": %q,
|
|
||||||
"mirrorlist": [%q],
|
|
||||||
"stale_on_error": false
|
|
||||||
}`, name, mockUpstreamA(), mockUpstreamB()))
|
|
||||||
defer deleteRepo(t, name)
|
|
||||||
|
|
||||||
seenA, seenB := false, false
|
|
||||||
const n = 12
|
|
||||||
for i := 0; i < n; i++ {
|
|
||||||
url := api(fmt.Sprintf("/api/v1/remote/%s/rr/%d", name, i))
|
|
||||||
resp, body := doRequest(t, http.MethodGet, url, nil, "")
|
|
||||||
if resp.StatusCode != http.StatusOK {
|
|
||||||
t.Fatalf("request %d: status %d: %s", i, resp.StatusCode, body)
|
|
||||||
}
|
|
||||||
switch strings.TrimSpace(string(body)) {
|
|
||||||
case "UPSTREAM-A":
|
|
||||||
seenA = true
|
|
||||||
case "UPSTREAM-B":
|
|
||||||
seenB = true
|
|
||||||
default:
|
|
||||||
t.Fatalf("request %d: unexpected body %q", i, body)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if !seenA || !seenB {
|
|
||||||
t.Fatalf("round-robin did not reach both upstreams: A=%v B=%v", seenA, seenB)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// TestMultiBaseURLFailover points a two-mirror remote at a dead primary and a
|
|
||||||
// healthy secondary and asserts every request still succeeds via the secondary.
|
|
||||||
func TestMultiBaseURLFailover(t *testing.T) {
|
|
||||||
name := "e2e-failover"
|
|
||||||
createRepo(t, fmt.Sprintf(`{
|
|
||||||
"name": %q,
|
|
||||||
"package_type": "rpm",
|
|
||||||
"repo_type": "remote",
|
|
||||||
"base_url": "http://mockupstream-dead:80",
|
|
||||||
"mirrorlist": [%q],
|
|
||||||
"stale_on_error": false
|
|
||||||
}`, name, mockUpstreamB()))
|
|
||||||
defer deleteRepo(t, name)
|
|
||||||
|
|
||||||
for i := 0; i < 6; i++ {
|
|
||||||
url := api(fmt.Sprintf("/api/v1/remote/%s/fo/%d", name, i))
|
|
||||||
resp, body := doRequest(t, http.MethodGet, url, nil, "")
|
|
||||||
if resp.StatusCode != http.StatusOK {
|
|
||||||
t.Fatalf("request %d: dead primary broke fetch: status %d: %s", i, resp.StatusCode, body)
|
|
||||||
}
|
|
||||||
if got := strings.TrimSpace(string(body)); got != "UPSTREAM-B" {
|
|
||||||
t.Fatalf("request %d: body %q, want UPSTREAM-B (served via failover)", i, got)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// TestSingleBaseURLRegression asserts a remote with no mirrorlist works exactly
|
|
||||||
// as before the mirrorlist change.
|
|
||||||
func TestSingleBaseURLRegression(t *testing.T) {
|
|
||||||
name := "e2e-single"
|
|
||||||
createRepo(t, fmt.Sprintf(`{
|
|
||||||
"name": %q,
|
|
||||||
"package_type": "rpm",
|
|
||||||
"repo_type": "remote",
|
|
||||||
"base_url": %q,
|
|
||||||
"stale_on_error": false
|
|
||||||
}`, name, mockUpstreamA()))
|
|
||||||
defer deleteRepo(t, name)
|
|
||||||
|
|
||||||
resp, body := doRequest(t, http.MethodGet, api("/api/v1/remote/"+name+"/solo/0"), nil, "")
|
|
||||||
if resp.StatusCode != http.StatusOK {
|
|
||||||
t.Fatalf("single-url fetch: status %d: %s", resp.StatusCode, body)
|
|
||||||
}
|
|
||||||
if got := strings.TrimSpace(string(body)); got != "UPSTREAM-A" {
|
|
||||||
t.Fatalf("single-url body %q, want UPSTREAM-A", got)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// TestMultiBaseURLDnfFailover drives a real dnf (stock rockylinux container) at
|
|
||||||
// a two-mirror rpm remote whose primary is dead: makecache + install must
|
|
||||||
// succeed via the live secondary mirror, proving a dead mirror does not break a
|
|
||||||
// real package-manager client. Requires the compose network and internal API
|
|
||||||
// URL exported by scripts/docker-e2e.sh; skipped when run standalone.
|
|
||||||
func TestMultiBaseURLDnfFailover(t *testing.T) {
|
|
||||||
network := os.Getenv("COMPOSE_NETWORK")
|
|
||||||
internal := os.Getenv("ARTIFACTAPI_INTERNAL")
|
|
||||||
if network == "" || internal == "" {
|
|
||||||
t.Skip("COMPOSE_NETWORK/ARTIFACTAPI_INTERNAL not set; run via scripts/docker-e2e.sh")
|
|
||||||
}
|
|
||||||
if _, err := exec.LookPath("docker"); err != nil {
|
|
||||||
t.Skip("docker not available on the test host")
|
|
||||||
}
|
|
||||||
|
|
||||||
name := "e2e-dnf-failover"
|
|
||||||
// Primary base_url is dead; the live mirror serves the real yum repo under
|
|
||||||
// fixtures/rpm-mirror via the shared mock upstream.
|
|
||||||
createRepo(t, fmt.Sprintf(`{
|
|
||||||
"name": %q,
|
|
||||||
"package_type": "rpm",
|
|
||||||
"repo_type": "remote",
|
|
||||||
"base_url": "http://mockupstream-dead:80",
|
|
||||||
"mirrorlist": [%q],
|
|
||||||
"stale_on_error": false
|
|
||||||
}`, name, mockUpstream()))
|
|
||||||
defer deleteRepo(t, name)
|
|
||||||
|
|
||||||
repoURL := strings.TrimRight(internal, "/") + "/api/v1/remote/" + name + "/rpm-mirror"
|
|
||||||
repoConf := fmt.Sprintf("[dnffo]\nname=dnffo\nbaseurl=%s\nenabled=1\ngpgcheck=0\nsslverify=0\nmetadata_expire=0\n", repoURL)
|
|
||||||
script := "set -euo pipefail; " +
|
|
||||||
"printf '%s' \"$REPO\" > /etc/yum.repos.d/dnffo.repo; " +
|
|
||||||
"dnf -y --disablerepo='*' --enablerepo=dnffo makecache; " +
|
|
||||||
"dnf -y --disablerepo='*' --enablerepo=dnffo install e2e-testpkg; " +
|
|
||||||
"rpm -q e2e-testpkg"
|
|
||||||
|
|
||||||
cmd := exec.Command("docker", "run", "--rm",
|
|
||||||
"--network", network,
|
|
||||||
"-e", "REPO="+repoConf,
|
|
||||||
"rockylinux:9", "bash", "-c", script)
|
|
||||||
out, err := cmd.CombinedOutput()
|
|
||||||
if err != nil {
|
|
||||||
t.Fatalf("real dnf install through a dead primary mirror failed: %v\n%s", err, out)
|
|
||||||
}
|
|
||||||
if !strings.Contains(string(out), "e2e-testpkg-1.0-1") {
|
|
||||||
t.Fatalf("dnf did not install the expected package via failover; output:\n%s", out)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,88 +0,0 @@
|
|||||||
//go:build dockere2e
|
|
||||||
|
|
||||||
package e2edocker
|
|
||||||
|
|
||||||
import (
|
|
||||||
"archive/tar"
|
|
||||||
"bytes"
|
|
||||||
"compress/gzip"
|
|
||||||
"net/http"
|
|
||||||
"os"
|
|
||||||
"os/exec"
|
|
||||||
"strings"
|
|
||||||
"testing"
|
|
||||||
"time"
|
|
||||||
)
|
|
||||||
|
|
||||||
const puppetHelloMetadata = `{"name":"unkin-hello","version":"0.1.0","author":"unkin","summary":"e2e","license":"Apache-2.0","source":"https://example.invalid","dependencies":[{"name":"puppetlabs/stdlib","version_requirement":">= 4.0.0 < 10.0.0"}]}`
|
|
||||||
|
|
||||||
func puppetModuleTarball(t *testing.T) []byte {
|
|
||||||
t.Helper()
|
|
||||||
var buf bytes.Buffer
|
|
||||||
zw := gzip.NewWriter(&buf)
|
|
||||||
tw := tar.NewWriter(zw)
|
|
||||||
for name, body := range map[string]string{
|
|
||||||
"unkin-hello-0.1.0/metadata.json": puppetHelloMetadata,
|
|
||||||
"unkin-hello-0.1.0/manifests/init.pp": "class hello {}\n",
|
|
||||||
} {
|
|
||||||
if err := tw.WriteHeader(&tar.Header{Name: name, Mode: 0o644, Size: int64(len(body)), ModTime: time.Now()}); err != nil {
|
|
||||||
t.Fatal(err)
|
|
||||||
}
|
|
||||||
_, _ = tw.Write([]byte(body))
|
|
||||||
}
|
|
||||||
_ = tw.Close()
|
|
||||||
_ = zw.Close()
|
|
||||||
return buf.Bytes()
|
|
||||||
}
|
|
||||||
|
|
||||||
// TestLocalPuppetRealClient publishes a module to a puppet local and installs
|
|
||||||
// it with the real r10k and puppet module tool. The stdlib dependency is not on
|
|
||||||
// a local-only forge, so puppet runs with --ignore-dependencies.
|
|
||||||
func TestLocalPuppetRealClient(t *testing.T) {
|
|
||||||
network := os.Getenv("COMPOSE_NETWORK")
|
|
||||||
internal := strings.TrimRight(os.Getenv("ARTIFACTAPI_INTERNAL"), "/")
|
|
||||||
if network == "" || internal == "" {
|
|
||||||
t.Skip("COMPOSE_NETWORK/ARTIFACTAPI_INTERNAL not set; run via scripts/docker-e2e.sh")
|
|
||||||
}
|
|
||||||
if _, err := exec.LookPath("docker"); err != nil {
|
|
||||||
t.Skip("docker not available on the test host")
|
|
||||||
}
|
|
||||||
|
|
||||||
createRepo(t, `{"name":"local-puppet","package_type":"puppet","repo_type":"local"}`)
|
|
||||||
defer deleteRepo(t, "local-puppet")
|
|
||||||
|
|
||||||
upload := api("/api/v2/remotes/local-puppet/files/unkin-hello-0.1.0.tar.gz")
|
|
||||||
defer doRequest(t, http.MethodDelete, api("/api/v2/remotes/local-puppet/files/v3/files/unkin-hello-0.1.0.tar.gz"), nil, "")
|
|
||||||
tarball := puppetModuleTarball(t)
|
|
||||||
if resp, body := doRequest(t, http.MethodPut, upload, tarball, "application/gzip"); resp.StatusCode != http.StatusCreated {
|
|
||||||
t.Fatalf("upload: %d %s", resp.StatusCode, body)
|
|
||||||
}
|
|
||||||
if resp, _ := doRequest(t, http.MethodPut, upload, tarball, "application/gzip"); resp.StatusCode != http.StatusConflict {
|
|
||||||
t.Fatalf("re-upload of an existing version: %d, want 409", resp.StatusCode)
|
|
||||||
}
|
|
||||||
if resp, body := getEventually(t, api("/api/v1/local/local-puppet/v3/releases/unkin-hello-0.1.0"), 15*time.Second); resp.StatusCode != http.StatusOK || !strings.Contains(string(body), `"file_md5"`) {
|
|
||||||
t.Fatalf("release never indexed: %d %s", resp.StatusCode, body)
|
|
||||||
}
|
|
||||||
|
|
||||||
forge := internal + "/api/v1/local/local-puppet"
|
|
||||||
run := func(image, script string) string {
|
|
||||||
t.Helper()
|
|
||||||
out, err := exec.Command("docker", "run", "--rm", "--network", network, "--entrypoint", "sh", image, "-c", "set -eu; "+script).CombinedOutput()
|
|
||||||
if err != nil {
|
|
||||||
t.Fatalf("%s failed: %v\n%s", image, err, out)
|
|
||||||
}
|
|
||||||
return string(out)
|
|
||||||
}
|
|
||||||
|
|
||||||
out := run("ghcr.io/voxpupuli/r10k:latest", "cd /tmp && printf 'forge:\\n baseurl: "+forge+"\\n' > r10k.yaml && "+
|
|
||||||
"printf \"forge '"+forge+"'\\nmod 'unkin-hello', '0.1.0'\\n\" > Puppetfile && "+
|
|
||||||
"r10k puppetfile install -c r10k.yaml --verbose && cat modules/hello/metadata.json")
|
|
||||||
if !strings.Contains(out, `"unkin-hello"`) {
|
|
||||||
t.Fatalf("r10k did not install unkin-hello:\n%s", out)
|
|
||||||
}
|
|
||||||
|
|
||||||
out = run("ghcr.io/openvoxproject/openvoxagent:latest", "export PATH=/opt/puppetlabs/bin:$PATH; puppet module install unkin-hello --module_repository "+forge+" --ignore-dependencies --target-dir /tmp/mods && puppet module list --color=false --modulepath /tmp/mods")
|
|
||||||
if !strings.Contains(out, "unkin-hello (v0.1.0)") {
|
|
||||||
t.Fatalf("puppet module install did not install unkin-hello:\n%s", out)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,134 +0,0 @@
|
|||||||
//go:build dockere2e
|
|
||||||
|
|
||||||
package e2edocker
|
|
||||||
|
|
||||||
import (
|
|
||||||
"encoding/json"
|
|
||||||
"net/http"
|
|
||||||
"testing"
|
|
||||||
)
|
|
||||||
|
|
||||||
func TestHealth(t *testing.T) {
|
|
||||||
resp, body := doRequest(t, http.MethodGet, api("/health"), nil, "")
|
|
||||||
if resp.StatusCode != http.StatusOK {
|
|
||||||
t.Fatalf("health: status %d: %s", resp.StatusCode, body)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// TestRemoteLifecycle covers add/change/delete for a remote repository.
|
|
||||||
func TestRemoteLifecycle(t *testing.T) {
|
|
||||||
createRepo(t, `{
|
|
||||||
"name": "crud-remote",
|
|
||||||
"package_type": "generic",
|
|
||||||
"repo_type": "remote",
|
|
||||||
"base_url": "https://example.com",
|
|
||||||
"mutable_ttl": 600,
|
|
||||||
"stale_on_error": true
|
|
||||||
}`)
|
|
||||||
defer deleteRepo(t, "crud-remote")
|
|
||||||
|
|
||||||
got := getRepo(t, "crud-remote")
|
|
||||||
if got["base_url"] != "https://example.com" || got["mutable_ttl"].(float64) != 600 {
|
|
||||||
t.Fatalf("unexpected created remote: %v", got)
|
|
||||||
}
|
|
||||||
|
|
||||||
// change
|
|
||||||
resp, body := doRequest(t, http.MethodPut, api("/api/v2/remotes/crud-remote"), []byte(`{
|
|
||||||
"package_type": "generic",
|
|
||||||
"base_url": "https://updated.example.com",
|
|
||||||
"mutable_ttl": 120,
|
|
||||||
"stale_on_error": true
|
|
||||||
}`), "application/json")
|
|
||||||
if resp.StatusCode != http.StatusOK {
|
|
||||||
t.Fatalf("update remote: status %d: %s", resp.StatusCode, body)
|
|
||||||
}
|
|
||||||
got = getRepo(t, "crud-remote")
|
|
||||||
if got["base_url"] != "https://updated.example.com" || got["mutable_ttl"].(float64) != 120 {
|
|
||||||
t.Fatalf("update not applied: %v", got)
|
|
||||||
}
|
|
||||||
|
|
||||||
// delete
|
|
||||||
resp, _ = doRequest(t, http.MethodDelete, api("/api/v2/remotes/crud-remote"), nil, "")
|
|
||||||
if resp.StatusCode != http.StatusNoContent {
|
|
||||||
t.Fatalf("delete remote: status %d", resp.StatusCode)
|
|
||||||
}
|
|
||||||
resp, _ = doRequest(t, http.MethodGet, api("/api/v2/remotes/crud-remote"), nil, "")
|
|
||||||
if resp.StatusCode != http.StatusNotFound {
|
|
||||||
t.Fatalf("expected 404 after delete, got %d", resp.StatusCode)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// TestLocalLifecycle covers add/delete for a local repository.
|
|
||||||
func TestLocalLifecycle(t *testing.T) {
|
|
||||||
createRepo(t, `{
|
|
||||||
"name": "crud-local",
|
|
||||||
"package_type": "generic",
|
|
||||||
"repo_type": "local"
|
|
||||||
}`)
|
|
||||||
defer deleteRepo(t, "crud-local")
|
|
||||||
|
|
||||||
got := getRepo(t, "crud-local")
|
|
||||||
if got["repo_type"] != "local" {
|
|
||||||
t.Fatalf("expected repo_type local, got %v", got["repo_type"])
|
|
||||||
}
|
|
||||||
|
|
||||||
resp, _ := doRequest(t, http.MethodDelete, api("/api/v2/remotes/crud-local"), nil, "")
|
|
||||||
if resp.StatusCode != http.StatusNoContent {
|
|
||||||
t.Fatalf("delete local: status %d", resp.StatusCode)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// TestVirtualLifecycle covers add/change/delete for a virtual repository.
|
|
||||||
func TestVirtualLifecycle(t *testing.T) {
|
|
||||||
createRepo(t, `{"name":"vmem-a","package_type":"helm","repo_type":"remote","base_url":"https://a.example.com","stale_on_error":true}`)
|
|
||||||
createRepo(t, `{"name":"vmem-b","package_type":"helm","repo_type":"remote","base_url":"https://b.example.com","stale_on_error":true}`)
|
|
||||||
defer deleteRepo(t, "vmem-a")
|
|
||||||
defer deleteRepo(t, "vmem-b")
|
|
||||||
|
|
||||||
createVirtual(t, `{
|
|
||||||
"name": "crud-virtual",
|
|
||||||
"package_type": "helm",
|
|
||||||
"members": ["vmem-a"]
|
|
||||||
}`)
|
|
||||||
defer deleteVirtual(t, "crud-virtual")
|
|
||||||
|
|
||||||
// change members
|
|
||||||
resp, body := doRequest(t, http.MethodPut, api("/api/v2/virtuals/crud-virtual"), []byte(`{
|
|
||||||
"package_type": "helm",
|
|
||||||
"members": ["vmem-a", "vmem-b"]
|
|
||||||
}`), "application/json")
|
|
||||||
if resp.StatusCode != http.StatusOK {
|
|
||||||
t.Fatalf("update virtual: status %d: %s", resp.StatusCode, body)
|
|
||||||
}
|
|
||||||
|
|
||||||
resp, body = doRequest(t, http.MethodGet, api("/api/v2/virtuals/crud-virtual"), nil, "")
|
|
||||||
if resp.StatusCode != http.StatusOK {
|
|
||||||
t.Fatalf("get virtual: status %d: %s", resp.StatusCode, body)
|
|
||||||
}
|
|
||||||
var v map[string]any
|
|
||||||
if err := json.Unmarshal(body, &v); err != nil {
|
|
||||||
t.Fatalf("decode virtual: %v", err)
|
|
||||||
}
|
|
||||||
members, _ := v["members"].([]any)
|
|
||||||
if len(members) != 2 {
|
|
||||||
t.Fatalf("expected 2 members after update, got %v", v["members"])
|
|
||||||
}
|
|
||||||
|
|
||||||
resp, _ = doRequest(t, http.MethodDelete, api("/api/v2/virtuals/crud-virtual"), nil, "")
|
|
||||||
if resp.StatusCode != http.StatusNoContent {
|
|
||||||
t.Fatalf("delete virtual: status %d", resp.StatusCode)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func getRepo(t *testing.T, name string) map[string]any {
|
|
||||||
t.Helper()
|
|
||||||
resp, body := doRequest(t, http.MethodGet, api("/api/v2/remotes/"+name), nil, "")
|
|
||||||
if resp.StatusCode != http.StatusOK {
|
|
||||||
t.Fatalf("get remote %s: status %d: %s", name, resp.StatusCode, body)
|
|
||||||
}
|
|
||||||
var m map[string]any
|
|
||||||
if err := json.Unmarshal(body, &m); err != nil {
|
|
||||||
t.Fatalf("decode remote %s: %v", name, err)
|
|
||||||
}
|
|
||||||
return m
|
|
||||||
}
|
|
||||||
@@ -1,138 +0,0 @@
|
|||||||
//go:build dockere2e
|
|
||||||
|
|
||||||
package e2edocker
|
|
||||||
|
|
||||||
import (
|
|
||||||
"bytes"
|
|
||||||
"compress/gzip"
|
|
||||||
"encoding/xml"
|
|
||||||
"fmt"
|
|
||||||
"io"
|
|
||||||
"net/http"
|
|
||||||
"os"
|
|
||||||
"os/exec"
|
|
||||||
"strings"
|
|
||||||
"testing"
|
|
||||||
"time"
|
|
||||||
)
|
|
||||||
|
|
||||||
// TestVirtualPyPIMerge uploads different packages to two pypi locals and
|
|
||||||
// checks that a virtual over them serves a merged simple index.
|
|
||||||
func TestVirtualPyPIMerge(t *testing.T) {
|
|
||||||
createRepo(t, `{"name":"pmerge-a","package_type":"pypi","repo_type":"local"}`)
|
|
||||||
createRepo(t, `{"name":"pmerge-b","package_type":"pypi","repo_type":"local"}`)
|
|
||||||
defer deleteRepo(t, "pmerge-a")
|
|
||||||
defer deleteRepo(t, "pmerge-b")
|
|
||||||
|
|
||||||
uploadFile(t, "pmerge-a", "foo-1.0-py3-none-any.whl", fixtureBytes(t, "packages/foo-1.0-py3-none-any.whl"), "application/zip")
|
|
||||||
uploadFile(t, "pmerge-b", "bar-2.0-py3-none-any.whl", []byte("bar wheel payload"), "application/zip")
|
|
||||||
|
|
||||||
createVirtual(t, `{"name":"pmerge-v","package_type":"pypi","members":["pmerge-a","pmerge-b"]}`)
|
|
||||||
defer deleteVirtual(t, "pmerge-v")
|
|
||||||
|
|
||||||
resp, body := doRequest(t, http.MethodGet, api("/api/v1/virtual/pmerge-v/simple/"), nil, "")
|
|
||||||
if resp.StatusCode != http.StatusOK {
|
|
||||||
t.Fatalf("virtual simple index: status %d: %s", resp.StatusCode, body)
|
|
||||||
}
|
|
||||||
s := string(body)
|
|
||||||
if !strings.Contains(s, "foo") || !strings.Contains(s, "bar") {
|
|
||||||
t.Fatalf("merged index missing a member package (want foo and bar): %s", s)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// TestVirtualHelmMerge points two helm remotes at mock index.yaml documents
|
|
||||||
// with distinct charts and checks the virtual merges both into one index.
|
|
||||||
func TestVirtualHelmMerge(t *testing.T) {
|
|
||||||
createRepo(t, `{"name":"hmerge-a","package_type":"helm","repo_type":"remote","base_url":"`+mockUpstream()+`/helm-a","stale_on_error":true}`)
|
|
||||||
createRepo(t, `{"name":"hmerge-b","package_type":"helm","repo_type":"remote","base_url":"`+mockUpstream()+`/helm-b","stale_on_error":true}`)
|
|
||||||
defer deleteRepo(t, "hmerge-a")
|
|
||||||
defer deleteRepo(t, "hmerge-b")
|
|
||||||
|
|
||||||
createVirtual(t, `{"name":"hmerge-v","package_type":"helm","members":["hmerge-a","hmerge-b"]}`)
|
|
||||||
defer deleteVirtual(t, "hmerge-v")
|
|
||||||
|
|
||||||
resp, body := doRequest(t, http.MethodGet, api("/api/v1/virtual/hmerge-v/index.yaml"), nil, "")
|
|
||||||
if resp.StatusCode != http.StatusOK {
|
|
||||||
t.Fatalf("virtual index.yaml: status %d: %s", resp.StatusCode, body)
|
|
||||||
}
|
|
||||||
s := string(body)
|
|
||||||
if !strings.Contains(s, "alpha") || !strings.Contains(s, "beta") {
|
|
||||||
t.Fatalf("merged helm index missing a member chart (want alpha and beta): %s", s)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// TestVirtualRPMMerge merges a remote rpm repo and a local rpm repo carrying the
|
|
||||||
// same package: the first member wins the duplicate, its package download
|
|
||||||
// routes through the virtual, and a real dnf can consume the merged repo.
|
|
||||||
func TestVirtualRPMMerge(t *testing.T) {
|
|
||||||
createRepo(t, `{"name":"vrpm-remote","package_type":"rpm","repo_type":"remote","base_url":"`+mockUpstream()+`/rpm-mirror","stale_on_error":true}`)
|
|
||||||
createRepo(t, `{"name":"vrpm-local","package_type":"rpm","repo_type":"local"}`)
|
|
||||||
defer deleteRepo(t, "vrpm-remote")
|
|
||||||
defer deleteRepo(t, "vrpm-local")
|
|
||||||
|
|
||||||
pkg := fixtureBytes(t, "rpmrepo/Packages/e2e-testpkg-1.0-1.noarch.rpm")
|
|
||||||
uploadFile(t, "vrpm-local", "e2e-testpkg-1.0-1.noarch.rpm", pkg, "application/x-rpm")
|
|
||||||
|
|
||||||
createVirtual(t, `{"name":"vrpm","package_type":"rpm","members":["vrpm-remote","vrpm-local"]}`)
|
|
||||||
defer deleteVirtual(t, "vrpm")
|
|
||||||
|
|
||||||
resp, body := getEventually(t, api("/api/v1/virtual/vrpm/repodata/repomd.xml"), 15*time.Second)
|
|
||||||
if resp.StatusCode != http.StatusOK {
|
|
||||||
t.Fatalf("virtual repomd.xml: status %d: %s", resp.StatusCode, body)
|
|
||||||
}
|
|
||||||
var md struct {
|
|
||||||
Data []struct {
|
|
||||||
Type string `xml:"type,attr"`
|
|
||||||
Location struct {
|
|
||||||
Href string `xml:"href,attr"`
|
|
||||||
} `xml:"location"`
|
|
||||||
} `xml:"data"`
|
|
||||||
}
|
|
||||||
if err := xml.Unmarshal(body, &md); err != nil {
|
|
||||||
t.Fatalf("parse repomd.xml: %v\n%s", err, body)
|
|
||||||
}
|
|
||||||
var primary []byte
|
|
||||||
for _, d := range md.Data {
|
|
||||||
if d.Type == "primary" {
|
|
||||||
resp, gz := doRequest(t, http.MethodGet, api("/api/v1/virtual/vrpm/"+d.Location.Href), nil, "")
|
|
||||||
if resp.StatusCode != http.StatusOK {
|
|
||||||
t.Fatalf("primary: status %d", resp.StatusCode)
|
|
||||||
}
|
|
||||||
r, err := gzip.NewReader(bytes.NewReader(gz))
|
|
||||||
if err != nil {
|
|
||||||
t.Fatal(err)
|
|
||||||
}
|
|
||||||
primary, _ = io.ReadAll(r)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
href := "vrpm-remote/Packages/e2e-testpkg-1.0-1.noarch.rpm"
|
|
||||||
if strings.Count(string(primary), "<name>e2e-testpkg</name>") != 1 || !strings.Contains(string(primary), `href="`+href+`"`) {
|
|
||||||
t.Fatalf("merged primary should hold one e2e-testpkg owned by the first member:\n%s", primary)
|
|
||||||
}
|
|
||||||
|
|
||||||
resp, got := doRequest(t, http.MethodGet, api("/api/v1/virtual/vrpm/"+href), nil, "")
|
|
||||||
if resp.StatusCode != http.StatusOK || !bytes.Equal(got, pkg) {
|
|
||||||
t.Fatalf("package via virtual: status %d, %d bytes (want %d)", resp.StatusCode, len(got), len(pkg))
|
|
||||||
}
|
|
||||||
|
|
||||||
network := os.Getenv("COMPOSE_NETWORK")
|
|
||||||
internal := os.Getenv("ARTIFACTAPI_INTERNAL")
|
|
||||||
if network == "" || internal == "" {
|
|
||||||
t.Skip("COMPOSE_NETWORK/ARTIFACTAPI_INTERNAL not set; skipping real dnf")
|
|
||||||
}
|
|
||||||
if _, err := exec.LookPath("docker"); err != nil {
|
|
||||||
t.Skip("docker not available on the test host")
|
|
||||||
}
|
|
||||||
repoConf := fmt.Sprintf("[vrpm]\nname=vrpm\nbaseurl=%s/api/v1/virtual/vrpm/\nenabled=1\ngpgcheck=0\nmetadata_expire=0\n", strings.TrimRight(internal, "/"))
|
|
||||||
script := "set -euo pipefail; " +
|
|
||||||
"printf '%s' \"$REPO\" > /etc/yum.repos.d/vrpm.repo; " +
|
|
||||||
"dnf -y --disablerepo='*' --enablerepo=vrpm makecache; " +
|
|
||||||
"dnf -y --disablerepo='*' --enablerepo=vrpm list --available; " +
|
|
||||||
"dnf -y --disablerepo='*' --enablerepo=vrpm install e2e-testpkg; " +
|
|
||||||
"rpm -q e2e-testpkg"
|
|
||||||
out, err := exec.Command("docker", "run", "--rm", "--network", network, "-e", "REPO="+repoConf,
|
|
||||||
"rockylinux:9", "bash", "-c", script).CombinedOutput()
|
|
||||||
if err != nil {
|
|
||||||
t.Fatalf("real dnf against rpm virtual failed: %v\n%s", err, out)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
-137
@@ -1,137 +0,0 @@
|
|||||||
//go:build e2e
|
|
||||||
|
|
||||||
package e2e
|
|
||||||
|
|
||||||
import (
|
|
||||||
"context"
|
|
||||||
"fmt"
|
|
||||||
"log"
|
|
||||||
"net/http"
|
|
||||||
"os"
|
|
||||||
"testing"
|
|
||||||
"time"
|
|
||||||
|
|
||||||
"github.com/testcontainers/testcontainers-go"
|
|
||||||
tcpostgres "github.com/testcontainers/testcontainers-go/modules/postgres"
|
|
||||||
tcredis "github.com/testcontainers/testcontainers-go/modules/redis"
|
|
||||||
"github.com/testcontainers/testcontainers-go/wait"
|
|
||||||
|
|
||||||
"git.unkin.net/unkin/artifactapi/internal/config"
|
|
||||||
"git.unkin.net/unkin/artifactapi/internal/server"
|
|
||||||
)
|
|
||||||
|
|
||||||
var baseURL string
|
|
||||||
|
|
||||||
func TestMain(m *testing.M) {
|
|
||||||
ctx := context.Background()
|
|
||||||
|
|
||||||
pgContainer, err := tcpostgres.Run(ctx,
|
|
||||||
"postgres:17-alpine",
|
|
||||||
tcpostgres.WithDatabase("artifacts"),
|
|
||||||
tcpostgres.WithUsername("artifacts"),
|
|
||||||
tcpostgres.WithPassword("artifacts123"),
|
|
||||||
testcontainers.WithWaitStrategy(
|
|
||||||
wait.ForListeningPort("5432/tcp").WithStartupTimeout(30*time.Second),
|
|
||||||
),
|
|
||||||
)
|
|
||||||
if err != nil {
|
|
||||||
log.Fatalf("postgres: %v", err)
|
|
||||||
}
|
|
||||||
defer pgContainer.Terminate(ctx)
|
|
||||||
|
|
||||||
redisContainer, err := tcredis.Run(ctx,
|
|
||||||
"redis:7-alpine",
|
|
||||||
testcontainers.WithWaitStrategy(
|
|
||||||
wait.ForListeningPort("6379/tcp").WithStartupTimeout(30*time.Second),
|
|
||||||
),
|
|
||||||
)
|
|
||||||
if err != nil {
|
|
||||||
log.Fatalf("redis: %v", err)
|
|
||||||
}
|
|
||||||
defer redisContainer.Terminate(ctx)
|
|
||||||
|
|
||||||
minioContainer, err := testcontainers.GenericContainer(ctx, testcontainers.GenericContainerRequest{
|
|
||||||
ContainerRequest: testcontainers.ContainerRequest{
|
|
||||||
Image: "minio/minio:latest",
|
|
||||||
ExposedPorts: []string{"9000/tcp"},
|
|
||||||
Cmd: []string{"server", "/data"},
|
|
||||||
Env: map[string]string{
|
|
||||||
"MINIO_ROOT_USER": "minioadmin",
|
|
||||||
"MINIO_ROOT_PASSWORD": "minioadmin",
|
|
||||||
},
|
|
||||||
WaitingFor: wait.ForHTTP("/minio/health/live").WithPort("9000/tcp").WithStartupTimeout(30 * time.Second),
|
|
||||||
},
|
|
||||||
Started: true,
|
|
||||||
})
|
|
||||||
if err != nil {
|
|
||||||
log.Fatalf("minio: %v", err)
|
|
||||||
}
|
|
||||||
defer minioContainer.Terminate(ctx)
|
|
||||||
|
|
||||||
pgHost, _ := pgContainer.Host(ctx)
|
|
||||||
pgPort, _ := pgContainer.MappedPort(ctx, "5432/tcp")
|
|
||||||
redisHost, _ := redisContainer.Host(ctx)
|
|
||||||
redisPort, _ := redisContainer.MappedPort(ctx, "6379/tcp")
|
|
||||||
minioHost, _ := minioContainer.Host(ctx)
|
|
||||||
minioPort, _ := minioContainer.MappedPort(ctx, "9000/tcp")
|
|
||||||
|
|
||||||
os.Setenv("DBHOST", pgHost)
|
|
||||||
os.Setenv("DBPORT", pgPort.Port())
|
|
||||||
os.Setenv("DBUSER", "artifacts")
|
|
||||||
os.Setenv("DBPASS", "artifacts123")
|
|
||||||
os.Setenv("DBNAME", "artifacts")
|
|
||||||
os.Setenv("DBSSL", "disable")
|
|
||||||
os.Setenv("REDIS_URL", fmt.Sprintf("redis://%s:%s", redisHost, redisPort.Port()))
|
|
||||||
os.Setenv("MINIO_ENDPOINT", fmt.Sprintf("%s:%s", minioHost, minioPort.Port()))
|
|
||||||
os.Setenv("MINIO_ACCESS_KEY", "minioadmin")
|
|
||||||
os.Setenv("MINIO_SECRET_KEY", "minioadmin")
|
|
||||||
os.Setenv("MINIO_BUCKET", "artifacts-test")
|
|
||||||
os.Setenv("MINIO_SECURE", "false")
|
|
||||||
os.Setenv("LISTEN_ADDR", ":0")
|
|
||||||
|
|
||||||
cfg, err := config.Load()
|
|
||||||
if err != nil {
|
|
||||||
log.Fatalf("config: %v", err)
|
|
||||||
}
|
|
||||||
cfg.ListenAddr = "127.0.0.1:0"
|
|
||||||
|
|
||||||
srv, err := server.New(cfg, "e2e-test")
|
|
||||||
if err != nil {
|
|
||||||
log.Fatalf("server: %v", err)
|
|
||||||
}
|
|
||||||
|
|
||||||
srvCtx, cancel := context.WithCancel(ctx)
|
|
||||||
defer cancel()
|
|
||||||
|
|
||||||
addr := startServer(srvCtx, srv)
|
|
||||||
baseURL = "http://" + addr
|
|
||||||
|
|
||||||
code := m.Run()
|
|
||||||
cancel()
|
|
||||||
os.Exit(code)
|
|
||||||
}
|
|
||||||
|
|
||||||
func startServer(ctx context.Context, srv *server.Server) string {
|
|
||||||
ln, err := findListener()
|
|
||||||
if err != nil {
|
|
||||||
log.Fatalf("listener: %v", err)
|
|
||||||
}
|
|
||||||
addr := ln.Addr().String()
|
|
||||||
|
|
||||||
go srv.RunOnListener(ctx, ln)
|
|
||||||
|
|
||||||
deadline := time.Now().Add(5 * time.Second)
|
|
||||||
for time.Now().Before(deadline) {
|
|
||||||
resp, err := http.Get("http://" + addr + "/health")
|
|
||||||
if err == nil && resp.StatusCode == 200 {
|
|
||||||
resp.Body.Close()
|
|
||||||
return addr
|
|
||||||
}
|
|
||||||
if resp != nil {
|
|
||||||
resp.Body.Close()
|
|
||||||
}
|
|
||||||
time.Sleep(50 * time.Millisecond)
|
|
||||||
}
|
|
||||||
log.Fatalf("server did not start in time at %s", addr)
|
|
||||||
return ""
|
|
||||||
}
|
|
||||||
@@ -1,109 +0,0 @@
|
|||||||
//go:build e2e
|
|
||||||
|
|
||||||
package e2e
|
|
||||||
|
|
||||||
import (
|
|
||||||
"encoding/json"
|
|
||||||
"fmt"
|
|
||||||
"io"
|
|
||||||
"net"
|
|
||||||
"net/http"
|
|
||||||
"strings"
|
|
||||||
"testing"
|
|
||||||
)
|
|
||||||
|
|
||||||
func findListener() (net.Listener, error) {
|
|
||||||
return net.Listen("tcp", "127.0.0.1:0")
|
|
||||||
}
|
|
||||||
|
|
||||||
func apiURL(path string) string {
|
|
||||||
return baseURL + path
|
|
||||||
}
|
|
||||||
|
|
||||||
func createRemote(t *testing.T, body string) {
|
|
||||||
t.Helper()
|
|
||||||
resp, err := http.Post(apiURL("/api/v2/remotes"), "application/json", strings.NewReader(body))
|
|
||||||
if err != nil {
|
|
||||||
t.Fatalf("create remote: %v", err)
|
|
||||||
}
|
|
||||||
defer resp.Body.Close()
|
|
||||||
if resp.StatusCode != http.StatusCreated {
|
|
||||||
b, _ := io.ReadAll(resp.Body)
|
|
||||||
t.Fatalf("create remote: status %d: %s", resp.StatusCode, b)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func deleteRemote(t *testing.T, name string) {
|
|
||||||
t.Helper()
|
|
||||||
req, _ := http.NewRequest(http.MethodDelete, apiURL("/api/v2/remotes/"+name), nil)
|
|
||||||
resp, err := http.DefaultClient.Do(req)
|
|
||||||
if err != nil {
|
|
||||||
t.Fatalf("delete remote: %v", err)
|
|
||||||
}
|
|
||||||
resp.Body.Close()
|
|
||||||
}
|
|
||||||
|
|
||||||
func getJSON(t *testing.T, url string) map[string]any {
|
|
||||||
t.Helper()
|
|
||||||
resp, err := http.Get(url)
|
|
||||||
if err != nil {
|
|
||||||
t.Fatalf("GET %s: %v", url, err)
|
|
||||||
}
|
|
||||||
defer resp.Body.Close()
|
|
||||||
if resp.StatusCode != http.StatusOK {
|
|
||||||
b, _ := io.ReadAll(resp.Body)
|
|
||||||
t.Fatalf("GET %s: status %d: %s", url, resp.StatusCode, b)
|
|
||||||
}
|
|
||||||
var result map[string]any
|
|
||||||
if err := json.NewDecoder(resp.Body).Decode(&result); err != nil {
|
|
||||||
t.Fatalf("decode: %v", err)
|
|
||||||
}
|
|
||||||
return result
|
|
||||||
}
|
|
||||||
|
|
||||||
func getBody(t *testing.T, url string) ([]byte, int) {
|
|
||||||
t.Helper()
|
|
||||||
resp, err := http.Get(url)
|
|
||||||
if err != nil {
|
|
||||||
t.Fatalf("GET %s: %v", url, err)
|
|
||||||
}
|
|
||||||
defer resp.Body.Close()
|
|
||||||
b, _ := io.ReadAll(resp.Body)
|
|
||||||
return b, resp.StatusCode
|
|
||||||
}
|
|
||||||
|
|
||||||
func getString(t *testing.T, url string) string {
|
|
||||||
t.Helper()
|
|
||||||
b, status := getBody(t, url)
|
|
||||||
if status != http.StatusOK {
|
|
||||||
t.Fatalf("GET %s: status %d: %s", url, status, b)
|
|
||||||
}
|
|
||||||
return string(b)
|
|
||||||
}
|
|
||||||
|
|
||||||
func assertStatus(t *testing.T, url string, wantStatus int) {
|
|
||||||
t.Helper()
|
|
||||||
resp, err := http.Get(url)
|
|
||||||
if err != nil {
|
|
||||||
t.Fatalf("GET %s: %v", url, err)
|
|
||||||
}
|
|
||||||
resp.Body.Close()
|
|
||||||
if resp.StatusCode != wantStatus {
|
|
||||||
t.Errorf("GET %s: got %d, want %d", url, resp.StatusCode, wantStatus)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func deleteRequest(t *testing.T, url string) int {
|
|
||||||
t.Helper()
|
|
||||||
req, _ := http.NewRequest(http.MethodDelete, url, nil)
|
|
||||||
resp, err := http.DefaultClient.Do(req)
|
|
||||||
if err != nil {
|
|
||||||
t.Fatalf("DELETE %s: %v", url, err)
|
|
||||||
}
|
|
||||||
resp.Body.Close()
|
|
||||||
return resp.StatusCode
|
|
||||||
}
|
|
||||||
|
|
||||||
func mustFormat(format string, args ...any) string {
|
|
||||||
return fmt.Sprintf(format, args...)
|
|
||||||
}
|
|
||||||
@@ -1,183 +0,0 @@
|
|||||||
//go:build e2e
|
|
||||||
|
|
||||||
package e2e
|
|
||||||
|
|
||||||
import (
|
|
||||||
"encoding/json"
|
|
||||||
"io"
|
|
||||||
"net/http"
|
|
||||||
"strings"
|
|
||||||
"testing"
|
|
||||||
)
|
|
||||||
|
|
||||||
func TestHealth(t *testing.T) {
|
|
||||||
result := getJSON(t, apiURL("/health"))
|
|
||||||
if result["status"] != "ok" {
|
|
||||||
t.Errorf("expected ok, got %v", result["status"])
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func TestRoot(t *testing.T) {
|
|
||||||
result := getJSON(t, apiURL("/"))
|
|
||||||
if result["name"] != "artifactapi" {
|
|
||||||
t.Errorf("expected artifactapi, got %v", result["name"])
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func TestRemoteUpstreamTimeouts(t *testing.T) {
|
|
||||||
createRemote(t, `{
|
|
||||||
"name": "timeout-test",
|
|
||||||
"package_type": "generic",
|
|
||||||
"base_url": "https://example.com",
|
|
||||||
"stale_on_error": true,
|
|
||||||
"upstream_dial_timeout": 3,
|
|
||||||
"upstream_tls_timeout": 4,
|
|
||||||
"upstream_response_header_timeout": 5
|
|
||||||
}`)
|
|
||||||
defer deleteRemote(t, "timeout-test")
|
|
||||||
|
|
||||||
remote := getJSON(t, apiURL("/api/v2/remotes/timeout-test"))
|
|
||||||
for field, want := range map[string]float64{
|
|
||||||
"upstream_dial_timeout": 3,
|
|
||||||
"upstream_tls_timeout": 4,
|
|
||||||
"upstream_response_header_timeout": 5,
|
|
||||||
} {
|
|
||||||
if got, _ := remote[field].(float64); got != want {
|
|
||||||
t.Errorf("%s: got %v, want %v", field, remote[field], want)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func TestRemoteCRUD(t *testing.T) {
|
|
||||||
createRemote(t, `{
|
|
||||||
"name": "test-generic",
|
|
||||||
"package_type": "generic",
|
|
||||||
"base_url": "https://example.com",
|
|
||||||
"description": "test remote",
|
|
||||||
"mutable_ttl": 600,
|
|
||||||
"check_mutable": true,
|
|
||||||
"stale_on_error": true
|
|
||||||
}`)
|
|
||||||
defer deleteRemote(t, "test-generic")
|
|
||||||
|
|
||||||
remote := getJSON(t, apiURL("/api/v2/remotes/test-generic"))
|
|
||||||
if remote["name"] != "test-generic" {
|
|
||||||
t.Errorf("expected test-generic, got %v", remote["name"])
|
|
||||||
}
|
|
||||||
if remote["package_type"] != "generic" {
|
|
||||||
t.Errorf("expected generic, got %v", remote["package_type"])
|
|
||||||
}
|
|
||||||
|
|
||||||
req, _ := http.NewRequest(http.MethodPut, apiURL("/api/v2/remotes/test-generic"),
|
|
||||||
strings.NewReader(`{
|
|
||||||
"package_type": "generic",
|
|
||||||
"base_url": "https://updated.example.com",
|
|
||||||
"description": "updated",
|
|
||||||
"mutable_ttl": 300,
|
|
||||||
"check_mutable": true,
|
|
||||||
"stale_on_error": true
|
|
||||||
}`))
|
|
||||||
req.Header.Set("Content-Type", "application/json")
|
|
||||||
resp, err := http.DefaultClient.Do(req)
|
|
||||||
if err != nil {
|
|
||||||
t.Fatal(err)
|
|
||||||
}
|
|
||||||
resp.Body.Close()
|
|
||||||
if resp.StatusCode != http.StatusOK {
|
|
||||||
t.Fatalf("update: status %d", resp.StatusCode)
|
|
||||||
}
|
|
||||||
|
|
||||||
updated := getJSON(t, apiURL("/api/v2/remotes/test-generic"))
|
|
||||||
if updated["base_url"] != "https://updated.example.com" {
|
|
||||||
t.Errorf("expected updated URL, got %v", updated["base_url"])
|
|
||||||
}
|
|
||||||
|
|
||||||
status := deleteRequest(t, apiURL("/api/v2/remotes/test-generic"))
|
|
||||||
if status != http.StatusNoContent {
|
|
||||||
t.Errorf("delete: got %d, want 204", status)
|
|
||||||
}
|
|
||||||
|
|
||||||
assertStatus(t, apiURL("/api/v2/remotes/test-generic"), http.StatusNotFound)
|
|
||||||
}
|
|
||||||
|
|
||||||
func TestRemoteList(t *testing.T) {
|
|
||||||
createRemote(t, `{"name":"list-a","package_type":"generic","base_url":"https://a.example.com","stale_on_error":true}`)
|
|
||||||
createRemote(t, `{"name":"list-b","package_type":"helm","base_url":"https://b.example.com","stale_on_error":true}`)
|
|
||||||
defer deleteRemote(t, "list-a")
|
|
||||||
defer deleteRemote(t, "list-b")
|
|
||||||
|
|
||||||
resp, err := http.Get(apiURL("/api/v2/remotes"))
|
|
||||||
if err != nil {
|
|
||||||
t.Fatal(err)
|
|
||||||
}
|
|
||||||
defer resp.Body.Close()
|
|
||||||
body, _ := io.ReadAll(resp.Body)
|
|
||||||
|
|
||||||
var remotes []map[string]any
|
|
||||||
json.Unmarshal(body, &remotes)
|
|
||||||
|
|
||||||
if len(remotes) < 2 {
|
|
||||||
t.Fatalf("expected at least 2 remotes, got %d", len(remotes))
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func TestVirtualCRUD(t *testing.T) {
|
|
||||||
createRemote(t, `{"name":"virt-member-a","package_type":"helm","base_url":"https://a.example.com","stale_on_error":true}`)
|
|
||||||
createRemote(t, `{"name":"virt-member-b","package_type":"helm","base_url":"https://b.example.com","stale_on_error":true}`)
|
|
||||||
defer deleteRemote(t, "virt-member-a")
|
|
||||||
defer deleteRemote(t, "virt-member-b")
|
|
||||||
|
|
||||||
resp, err := http.Post(apiURL("/api/v2/virtuals"), "application/json",
|
|
||||||
strings.NewReader(`{
|
|
||||||
"name": "test-virtual",
|
|
||||||
"package_type": "helm",
|
|
||||||
"description": "test virtual",
|
|
||||||
"members": ["virt-member-a", "virt-member-b"]
|
|
||||||
}`))
|
|
||||||
if err != nil {
|
|
||||||
t.Fatal(err)
|
|
||||||
}
|
|
||||||
resp.Body.Close()
|
|
||||||
if resp.StatusCode != http.StatusCreated {
|
|
||||||
t.Fatalf("create virtual: status %d", resp.StatusCode)
|
|
||||||
}
|
|
||||||
|
|
||||||
virt := getJSON(t, apiURL("/api/v2/virtuals/test-virtual"))
|
|
||||||
if virt["name"] != "test-virtual" {
|
|
||||||
t.Errorf("expected test-virtual, got %v", virt["name"])
|
|
||||||
}
|
|
||||||
|
|
||||||
status := deleteRequest(t, apiURL("/api/v2/virtuals/test-virtual"))
|
|
||||||
if status != http.StatusNoContent {
|
|
||||||
t.Errorf("delete virtual: got %d, want 204", status)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func TestStatsEndpoint(t *testing.T) {
|
|
||||||
result := getJSON(t, apiURL("/api/v2/stats"))
|
|
||||||
if _, ok := result["total_remotes"]; !ok {
|
|
||||||
t.Error("expected total_remotes in stats")
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func TestHealthV2(t *testing.T) {
|
|
||||||
result := getJSON(t, apiURL("/api/v2/health"))
|
|
||||||
if result["status"] != "ok" {
|
|
||||||
t.Errorf("expected ok, got %v", result["status"])
|
|
||||||
}
|
|
||||||
if result["postgres"] != "ok" {
|
|
||||||
t.Errorf("expected postgres ok, got %v", result["postgres"])
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func TestInvalidPackageType(t *testing.T) {
|
|
||||||
resp, err := http.Post(apiURL("/api/v2/remotes"), "application/json",
|
|
||||||
strings.NewReader(`{"name":"bad","package_type":"bogus","base_url":"https://x.com"}`))
|
|
||||||
if err != nil {
|
|
||||||
t.Fatal(err)
|
|
||||||
}
|
|
||||||
resp.Body.Close()
|
|
||||||
if resp.StatusCode != http.StatusBadRequest {
|
|
||||||
t.Errorf("expected 400 for invalid package type, got %d", resp.StatusCode)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,71 +0,0 @@
|
|||||||
//go:build e2e
|
|
||||||
|
|
||||||
package e2e
|
|
||||||
|
|
||||||
import (
|
|
||||||
"net/http"
|
|
||||||
"testing"
|
|
||||||
)
|
|
||||||
|
|
||||||
func TestProxyUnknownRemote(t *testing.T) {
|
|
||||||
assertStatus(t, apiURL("/api/v1/remote/nonexistent/some/path"), http.StatusNotFound)
|
|
||||||
}
|
|
||||||
|
|
||||||
func TestProxyBlocklist(t *testing.T) {
|
|
||||||
createRemote(t, `{
|
|
||||||
"name": "blocklist-test",
|
|
||||||
"package_type": "generic",
|
|
||||||
"base_url": "https://example.com",
|
|
||||||
"blocklist": ["\\.exe$"],
|
|
||||||
"stale_on_error": true
|
|
||||||
}`)
|
|
||||||
defer deleteRemote(t, "blocklist-test")
|
|
||||||
|
|
||||||
assertStatus(t, apiURL("/api/v1/remote/blocklist-test/malware.exe"), http.StatusForbidden)
|
|
||||||
}
|
|
||||||
|
|
||||||
func TestProxyHeadBlocklist(t *testing.T) {
|
|
||||||
createRemote(t, `{
|
|
||||||
"name": "head-block-test",
|
|
||||||
"package_type": "generic",
|
|
||||||
"base_url": "https://example.com",
|
|
||||||
"blocklist": ["\\.exe$"],
|
|
||||||
"stale_on_error": true
|
|
||||||
}`)
|
|
||||||
defer deleteRemote(t, "head-block-test")
|
|
||||||
|
|
||||||
req, _ := http.NewRequest(http.MethodHead, apiURL("/v2/head-block-test/malware.exe"), nil)
|
|
||||||
resp, err := http.DefaultClient.Do(req)
|
|
||||||
if err != nil {
|
|
||||||
t.Fatalf("HEAD: %v", err)
|
|
||||||
}
|
|
||||||
resp.Body.Close()
|
|
||||||
if resp.StatusCode != http.StatusForbidden {
|
|
||||||
t.Fatalf("HEAD blocklisted path: got %d, want 403", resp.StatusCode)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func TestProxyHeadUnknownRemote(t *testing.T) {
|
|
||||||
req, _ := http.NewRequest(http.MethodHead, apiURL("/v2/nonexistent/some/path"), nil)
|
|
||||||
resp, err := http.DefaultClient.Do(req)
|
|
||||||
if err != nil {
|
|
||||||
t.Fatalf("HEAD: %v", err)
|
|
||||||
}
|
|
||||||
resp.Body.Close()
|
|
||||||
if resp.StatusCode != http.StatusNotFound {
|
|
||||||
t.Fatalf("HEAD unknown remote: got %d, want 404", resp.StatusCode)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func TestProxyPatterns(t *testing.T) {
|
|
||||||
createRemote(t, `{
|
|
||||||
"name": "patterns-test",
|
|
||||||
"package_type": "generic",
|
|
||||||
"base_url": "https://example.com",
|
|
||||||
"patterns": ["^releases/"],
|
|
||||||
"stale_on_error": true
|
|
||||||
}`)
|
|
||||||
defer deleteRemote(t, "patterns-test")
|
|
||||||
|
|
||||||
assertStatus(t, apiURL("/api/v1/remote/patterns-test/uploads/file.tar.gz"), http.StatusForbidden)
|
|
||||||
}
|
|
||||||
@@ -1,111 +0,0 @@
|
|||||||
module git.unkin.net/unkin/artifactapi
|
|
||||||
|
|
||||||
go 1.25.9
|
|
||||||
|
|
||||||
require (
|
|
||||||
git.unkin.net/unkin/golib v0.1.0
|
|
||||||
github.com/cavaliergopher/rpm v1.3.0
|
|
||||||
github.com/charmbracelet/bubbletea v1.3.10
|
|
||||||
github.com/charmbracelet/lipgloss v1.1.0
|
|
||||||
github.com/coreos/go-oidc/v3 v3.21.0
|
|
||||||
github.com/go-chi/chi/v5 v5.3.0
|
|
||||||
github.com/go-jose/go-jose/v4 v4.1.4
|
|
||||||
github.com/google/uuid v1.6.0
|
|
||||||
github.com/jackc/pgx/v5 v5.10.0
|
|
||||||
github.com/klauspost/compress v1.19.2
|
|
||||||
github.com/minio/minio-go/v7 v7.2.0
|
|
||||||
github.com/redis/go-redis/v9 v9.20.0
|
|
||||||
github.com/testcontainers/testcontainers-go v0.44.0
|
|
||||||
github.com/testcontainers/testcontainers-go/modules/postgres v0.44.0
|
|
||||||
github.com/testcontainers/testcontainers-go/modules/redis v0.42.0
|
|
||||||
github.com/ulikunitz/xz v0.5.16
|
|
||||||
golang.org/x/crypto v0.54.0
|
|
||||||
golang.org/x/sync v0.22.0
|
|
||||||
golang.org/x/time v0.15.0
|
|
||||||
gopkg.in/yaml.v3 v3.0.1
|
|
||||||
)
|
|
||||||
|
|
||||||
require (
|
|
||||||
dario.cat/mergo v1.0.2 // indirect
|
|
||||||
github.com/Azure/go-ansiterm v0.0.0-20250102033503-faa5f7b0171c // indirect
|
|
||||||
github.com/Microsoft/go-winio v0.6.2 // indirect
|
|
||||||
github.com/aymanbagabas/go-osc52/v2 v2.0.1 // indirect
|
|
||||||
github.com/cenkalti/backoff/v4 v4.3.0 // indirect
|
|
||||||
github.com/cespare/xxhash/v2 v2.3.0 // indirect
|
|
||||||
github.com/charmbracelet/colorprofile v0.4.3 // indirect
|
|
||||||
github.com/charmbracelet/x/ansi v0.11.7 // indirect
|
|
||||||
github.com/charmbracelet/x/cellbuf v0.0.15 // indirect
|
|
||||||
github.com/charmbracelet/x/term v0.2.2 // indirect
|
|
||||||
github.com/clipperhouse/displaywidth v0.11.0 // indirect
|
|
||||||
github.com/clipperhouse/uax29/v2 v2.7.0 // indirect
|
|
||||||
github.com/containerd/errdefs v1.0.0 // indirect
|
|
||||||
github.com/containerd/errdefs/pkg v0.3.0 // indirect
|
|
||||||
github.com/containerd/log v0.1.0 // indirect
|
|
||||||
github.com/containerd/platforms v0.2.1 // indirect
|
|
||||||
github.com/cpuguy83/dockercfg v0.3.2 // indirect
|
|
||||||
github.com/davecgh/go-spew v1.1.1 // indirect
|
|
||||||
github.com/distribution/reference v0.6.0 // indirect
|
|
||||||
github.com/docker/go-connections v0.7.0 // indirect
|
|
||||||
github.com/docker/go-units v0.5.0 // indirect
|
|
||||||
github.com/dustin/go-humanize v1.0.1 // indirect
|
|
||||||
github.com/ebitengine/purego v0.10.1 // indirect
|
|
||||||
github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f // indirect
|
|
||||||
github.com/felixge/httpsnoop v1.1.0 // indirect
|
|
||||||
github.com/go-logr/logr v1.4.3 // indirect
|
|
||||||
github.com/go-logr/stdr v1.2.2 // indirect
|
|
||||||
github.com/go-ole/go-ole v1.3.0 // indirect
|
|
||||||
github.com/jackc/pgpassfile v1.0.0 // indirect
|
|
||||||
github.com/jackc/pgservicefile v0.0.0-20240606120523-5a60cdf6a761 // indirect
|
|
||||||
github.com/jackc/puddle/v2 v2.2.2 // indirect
|
|
||||||
github.com/klauspost/cpuid/v2 v2.2.11 // indirect
|
|
||||||
github.com/klauspost/crc32 v1.3.0 // indirect
|
|
||||||
github.com/lucasb-eyer/go-colorful v1.4.0 // indirect
|
|
||||||
github.com/lufia/plan9stats v0.0.0-20260330125221-c963978e514e // indirect
|
|
||||||
github.com/magiconair/properties v1.8.10 // indirect
|
|
||||||
github.com/mattn/go-isatty v0.0.20 // indirect
|
|
||||||
github.com/mattn/go-localereader v0.0.1 // indirect
|
|
||||||
github.com/mattn/go-runewidth v0.0.23 // indirect
|
|
||||||
github.com/mdelapenya/tlscert v0.2.0 // indirect
|
|
||||||
github.com/minio/crc64nvme v1.1.1 // indirect
|
|
||||||
github.com/minio/md5-simd v1.1.2 // indirect
|
|
||||||
github.com/moby/docker-image-spec v1.3.1 // indirect
|
|
||||||
github.com/moby/go-archive v0.2.0 // indirect
|
|
||||||
github.com/moby/moby/api v1.55.0 // indirect
|
|
||||||
github.com/moby/moby/client v0.5.0 // indirect
|
|
||||||
github.com/moby/patternmatcher v0.6.1 // indirect
|
|
||||||
github.com/moby/sys/sequential v0.7.0 // indirect
|
|
||||||
github.com/moby/sys/user v0.4.0 // indirect
|
|
||||||
github.com/moby/sys/userns v0.1.0 // indirect
|
|
||||||
github.com/moby/term v0.5.2 // indirect
|
|
||||||
github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6 // indirect
|
|
||||||
github.com/muesli/cancelreader v0.2.2 // indirect
|
|
||||||
github.com/muesli/termenv v0.16.0 // indirect
|
|
||||||
github.com/opencontainers/go-digest v1.0.0 // indirect
|
|
||||||
github.com/opencontainers/image-spec v1.1.1 // indirect
|
|
||||||
github.com/philhofer/fwd v1.2.0 // indirect
|
|
||||||
github.com/pmezard/go-difflib v1.0.0 // indirect
|
|
||||||
github.com/power-devops/perfstat v0.0.0-20240221224432-82ca36839d55 // indirect
|
|
||||||
github.com/rivo/uniseg v0.4.7 // indirect
|
|
||||||
github.com/rs/xid v1.6.0 // indirect
|
|
||||||
github.com/shirou/gopsutil/v4 v4.26.6 // indirect
|
|
||||||
github.com/sirupsen/logrus v1.9.4 // indirect
|
|
||||||
github.com/stretchr/testify v1.11.1 // indirect
|
|
||||||
github.com/tinylib/msgp v1.6.1 // indirect
|
|
||||||
github.com/tklauser/go-sysconf v0.4.0 // indirect
|
|
||||||
github.com/tklauser/numcpus v0.12.0 // indirect
|
|
||||||
github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e // indirect
|
|
||||||
github.com/yusufpapurcu/wmi v1.2.4 // indirect
|
|
||||||
github.com/zeebo/xxh3 v1.1.0 // indirect
|
|
||||||
go.opentelemetry.io/auto/sdk v1.2.1 // indirect
|
|
||||||
go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.69.0 // indirect
|
|
||||||
go.opentelemetry.io/otel v1.44.0 // indirect
|
|
||||||
go.opentelemetry.io/otel/metric v1.44.0 // indirect
|
|
||||||
go.opentelemetry.io/otel/trace v1.44.0 // indirect
|
|
||||||
go.uber.org/atomic v1.11.0 // indirect
|
|
||||||
go.yaml.in/yaml/v3 v3.0.4 // indirect
|
|
||||||
golang.org/x/net v0.56.0 // indirect
|
|
||||||
golang.org/x/oauth2 v0.36.0 // indirect
|
|
||||||
golang.org/x/sys v0.47.0 // indirect
|
|
||||||
golang.org/x/text v0.40.0 // indirect
|
|
||||||
gopkg.in/ini.v1 v1.67.2 // indirect
|
|
||||||
)
|
|
||||||
@@ -1,261 +0,0 @@
|
|||||||
dario.cat/mergo v1.0.2 h1:85+piFYR1tMbRrLcDwR18y4UKJ3aH1Tbzi24VRW1TK8=
|
|
||||||
dario.cat/mergo v1.0.2/go.mod h1:E/hbnu0NxMFBjpMIE34DRGLWqDy0g5FuKDhCb31ngxA=
|
|
||||||
git.unkin.net/unkin/golib v0.1.0 h1:OjKT5TO7PuXiYQ/1A+I4S2VZ/IsAxXY1reGWwasDMqE=
|
|
||||||
git.unkin.net/unkin/golib v0.1.0/go.mod h1:1e3PpMLEfa03Re/6tlk+I2XPWzBQMSpw2MB+Aw2lkX4=
|
|
||||||
github.com/AdaLogics/go-fuzz-headers v0.0.0-20240806141605-e8a1dd7889d6 h1:He8afgbRMd7mFxO99hRNu+6tazq8nFF9lIwo9JFroBk=
|
|
||||||
github.com/AdaLogics/go-fuzz-headers v0.0.0-20240806141605-e8a1dd7889d6/go.mod h1:8o94RPi1/7XTJvwPpRSzSUedZrtlirdB3r9Z20bi2f8=
|
|
||||||
github.com/Azure/go-ansiterm v0.0.0-20250102033503-faa5f7b0171c h1:udKWzYgxTojEKWjV8V+WSxDXJ4NFATAsZjh8iIbsQIg=
|
|
||||||
github.com/Azure/go-ansiterm v0.0.0-20250102033503-faa5f7b0171c/go.mod h1:xomTg63KZ2rFqZQzSB4Vz2SUXa1BpHTVz9L5PTmPC4E=
|
|
||||||
github.com/Microsoft/go-winio v0.6.2 h1:F2VQgta7ecxGYO8k3ZZz3RS8fVIXVxONVUPlNERoyfY=
|
|
||||||
github.com/Microsoft/go-winio v0.6.2/go.mod h1:yd8OoFMLzJbo9gZq8j5qaps8bJ9aShtEA8Ipt1oGCvU=
|
|
||||||
github.com/aymanbagabas/go-osc52/v2 v2.0.1 h1:HwpRHbFMcZLEVr42D4p7XBqjyuxQH5SMiErDT4WkJ2k=
|
|
||||||
github.com/aymanbagabas/go-osc52/v2 v2.0.1/go.mod h1:uYgXzlJ7ZpABp8OJ+exZzJJhRNQ2ASbcXHWsFqH8hp8=
|
|
||||||
github.com/bsm/ginkgo/v2 v2.12.0 h1:Ny8MWAHyOepLGlLKYmXG4IEkioBysk6GpaRTLC8zwWs=
|
|
||||||
github.com/bsm/ginkgo/v2 v2.12.0/go.mod h1:SwYbGRRDovPVboqFv0tPTcG1sN61LM1Z4ARdbAV9g4c=
|
|
||||||
github.com/bsm/gomega v1.27.10 h1:yeMWxP2pV2fG3FgAODIY8EiRE3dy0aeFYt4l7wh6yKA=
|
|
||||||
github.com/bsm/gomega v1.27.10/go.mod h1:JyEr/xRbxbtgWNi8tIEVPUYZ5Dzef52k01W3YH0H+O0=
|
|
||||||
github.com/cavaliergopher/rpm v1.3.0 h1:UHX46sasX8MesUXXQ+UbkFLUX4eUWTlEcX8jcnRBIgI=
|
|
||||||
github.com/cavaliergopher/rpm v1.3.0/go.mod h1:vEumo1vvtrHM1Ov86f6+k8j7zNKOxQfHDCAIcR/36ZI=
|
|
||||||
github.com/cenkalti/backoff/v4 v4.3.0 h1:MyRJ/UdXutAwSAT+s3wNd7MfTIcy71VQueUuFK343L8=
|
|
||||||
github.com/cenkalti/backoff/v4 v4.3.0/go.mod h1:Y3VNntkOUPxTVeUxJ/G5vcM//AlwfmyYozVcomhLiZE=
|
|
||||||
github.com/cespare/xxhash/v2 v2.3.0 h1:UL815xU9SqsFlibzuggzjXhog7bL6oX9BbNZnL2UFvs=
|
|
||||||
github.com/cespare/xxhash/v2 v2.3.0/go.mod h1:VGX0DQ3Q6kWi7AoAeZDth3/j3BFtOZR5XLFGgcrjCOs=
|
|
||||||
github.com/charmbracelet/bubbletea v1.3.10 h1:otUDHWMMzQSB0Pkc87rm691KZ3SWa4KUlvF9nRvCICw=
|
|
||||||
github.com/charmbracelet/bubbletea v1.3.10/go.mod h1:ORQfo0fk8U+po9VaNvnV95UPWA1BitP1E0N6xJPlHr4=
|
|
||||||
github.com/charmbracelet/colorprofile v0.4.3 h1:QPa1IWkYI+AOB+fE+mg/5/4HRMZcaXex9t5KX76i20Q=
|
|
||||||
github.com/charmbracelet/colorprofile v0.4.3/go.mod h1:/zT4BhpD5aGFpqQQqw7a+VtHCzu+zrQtt1zhMt9mR4Q=
|
|
||||||
github.com/charmbracelet/lipgloss v1.1.0 h1:vYXsiLHVkK7fp74RkV7b2kq9+zDLoEU4MZoFqR/noCY=
|
|
||||||
github.com/charmbracelet/lipgloss v1.1.0/go.mod h1:/6Q8FR2o+kj8rz4Dq0zQc3vYf7X+B0binUUBwA0aL30=
|
|
||||||
github.com/charmbracelet/x/ansi v0.11.7 h1:kzv1kJvjg2S3r9KHo8hDdHFQLEqn4RBCb39dAYC84jI=
|
|
||||||
github.com/charmbracelet/x/ansi v0.11.7/go.mod h1:9qGpnAVYz+8ACONkZBUWPtL7lulP9No6p1epAihUZwQ=
|
|
||||||
github.com/charmbracelet/x/cellbuf v0.0.15 h1:ur3pZy0o6z/R7EylET877CBxaiE1Sp1GMxoFPAIztPI=
|
|
||||||
github.com/charmbracelet/x/cellbuf v0.0.15/go.mod h1:J1YVbR7MUuEGIFPCaaZ96KDl5NoS0DAWkskup+mOY+Q=
|
|
||||||
github.com/charmbracelet/x/term v0.2.2 h1:xVRT/S2ZcKdhhOuSP4t5cLi5o+JxklsoEObBSgfgZRk=
|
|
||||||
github.com/charmbracelet/x/term v0.2.2/go.mod h1:kF8CY5RddLWrsgVwpw4kAa6TESp6EB5y3uxGLeCqzAI=
|
|
||||||
github.com/clipperhouse/displaywidth v0.11.0 h1:lBc6kY44VFw+TDx4I8opi/EtL9m20WSEFgwIwO+UVM8=
|
|
||||||
github.com/clipperhouse/displaywidth v0.11.0/go.mod h1:bkrFNkf81G8HyVqmKGxsPufD3JhNl3dSqnGhOoSD/o0=
|
|
||||||
github.com/clipperhouse/uax29/v2 v2.7.0 h1:+gs4oBZ2gPfVrKPthwbMzWZDaAFPGYK72F0NJv2v7Vk=
|
|
||||||
github.com/clipperhouse/uax29/v2 v2.7.0/go.mod h1:EFJ2TJMRUaplDxHKj1qAEhCtQPW2tJSwu5BF98AuoVM=
|
|
||||||
github.com/containerd/errdefs v1.0.0 h1:tg5yIfIlQIrxYtu9ajqY42W3lpS19XqdxRQeEwYG8PI=
|
|
||||||
github.com/containerd/errdefs v1.0.0/go.mod h1:+YBYIdtsnF4Iw6nWZhJcqGSg/dwvV7tyJ/kCkyJ2k+M=
|
|
||||||
github.com/containerd/errdefs/pkg v0.3.0 h1:9IKJ06FvyNlexW690DXuQNx2KA2cUJXx151Xdx3ZPPE=
|
|
||||||
github.com/containerd/errdefs/pkg v0.3.0/go.mod h1:NJw6s9HwNuRhnjJhM7pylWwMyAkmCQvQ4GpJHEqRLVk=
|
|
||||||
github.com/containerd/log v0.1.0 h1:TCJt7ioM2cr/tfR8GPbGf9/VRAX8D2B4PjzCpfX540I=
|
|
||||||
github.com/containerd/log v0.1.0/go.mod h1:VRRf09a7mHDIRezVKTRCrOq78v577GXq3bSa3EhrzVo=
|
|
||||||
github.com/containerd/platforms v0.2.1 h1:zvwtM3rz2YHPQsF2CHYM8+KtB5dvhISiXh5ZpSBQv6A=
|
|
||||||
github.com/containerd/platforms v0.2.1/go.mod h1:XHCb+2/hzowdiut9rkudds9bE5yJ7npe7dG/wG+uFPw=
|
|
||||||
github.com/coreos/go-oidc/v3 v3.21.0 h1:wZo4Q9Pum8dYEj0eMUPrqR+kvuGkeUplbLpNCkBqoWM=
|
|
||||||
github.com/coreos/go-oidc/v3 v3.21.0/go.mod h1:DYCf24+ncYi+XkIH97GY1+dqoRlbaSI26KVTCI9SrY4=
|
|
||||||
github.com/cpuguy83/dockercfg v0.3.2 h1:DlJTyZGBDlXqUZ2Dk2Q3xHs/FtnooJJVaad2S9GKorA=
|
|
||||||
github.com/cpuguy83/dockercfg v0.3.2/go.mod h1:sugsbF4//dDlL/i+S+rtpIWp+5h0BHJHfjj5/jFyUJc=
|
|
||||||
github.com/creack/pty v1.1.24 h1:bJrF4RRfyJnbTJqzRLHzcGaZK1NeM5kTC9jGgovnR1s=
|
|
||||||
github.com/creack/pty v1.1.24/go.mod h1:08sCNb52WyoAwi2QDyzUCTgcvVFhUzewun7wtTfvcwE=
|
|
||||||
github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
|
|
||||||
github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
|
|
||||||
github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
|
|
||||||
github.com/distribution/reference v0.6.0 h1:0IXCQ5g4/QMHHkarYzh5l+u8T3t73zM5QvfrDyIgxBk=
|
|
||||||
github.com/distribution/reference v0.6.0/go.mod h1:BbU0aIcezP1/5jX/8MP0YiH4SdvB5Y4f/wlDRiLyi3E=
|
|
||||||
github.com/docker/go-connections v0.7.0 h1:6SsRfJddP22WMrCkj19x9WKjEDTB+ahsdiGYf0mN39c=
|
|
||||||
github.com/docker/go-connections v0.7.0/go.mod h1:no1qkHdjq7kLMGUXYAduOhYPSJxxvgWBh7ogVvptn3Q=
|
|
||||||
github.com/docker/go-units v0.5.0 h1:69rxXcBk27SvSaaxTtLh/8llcHD8vYHT7WSdRZ/jvr4=
|
|
||||||
github.com/docker/go-units v0.5.0/go.mod h1:fgPhTUdO+D/Jk86RDLlptpiXQzgHJF7gydDDbaIK4Dk=
|
|
||||||
github.com/dustin/go-humanize v1.0.1 h1:GzkhY7T5VNhEkwH0PVJgjz+fX1rhBrR7pRT3mDkpeCY=
|
|
||||||
github.com/dustin/go-humanize v1.0.1/go.mod h1:Mu1zIs6XwVuF/gI1OepvI0qD18qycQx+mFykh5fBlto=
|
|
||||||
github.com/ebitengine/purego v0.10.1 h1:dewVBCBT2GaMu1SrNTYxQhgQBethzfhiwvZiLGP/qyY=
|
|
||||||
github.com/ebitengine/purego v0.10.1/go.mod h1:iIjxzd6CiRiOG0UyXP+V1+jWqUXVjPKLAI0mRfJZTmQ=
|
|
||||||
github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f h1:Y/CXytFA4m6baUTXGLOoWe4PQhGxaX0KpnayAqC48p4=
|
|
||||||
github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f/go.mod h1:vw97MGsxSvLiUE2X8qFplwetxpGLQrlU1Q9AUEIzCaM=
|
|
||||||
github.com/felixge/httpsnoop v1.1.0 h1:3YtUj32ZZkqZtt3sZZsClsymw/QDuVfpNhoA31zeORc=
|
|
||||||
github.com/felixge/httpsnoop v1.1.0/go.mod h1:Zqxgdd+1Rkcz8euOqdr7lqgCRJztwr5hp9vDSi5UZCE=
|
|
||||||
github.com/go-chi/chi/v5 v5.3.0 h1:halUjDxhshgXHMrao5bB8eNBXo/rnzwr8m5m36glehM=
|
|
||||||
github.com/go-chi/chi/v5 v5.3.0/go.mod h1:R+tYY2hNuVUUjxoPtqUdgBqevM9s9njzkTLutVsOCto=
|
|
||||||
github.com/go-jose/go-jose/v4 v4.1.4 h1:moDMcTHmvE6Groj34emNPLs/qtYXRVcd6S7NHbHz3kA=
|
|
||||||
github.com/go-jose/go-jose/v4 v4.1.4/go.mod h1:x4oUasVrzR7071A4TnHLGSPpNOm2a21K9Kf04k1rs08=
|
|
||||||
github.com/go-logr/logr v1.2.2/go.mod h1:jdQByPbusPIv2/zmleS9BjJVeZ6kBagPoEUsqbVz/1A=
|
|
||||||
github.com/go-logr/logr v1.4.3 h1:CjnDlHq8ikf6E492q6eKboGOC0T8CDaOvkHCIg8idEI=
|
|
||||||
github.com/go-logr/logr v1.4.3/go.mod h1:9T104GzyrTigFIr8wt5mBrctHMim0Nb2HLGrmQ40KvY=
|
|
||||||
github.com/go-logr/stdr v1.2.2 h1:hSWxHoqTgW2S2qGc0LTAI563KZ5YKYRhT3MFKZMbjag=
|
|
||||||
github.com/go-logr/stdr v1.2.2/go.mod h1:mMo/vtBO5dYbehREoey6XUKy/eSumjCCveDpRre4VKE=
|
|
||||||
github.com/go-ole/go-ole v1.2.6/go.mod h1:pprOEPIfldk/42T2oK7lQ4v4JSDwmV0As9GaiUsvbm0=
|
|
||||||
github.com/go-ole/go-ole v1.3.0 h1:Dt6ye7+vXGIKZ7Xtk4s6/xVdGDQynvom7xCFEdWr6uE=
|
|
||||||
github.com/go-ole/go-ole v1.3.0/go.mod h1:5LS6F96DhAwUc7C+1HLexzMXY1xGRSryjyPPKW6zv78=
|
|
||||||
github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
|
|
||||||
github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
|
|
||||||
github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0=
|
|
||||||
github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
|
|
||||||
github.com/jackc/pgpassfile v1.0.0 h1:/6Hmqy13Ss2zCq62VdNG8tM1wchn8zjSGOBJ6icpsIM=
|
|
||||||
github.com/jackc/pgpassfile v1.0.0/go.mod h1:CEx0iS5ambNFdcRtxPj5JhEz+xB6uRky5eyVu/W2HEg=
|
|
||||||
github.com/jackc/pgservicefile v0.0.0-20240606120523-5a60cdf6a761 h1:iCEnooe7UlwOQYpKFhBabPMi4aNAfoODPEFNiAnClxo=
|
|
||||||
github.com/jackc/pgservicefile v0.0.0-20240606120523-5a60cdf6a761/go.mod h1:5TJZWKEWniPve33vlWYSoGYefn3gLQRzjfDlhSJ9ZKM=
|
|
||||||
github.com/jackc/pgx/v5 v5.10.0 h1:VhSvgU2jSli8o3AqIEOTJr7rZwAEUVo4E4XhR94Zfr0=
|
|
||||||
github.com/jackc/pgx/v5 v5.10.0/go.mod h1:mal1tBGAFfLHvZzaYh77YS/eC6IX9OWbRV1QIIM0Jn4=
|
|
||||||
github.com/jackc/puddle/v2 v2.2.2 h1:PR8nw+E/1w0GLuRFSmiioY6UooMp6KJv0/61nB7icHo=
|
|
||||||
github.com/jackc/puddle/v2 v2.2.2/go.mod h1:vriiEXHvEE654aYKXXjOvZM39qJ0q+azkZFrfEOc3H4=
|
|
||||||
github.com/klauspost/compress v1.19.2 h1:hMRETovs/pu/dVWN7zIT1PGG8t509MwT6bO7XSi26R8=
|
|
||||||
github.com/klauspost/compress v1.19.2/go.mod h1:cwPg85FWrGar70rWktvGQj8/hthj3wpl0PGDogxkrSQ=
|
|
||||||
github.com/klauspost/cpuid/v2 v2.0.1/go.mod h1:FInQzS24/EEf25PyTYn52gqo7WaD8xa0213Md/qVLRg=
|
|
||||||
github.com/klauspost/cpuid/v2 v2.2.11 h1:0OwqZRYI2rFrjS4kvkDnqJkKHdHaRnCm68/DY4OxRzU=
|
|
||||||
github.com/klauspost/cpuid/v2 v2.2.11/go.mod h1:hqwkgyIinND0mEev00jJYCxPNVRVXFQeu1XKlok6oO0=
|
|
||||||
github.com/klauspost/crc32 v1.3.0 h1:sSmTt3gUt81RP655XGZPElI0PelVTZ6YwCRnPSupoFM=
|
|
||||||
github.com/klauspost/crc32 v1.3.0/go.mod h1:D7kQaZhnkX/Y0tstFGf8VUzv2UofNGqCjnC3zdHB0Hw=
|
|
||||||
github.com/kr/pretty v0.3.1 h1:flRD4NNwYAUpkphVc1HcthR4KEIFJ65n8Mw5qdRn3LE=
|
|
||||||
github.com/kr/pretty v0.3.1/go.mod h1:hoEshYVHaxMs3cyo3Yncou5ZscifuDolrwPKZanG3xk=
|
|
||||||
github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY=
|
|
||||||
github.com/kr/text v0.2.0/go.mod h1:eLer722TekiGuMkidMxC/pM04lWEeraHUUmBw8l2grE=
|
|
||||||
github.com/lib/pq v1.10.9 h1:YXG7RB+JIjhP29X+OtkiDnYaXQwpS4JEWq7dtCCRUEw=
|
|
||||||
github.com/lib/pq v1.10.9/go.mod h1:AlVN5x4E4T544tWzH6hKfbfQvm3HdbOxrmggDNAPY9o=
|
|
||||||
github.com/lucasb-eyer/go-colorful v1.4.0 h1:UtrWVfLdarDgc44HcS7pYloGHJUjHV/4FwW4TvVgFr4=
|
|
||||||
github.com/lucasb-eyer/go-colorful v1.4.0/go.mod h1:R4dSotOR9KMtayYi1e77YzuveK+i7ruzyGqttikkLy0=
|
|
||||||
github.com/lufia/plan9stats v0.0.0-20260330125221-c963978e514e h1:Q6MvJtQK/iRcRtzAscm/zF23XxJlbECiGPyRicsX+Ak=
|
|
||||||
github.com/lufia/plan9stats v0.0.0-20260330125221-c963978e514e/go.mod h1:autxFIvghDt3jPTLoqZ9OZ7s9qTGNAWmYCjVFWPX/zg=
|
|
||||||
github.com/magiconair/properties v1.8.10 h1:s31yESBquKXCV9a/ScB3ESkOjUYYv+X0rg8SYxI99mE=
|
|
||||||
github.com/magiconair/properties v1.8.10/go.mod h1:Dhd985XPs7jluiymwWYZ0G4Z61jb3vdS329zhj2hYo0=
|
|
||||||
github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY=
|
|
||||||
github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
|
|
||||||
github.com/mattn/go-localereader v0.0.1 h1:ygSAOl7ZXTx4RdPYinUpg6W99U8jWvWi9Ye2JC/oIi4=
|
|
||||||
github.com/mattn/go-localereader v0.0.1/go.mod h1:8fBrzywKY7BI3czFoHkuzRoWE9C+EiG4R1k4Cjx5p88=
|
|
||||||
github.com/mattn/go-runewidth v0.0.23 h1:7ykA0T0jkPpzSvMS5i9uoNn2Xy3R383f9HDx3RybWcw=
|
|
||||||
github.com/mattn/go-runewidth v0.0.23/go.mod h1:XBkDxAl56ILZc9knddidhrOlY5R/pDhgLpndooCuJAs=
|
|
||||||
github.com/mdelapenya/tlscert v0.2.0 h1:7H81W6Z/4weDvZBNOfQte5GpIMo0lGYEeWbkGp5LJHI=
|
|
||||||
github.com/mdelapenya/tlscert v0.2.0/go.mod h1:O4njj3ELLnJjGdkN7M/vIVCpZ+Cf0L6muqOG4tLSl8o=
|
|
||||||
github.com/minio/crc64nvme v1.1.1 h1:8dwx/Pz49suywbO+auHCBpCtlW1OfpcLN7wYgVR6wAI=
|
|
||||||
github.com/minio/crc64nvme v1.1.1/go.mod h1:eVfm2fAzLlxMdUGc0EEBGSMmPwmXD5XiNRpnu9J3bvg=
|
|
||||||
github.com/minio/md5-simd v1.1.2 h1:Gdi1DZK69+ZVMoNHRXJyNcxrMA4dSxoYHZSQbirFg34=
|
|
||||||
github.com/minio/md5-simd v1.1.2/go.mod h1:MzdKDxYpY2BT9XQFocsiZf/NKVtR7nkE4RoEpN+20RM=
|
|
||||||
github.com/minio/minio-go/v7 v7.2.0 h1:RCJM0R1XOsRs+A3x3UCaf3ZYbByDaLjFeAi+YCQEPhs=
|
|
||||||
github.com/minio/minio-go/v7 v7.2.0/go.mod h1:EU9hENAStx/xXduNdrGO5e4X5vk19NtgB+RIPjZO8o0=
|
|
||||||
github.com/moby/docker-image-spec v1.3.1 h1:jMKff3w6PgbfSa69GfNg+zN/XLhfXJGnEx3Nl2EsFP0=
|
|
||||||
github.com/moby/docker-image-spec v1.3.1/go.mod h1:eKmb5VW8vQEh/BAr2yvVNvuiJuY6UIocYsFu/DxxRpo=
|
|
||||||
github.com/moby/go-archive v0.2.0 h1:zg5QDUM2mi0JIM9fdQZWC7U8+2ZfixfTYoHL7rWUcP8=
|
|
||||||
github.com/moby/go-archive v0.2.0/go.mod h1:mNeivT14o8xU+5q1YnNrkQVpK+dnNe/K6fHqnTg4qPU=
|
|
||||||
github.com/moby/moby/api v1.55.0 h1:2/sexvQyqIWS8pRSCFddBfpW2qE7vR7FCL+vN8pxwMc=
|
|
||||||
github.com/moby/moby/api v1.55.0/go.mod h1:+RQ6wluLwtYaTd1WnPLykIDPekkuyD/ROWQClE83pzs=
|
|
||||||
github.com/moby/moby/client v0.5.0 h1:5XhyPk2fuOWf6RlSFa3MkIIgDZkF25xToXW8Q/BH7cc=
|
|
||||||
github.com/moby/moby/client v0.5.0/go.mod h1:rcVpF8ncl9vo5gaIBdol6CnbEtSj1uxMvEV/UrykF/s=
|
|
||||||
github.com/moby/patternmatcher v0.6.1 h1:qlhtafmr6kgMIJjKJMDmMWq7WLkKIo23hsrpR3x084U=
|
|
||||||
github.com/moby/patternmatcher v0.6.1/go.mod h1:hDPoyOpDY7OrrMDLaYoY3hf52gNCR/YOUYxkhApJIxc=
|
|
||||||
github.com/moby/sys/sequential v0.7.0 h1:ASQNGNROJSuOO6LL6bPHbKvuZu6NU8P4ldPWk31zj/8=
|
|
||||||
github.com/moby/sys/sequential v0.7.0/go.mod h1:NfSTAp6V3fw4tmkD62PEcOKeZKquXT8VKCkf7aVR79o=
|
|
||||||
github.com/moby/sys/user v0.4.0 h1:jhcMKit7SA80hivmFJcbB1vqmw//wU61Zdui2eQXuMs=
|
|
||||||
github.com/moby/sys/user v0.4.0/go.mod h1:bG+tYYYJgaMtRKgEmuueC0hJEAZWwtIbZTB+85uoHjs=
|
|
||||||
github.com/moby/sys/userns v0.1.0 h1:tVLXkFOxVu9A64/yh59slHVv9ahO9UIev4JZusOLG/g=
|
|
||||||
github.com/moby/sys/userns v0.1.0/go.mod h1:IHUYgu/kao6N8YZlp9Cf444ySSvCmDlmzUcYfDHOl28=
|
|
||||||
github.com/moby/term v0.5.2 h1:6qk3FJAFDs6i/q3W/pQ97SX192qKfZgGjCQqfCJkgzQ=
|
|
||||||
github.com/moby/term v0.5.2/go.mod h1:d3djjFCrjnB+fl8NJux+EJzu0msscUP+f8it8hPkFLc=
|
|
||||||
github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6 h1:ZK8zHtRHOkbHy6Mmr5D264iyp3TiX5OmNcI5cIARiQI=
|
|
||||||
github.com/muesli/ansi v0.0.0-20230316100256-276c6243b2f6/go.mod h1:CJlz5H+gyd6CUWT45Oy4q24RdLyn7Md9Vj2/ldJBSIo=
|
|
||||||
github.com/muesli/cancelreader v0.2.2 h1:3I4Kt4BQjOR54NavqnDogx/MIoWBFa0StPA8ELUXHmA=
|
|
||||||
github.com/muesli/cancelreader v0.2.2/go.mod h1:3XuTXfFS2VjM+HTLZY9Ak0l6eUKfijIfMUZ4EgX0QYo=
|
|
||||||
github.com/muesli/termenv v0.16.0 h1:S5AlUN9dENB57rsbnkPyfdGuWIlkmzJjbFf0Tf5FWUc=
|
|
||||||
github.com/muesli/termenv v0.16.0/go.mod h1:ZRfOIKPFDYQoDFF4Olj7/QJbW60Ol/kL1pU3VfY/Cnk=
|
|
||||||
github.com/opencontainers/go-digest v1.0.0 h1:apOUWs51W5PlhuyGyz9FCeeBIOUDA/6nW8Oi/yOhh5U=
|
|
||||||
github.com/opencontainers/go-digest v1.0.0/go.mod h1:0JzlMkj0TRzQZfJkVvzbP0HBR3IKzErnv2BNG4W4MAM=
|
|
||||||
github.com/opencontainers/image-spec v1.1.1 h1:y0fUlFfIZhPF1W537XOLg0/fcx6zcHCJwooC2xJA040=
|
|
||||||
github.com/opencontainers/image-spec v1.1.1/go.mod h1:qpqAh3Dmcf36wStyyWU+kCeDgrGnAve2nCC8+7h8Q0M=
|
|
||||||
github.com/philhofer/fwd v1.2.0 h1:e6DnBTl7vGY+Gz322/ASL4Gyp1FspeMvx1RNDoToZuM=
|
|
||||||
github.com/philhofer/fwd v1.2.0/go.mod h1:RqIHx9QI14HlwKwm98g9Re5prTQ6LdeRQn+gXJFxsJM=
|
|
||||||
github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
|
|
||||||
github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
|
|
||||||
github.com/power-devops/perfstat v0.0.0-20240221224432-82ca36839d55 h1:o4JXh1EVt9k/+g42oCprj/FisM4qX9L3sZB3upGN2ZU=
|
|
||||||
github.com/power-devops/perfstat v0.0.0-20240221224432-82ca36839d55/go.mod h1:OmDBASR4679mdNQnz2pUhc2G8CO2JrUAVFDRBDP/hJE=
|
|
||||||
github.com/redis/go-redis/v9 v9.20.0 h1:WnQYxLkgO2xiXTCJY0ldIiI8dNqCDlQAG+AtaH7a2a0=
|
|
||||||
github.com/redis/go-redis/v9 v9.20.0/go.mod h1:v/M13XI1PVCDcm01VtPFOADfZtHf8YW3baQf57KlIkA=
|
|
||||||
github.com/rivo/uniseg v0.4.7 h1:WUdvkW8uEhrYfLC4ZzdpI2ztxP1I582+49Oc5Mq64VQ=
|
|
||||||
github.com/rivo/uniseg v0.4.7/go.mod h1:FN3SvrM+Zdj16jyLfmOkMNblXMcoc8DfTHruCPUcx88=
|
|
||||||
github.com/rogpeppe/go-internal v1.14.1 h1:UQB4HGPB6osV0SQTLymcB4TgvyWu6ZyliaW0tI/otEQ=
|
|
||||||
github.com/rogpeppe/go-internal v1.14.1/go.mod h1:MaRKkUm5W0goXpeCfT7UZI6fk/L7L7so1lCWt35ZSgc=
|
|
||||||
github.com/rs/xid v1.6.0 h1:fV591PaemRlL6JfRxGDEPl69wICngIQ3shQtzfy2gxU=
|
|
||||||
github.com/rs/xid v1.6.0/go.mod h1:7XoLgs4eV+QndskICGsho+ADou8ySMSjJKDIan90Nz0=
|
|
||||||
github.com/shirou/gopsutil/v4 v4.26.6 h1:Mzr/npDtQC/xpeEuQKHZt8Zo9CmPvhTj8nkR8w5TLDs=
|
|
||||||
github.com/shirou/gopsutil/v4 v4.26.6/go.mod h1:LZ6ewCSkBqUpvSOf+LsTGnRinC6iaNUNMGBtDkJBaLQ=
|
|
||||||
github.com/sirupsen/logrus v1.9.4 h1:TsZE7l11zFCLZnZ+teH4Umoq5BhEIfIzfRDZ1Uzql2w=
|
|
||||||
github.com/sirupsen/logrus v1.9.4/go.mod h1:ftWc9WdOfJ0a92nsE2jF5u5ZwH8Bv2zdeOC42RjbV2g=
|
|
||||||
github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
|
|
||||||
github.com/stretchr/objx v0.4.0/go.mod h1:YvHI0jy2hoMjB+UWwv71VJQ9isScKT/TqJzVSSt89Yw=
|
|
||||||
github.com/stretchr/objx v0.5.0/go.mod h1:Yh+to48EsGEfYuaHDzXPcE3xhTkx73EhmCGUpEOglKo=
|
|
||||||
github.com/stretchr/objx v0.5.2/go.mod h1:FRsXN1f5AsAjCGJKqEizvkpNtU+EGNCLh3NxZ/8L+MA=
|
|
||||||
github.com/stretchr/objx v0.5.3 h1:jmXUvGomnU1o3W/V5h2VEradbpJDwGrzugQQvL0POH4=
|
|
||||||
github.com/stretchr/objx v0.5.3/go.mod h1:rDQraq+vQZU7Fde9LOZLr8Tax6zZvy4kuNKF+QYS+U0=
|
|
||||||
github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI=
|
|
||||||
github.com/stretchr/testify v1.7.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
|
|
||||||
github.com/stretchr/testify v1.7.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
|
|
||||||
github.com/stretchr/testify v1.8.0/go.mod h1:yNjHg4UonilssWZ8iaSj1OCr/vHnekPRkoO+kdMU+MU=
|
|
||||||
github.com/stretchr/testify v1.8.4/go.mod h1:sz/lmYIOXD/1dqDmKjjqLyZ2RngseejIcXlSw2iwfAo=
|
|
||||||
github.com/stretchr/testify v1.11.1 h1:7s2iGBzp5EwR7/aIZr8ao5+dra3wiQyKjjFuvgVKu7U=
|
|
||||||
github.com/stretchr/testify v1.11.1/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD981Nm4B6U=
|
|
||||||
github.com/testcontainers/testcontainers-go v0.44.0 h1:/Fwh6HY1mIikhnm9e7HwoxGycx0lzRAE0f5VQpjFxzI=
|
|
||||||
github.com/testcontainers/testcontainers-go v0.44.0/go.mod h1:IcnwQrYTO86xHXu5bvMaBH7ATlbS3Qn1M1QWW3c66rE=
|
|
||||||
github.com/testcontainers/testcontainers-go/modules/postgres v0.44.0 h1:8fdv/9y3JMxjQ+ULAcOG8RtgeNu5t9XF9LolSXDuTwM=
|
|
||||||
github.com/testcontainers/testcontainers-go/modules/postgres v0.44.0/go.mod h1:CFr2LncGYokw+OKjXcr8ARCKG1SaC2UEnGxFBovE86g=
|
|
||||||
github.com/testcontainers/testcontainers-go/modules/redis v0.42.0 h1:id/6LH8ZeDrtAUVSuNvZUAJ1kVpb82y1pr9yweAWsRg=
|
|
||||||
github.com/testcontainers/testcontainers-go/modules/redis v0.42.0/go.mod h1:uF0jI8FITagQpBNOgweGBmPf6rP4K0SeL1XFPbsZSSY=
|
|
||||||
github.com/tinylib/msgp v1.6.1 h1:ESRv8eL3u+DNHUoSAAQRE50Hm162zqAnBoGv9PzScPY=
|
|
||||||
github.com/tinylib/msgp v1.6.1/go.mod h1:RSp0LW9oSxFut3KzESt5Voq4GVWyS+PSulT77roAqEA=
|
|
||||||
github.com/tklauser/go-sysconf v0.4.0 h1:7H0uAN+7RkwWRaxhYXDLqa5V3LPrJeV8wmD9dRUgPQU=
|
|
||||||
github.com/tklauser/go-sysconf v0.4.0/go.mod h1:8mTNWyog7H+MpKijp4VmKJAd2bbYQ2zuUwkYRbUArPI=
|
|
||||||
github.com/tklauser/numcpus v0.12.0 h1:NR85qdvHA9pFse3x3weVZ0r0ST8R6l5RHbZrlRaqob4=
|
|
||||||
github.com/tklauser/numcpus v0.12.0/go.mod h1:ABHeXzJnr/qqwguhClkZKT1/8VABcYrsyUiUGobwWJg=
|
|
||||||
github.com/ulikunitz/xz v0.5.16 h1:ld6NyySjx5lowVKwJvMRLnW5nxKX/xnpSiFYZ/Lxur0=
|
|
||||||
github.com/ulikunitz/xz v0.5.16/go.mod h1:H9Rt/W6/Qj27PGauhQc6nfCDy7vHpzsOThBSaYDoEhw=
|
|
||||||
github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e h1:JVG44RsyaB9T2KIHavMF/ppJZNG9ZpyihvCd0w101no=
|
|
||||||
github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e/go.mod h1:RbqR21r5mrJuqunuUZ/Dhy/avygyECGrLceyNeo4LiM=
|
|
||||||
github.com/yusufpapurcu/wmi v1.2.4 h1:zFUKzehAFReQwLys1b/iSMl+JQGSCSjtVqQn9bBrPo0=
|
|
||||||
github.com/yusufpapurcu/wmi v1.2.4/go.mod h1:SBZ9tNy3G9/m5Oi98Zks0QjeHVDvuK0qfxQmPyzfmi0=
|
|
||||||
github.com/zeebo/assert v1.3.0 h1:g7C04CbJuIDKNPFHmsk4hwZDO5O+kntRxzaUoNXj+IQ=
|
|
||||||
github.com/zeebo/assert v1.3.0/go.mod h1:Pq9JiuJQpG8JLJdtkwrJESF0Foym2/D9XMU5ciN/wJ0=
|
|
||||||
github.com/zeebo/xxh3 v1.1.0 h1:s7DLGDK45Dyfg7++yxI0khrfwq9661w9EN78eP/UZVs=
|
|
||||||
github.com/zeebo/xxh3 v1.1.0/go.mod h1:IisAie1LELR4xhVinxWS5+zf1lA4p0MW4T+w+W07F5s=
|
|
||||||
go.opentelemetry.io/auto/sdk v1.2.1 h1:jXsnJ4Lmnqd11kwkBV2LgLoFMZKizbCi5fNZ/ipaZ64=
|
|
||||||
go.opentelemetry.io/auto/sdk v1.2.1/go.mod h1:KRTj+aOaElaLi+wW1kO/DZRXwkF4C5xPbEe3ZiIhN7Y=
|
|
||||||
go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.69.0 h1:8tvICD4vSTOOsNrsI4Ljf6C+6UKvpTEH5XY3JMoyPoo=
|
|
||||||
go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.69.0/go.mod h1:z9+yiacE0IHRqM4qFfkbt/JYlmYXgss8GY/jXoNuPJI=
|
|
||||||
go.opentelemetry.io/otel v1.44.0 h1:JjwHmHpA4iZ3wBxluu2fbbE7j4kqlE8jXyAyPXH7HqU=
|
|
||||||
go.opentelemetry.io/otel v1.44.0/go.mod h1:BMgjTHL9WPRlRjL2oZCBTL4whCGtXch2H4BhOPIAyYc=
|
|
||||||
go.opentelemetry.io/otel/metric v1.44.0 h1:1w0gILTcHdr3YI+ixLyjemwrVnsMURbTZFrSYCdDdmc=
|
|
||||||
go.opentelemetry.io/otel/metric v1.44.0/go.mod h1:8O7hanEPBNgEMmybD3s2VBKcgWOCsA6tzHBPODAiquo=
|
|
||||||
go.opentelemetry.io/otel/sdk v1.44.0 h1:nHYwb9lK+fJPU/dnT6s7W7Z8itMWyqrnVfbheVYrZ58=
|
|
||||||
go.opentelemetry.io/otel/sdk v1.44.0/go.mod h1:Osuydd3Se74nqjAKxid74N5eC+jfEqfTegHRnq58oK0=
|
|
||||||
go.opentelemetry.io/otel/sdk/metric v1.44.0 h1:3LlKgI+VjbVsjNRFZJZAJ30WjXC5VkNRks6si09iEfI=
|
|
||||||
go.opentelemetry.io/otel/sdk/metric v1.44.0/go.mod h1:5B5pMARnXxKhltooO4xUuCBorl65a4EpnTalObqOigA=
|
|
||||||
go.opentelemetry.io/otel/trace v1.44.0 h1:jxF5CsGYCe74MCRx2X4g7WsY/VBKRqqpNvXlX/6gtIk=
|
|
||||||
go.opentelemetry.io/otel/trace v1.44.0/go.mod h1:oLl1jrMQAVo6v3GAggN+1VH9VIz9iUSvW53sW1Q8PIE=
|
|
||||||
go.uber.org/atomic v1.11.0 h1:ZvwS0R+56ePWxUNi+Atn9dWONBPp/AUETXlHW0DxSjE=
|
|
||||||
go.uber.org/atomic v1.11.0/go.mod h1:LUxbIzbOniOlMKjJjyPfpl4v+PKK2cNJn91OQbhoJI0=
|
|
||||||
go.yaml.in/yaml/v3 v3.0.4 h1:tfq32ie2Jv2UxXFdLJdh3jXuOzWiL1fo0bu/FbuKpbc=
|
|
||||||
go.yaml.in/yaml/v3 v3.0.4/go.mod h1:DhzuOOF2ATzADvBadXxruRBLzYTpT36CKvDb3+aBEFg=
|
|
||||||
golang.org/x/crypto v0.54.0 h1:YLIA59K4fiNzHzjnZt2tUJQjQtUWfWbeHBqKtk3eScw=
|
|
||||||
golang.org/x/crypto v0.54.0/go.mod h1:KWL8ny2AZdGR2cWmzeHrp2azQPGogOv+HeQaVEXC2dk=
|
|
||||||
golang.org/x/exp v0.0.0-20231006140011-7918f672742d h1:jtJma62tbqLibJ5sFQz8bKtEM8rJBtfilJ2qTU199MI=
|
|
||||||
golang.org/x/exp v0.0.0-20231006140011-7918f672742d/go.mod h1:ldy0pHrwJyGW56pPQzzkH36rKxoZW1tw7ZJpeKx+hdo=
|
|
||||||
golang.org/x/net v0.56.0 h1:Rw8j/hFzGvJUZwNBXnAtf5sVDVt+65SK2C7IxCxZt5o=
|
|
||||||
golang.org/x/net v0.56.0/go.mod h1:D3Ku6r+V6JROoZK144D2XfMHFcMq/0zSfLelVTCFKec=
|
|
||||||
golang.org/x/oauth2 v0.36.0 h1:peZ/1z27fi9hUOFCAZaHyrpWG5lwe0RJEEEeH0ThlIs=
|
|
||||||
golang.org/x/oauth2 v0.36.0/go.mod h1:YDBUJMTkDnJS+A4BP4eZBjCqtokkg1hODuPjwiGPO7Q=
|
|
||||||
golang.org/x/sync v0.22.0 h1:SZjpbeLmrCk4xhRSZFNZW5gFUeCeFgjekvI/+gfScek=
|
|
||||||
golang.org/x/sync v0.22.0/go.mod h1:9xrNwdLfx4jkKbNva9FpL6vEN7evnE43NNNJQ2LF3+0=
|
|
||||||
golang.org/x/sys v0.0.0-20190916202348-b4ddaad3f8a3/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
|
|
||||||
golang.org/x/sys v0.0.0-20201204225414-ed752295db88/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
|
|
||||||
golang.org/x/sys v0.0.0-20210616094352-59db8d763f22/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
|
|
||||||
golang.org/x/sys v0.0.0-20210809222454-d867a43fc93e/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
|
|
||||||
golang.org/x/sys v0.1.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
|
|
||||||
golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
|
|
||||||
golang.org/x/sys v0.47.0 h1:o7XGOvZQCADBQQ4Y7VNq2dRWQR7JmOUW8Kxx4ZsNgWs=
|
|
||||||
golang.org/x/sys v0.47.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw=
|
|
||||||
golang.org/x/term v0.45.0 h1:NwWyBmoJCbfTHpxrWoZ9C6/VxOf7ic219I8xZZFdrf0=
|
|
||||||
golang.org/x/term v0.45.0/go.mod h1:9aqxs0blBcrm/n0L9QW0aRVD+ktan8ssZromtqJC43w=
|
|
||||||
golang.org/x/text v0.40.0 h1:Ub2Z6/xjgF1WrYQz2nuITOEegKFtiIy+rieRJ5lHZKs=
|
|
||||||
golang.org/x/text v0.40.0/go.mod h1:hpnzDAfGV753zIKo+wk3u1bVKCGPbrnF7+7LBF/UHVY=
|
|
||||||
golang.org/x/time v0.15.0 h1:bbrp8t3bGUeFOx08pvsMYRTCVSMk89u4tKbNOZbp88U=
|
|
||||||
golang.org/x/time v0.15.0/go.mod h1:Y4YMaQmXwGQZoFaVFk4YpCt4FLQMYKZe9oeV/f4MSno=
|
|
||||||
gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
|
|
||||||
gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c h1:Hei/4ADfdWqJk1ZMxUNpqntNwaWcugrBjAiHlqqRiVk=
|
|
||||||
gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c/go.mod h1:JHkPIbrfpd72SG/EVd6muEfDQjcINNoR0C8j2r3qZ4Q=
|
|
||||||
gopkg.in/ini.v1 v1.67.2 h1:JtOSMb9OuaCZKr7h5D/h6iii14sK0hLbplTc6frx4Ss=
|
|
||||||
gopkg.in/ini.v1 v1.67.2/go.mod h1:x/cyOwCgZqOkJoDIJ3c1KNHMo10+nLGAhh+kn3Zizss=
|
|
||||||
gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
|
|
||||||
gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
|
|
||||||
gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
|
|
||||||
gotest.tools/v3 v3.5.2 h1:7koQfIKdy+I8UTetycgUqXWSDwpgv193Ka+qRsmBY8Q=
|
|
||||||
gotest.tools/v3 v3.5.2/go.mod h1:LtdLGcnqToBH83WByAAi/wiwSFCArdFIUV/xxN4pcjA=
|
|
||||||
pgregory.net/rapid v1.2.0 h1:keKAYRcjm+e1F0oAuU5F5+YPAWcyxNNRK2wud503Gnk=
|
|
||||||
pgregory.net/rapid v1.2.0/go.mod h1:PY5XlDGj0+V1FCq0o192FdRhpKHGTRIWBgqjDBTrq04=
|
|
||||||
@@ -1,301 +0,0 @@
|
|||||||
// Package terraform serves local terraform repos as a real Terraform provider
|
|
||||||
// registry: service discovery, version listing, and GPG-signed downloads, so
|
|
||||||
// `terraform init` installs from a bare source address with no client config.
|
|
||||||
package terraform
|
|
||||||
|
|
||||||
import (
|
|
||||||
"encoding/json"
|
|
||||||
"fmt"
|
|
||||||
"net/http"
|
|
||||||
"path"
|
|
||||||
"sort"
|
|
||||||
"strings"
|
|
||||||
|
|
||||||
"github.com/go-chi/chi/v5"
|
|
||||||
|
|
||||||
"git.unkin.net/unkin/artifactapi/internal/database"
|
|
||||||
tfprov "git.unkin.net/unkin/artifactapi/internal/provider/terraform"
|
|
||||||
"git.unkin.net/unkin/artifactapi/internal/tfsign"
|
|
||||||
"git.unkin.net/unkin/artifactapi/pkg/models"
|
|
||||||
)
|
|
||||||
|
|
||||||
// ProvidersV1Path is the base the service-discovery document advertises (Terraform
|
|
||||||
// appends "{namespace}/{type}/versions" etc). MountPath is the same prefix without
|
|
||||||
// the trailing slash, for chi.Mount.
|
|
||||||
const (
|
|
||||||
ProvidersV1Path = "/terraform/v1/providers/"
|
|
||||||
MountPath = "/terraform/v1/providers"
|
|
||||||
)
|
|
||||||
|
|
||||||
type Handler struct {
|
|
||||||
db *database.DB
|
|
||||||
signer *tfsign.Signer
|
|
||||||
protocols []string
|
|
||||||
}
|
|
||||||
|
|
||||||
func NewHandler(db *database.DB, signer *tfsign.Signer, protocols string) *Handler {
|
|
||||||
var protos []string
|
|
||||||
for _, p := range strings.Split(protocols, ",") {
|
|
||||||
if p = strings.TrimSpace(p); p != "" {
|
|
||||||
protos = append(protos, p)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if len(protos) == 0 {
|
|
||||||
protos = []string{"5.0", "6.0"}
|
|
||||||
}
|
|
||||||
return &Handler{db: db, signer: signer, protocols: protos}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Enabled reports whether a signing key is configured. Without one the registry
|
|
||||||
// cannot produce the signed SHA256SUMS the protocol requires, so it stays off.
|
|
||||||
func (h *Handler) Enabled() bool { return h.signer != nil }
|
|
||||||
|
|
||||||
func (h *Handler) Routes() chi.Router {
|
|
||||||
r := chi.NewRouter()
|
|
||||||
r.Get("/{namespace}/{type}/versions", h.versions)
|
|
||||||
r.Get("/{namespace}/{type}/{version}/download/{os}/{arch}", h.download)
|
|
||||||
r.Get("/{namespace}/{type}/{version}/sha256sums", h.sha256sums)
|
|
||||||
r.Get("/{namespace}/{type}/{version}/sha256sums.sig", h.sha256sumsSig)
|
|
||||||
return r
|
|
||||||
}
|
|
||||||
|
|
||||||
// ServiceDiscovery answers /.well-known/terraform.json, pointing Terraform at the
|
|
||||||
// providers.v1 protocol base.
|
|
||||||
func (h *Handler) ServiceDiscovery(w http.ResponseWriter, r *http.Request) {
|
|
||||||
if !h.Enabled() {
|
|
||||||
http.NotFound(w, r)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
writeJSON(w, map[string]string{"providers.v1": ProvidersV1Path})
|
|
||||||
}
|
|
||||||
|
|
||||||
// providerFile is one resolved platform artifact within a repo.
|
|
||||||
type providerFile struct {
|
|
||||||
version string
|
|
||||||
os string
|
|
||||||
arch string
|
|
||||||
filePath string // path within the repo, e.g. unkin/artifactapi/...zip
|
|
||||||
sha256 string // hex, no "sha256:" prefix
|
|
||||||
}
|
|
||||||
|
|
||||||
// resolve finds every provider zip of the given type in the repo (namespace).
|
|
||||||
// The Terraform source namespace maps to the artifactapi repo name; the provider
|
|
||||||
// is matched by type across whatever in-repo folder it was uploaded under.
|
|
||||||
func (h *Handler) resolve(r *http.Request, namespace, typeName string) ([]providerFile, error) {
|
|
||||||
remote, err := h.db.GetRemote(r.Context(), namespace)
|
|
||||||
if err != nil || remote.PackageType != models.PackageTerraform {
|
|
||||||
return nil, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
rows, err := h.db.ListLocalFiles(r.Context(), namespace, 10000, 0)
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
|
|
||||||
var out []providerFile
|
|
||||||
for _, row := range rows {
|
|
||||||
parsed := tfprov.ParseProviderZip(path.Base(row.FilePath))
|
|
||||||
if !parsed.Ok || parsed.Type != typeName {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
out = append(out, providerFile{
|
|
||||||
version: parsed.Version,
|
|
||||||
os: parsed.OS,
|
|
||||||
arch: parsed.Arch,
|
|
||||||
filePath: row.FilePath,
|
|
||||||
sha256: strings.TrimPrefix(row.ContentHash, "sha256:"),
|
|
||||||
})
|
|
||||||
}
|
|
||||||
return out, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (h *Handler) versions(w http.ResponseWriter, r *http.Request) {
|
|
||||||
if !h.Enabled() {
|
|
||||||
http.NotFound(w, r)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
namespace := chi.URLParam(r, "namespace")
|
|
||||||
typeName := chi.URLParam(r, "type")
|
|
||||||
|
|
||||||
files, err := h.resolve(r, namespace, typeName)
|
|
||||||
if err != nil {
|
|
||||||
http.Error(w, err.Error(), http.StatusInternalServerError)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
if len(files) == 0 {
|
|
||||||
http.NotFound(w, r)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
// Group platforms by version, de-duplicated and stably ordered.
|
|
||||||
type platform struct {
|
|
||||||
OS string `json:"os"`
|
|
||||||
Arch string `json:"arch"`
|
|
||||||
}
|
|
||||||
platforms := map[string]map[string]platform{}
|
|
||||||
for _, f := range files {
|
|
||||||
if platforms[f.version] == nil {
|
|
||||||
platforms[f.version] = map[string]platform{}
|
|
||||||
}
|
|
||||||
platforms[f.version][f.os+"_"+f.arch] = platform{OS: f.os, Arch: f.arch}
|
|
||||||
}
|
|
||||||
|
|
||||||
type versionEntry struct {
|
|
||||||
Version string `json:"version"`
|
|
||||||
Protocols []string `json:"protocols"`
|
|
||||||
Platforms []platform `json:"platforms"`
|
|
||||||
}
|
|
||||||
out := struct {
|
|
||||||
Versions []versionEntry `json:"versions"`
|
|
||||||
}{}
|
|
||||||
for version, plats := range platforms {
|
|
||||||
entry := versionEntry{Version: version, Protocols: h.protocols}
|
|
||||||
for _, p := range plats {
|
|
||||||
entry.Platforms = append(entry.Platforms, p)
|
|
||||||
}
|
|
||||||
sort.Slice(entry.Platforms, func(i, j int) bool {
|
|
||||||
return entry.Platforms[i].OS+entry.Platforms[i].Arch < entry.Platforms[j].OS+entry.Platforms[j].Arch
|
|
||||||
})
|
|
||||||
out.Versions = append(out.Versions, entry)
|
|
||||||
}
|
|
||||||
sort.Slice(out.Versions, func(i, j int) bool { return out.Versions[i].Version < out.Versions[j].Version })
|
|
||||||
|
|
||||||
writeJSON(w, out)
|
|
||||||
}
|
|
||||||
|
|
||||||
func (h *Handler) download(w http.ResponseWriter, r *http.Request) {
|
|
||||||
if !h.Enabled() {
|
|
||||||
http.NotFound(w, r)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
namespace := chi.URLParam(r, "namespace")
|
|
||||||
typeName := chi.URLParam(r, "type")
|
|
||||||
version := chi.URLParam(r, "version")
|
|
||||||
osName := chi.URLParam(r, "os")
|
|
||||||
arch := chi.URLParam(r, "arch")
|
|
||||||
|
|
||||||
files, err := h.resolve(r, namespace, typeName)
|
|
||||||
if err != nil {
|
|
||||||
http.Error(w, err.Error(), http.StatusInternalServerError)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
var match *providerFile
|
|
||||||
for i := range files {
|
|
||||||
if files[i].version == version && files[i].os == osName && files[i].arch == arch {
|
|
||||||
match = &files[i]
|
|
||||||
break
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if match == nil {
|
|
||||||
http.NotFound(w, r)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
base := baseURL(r)
|
|
||||||
verBase := fmt.Sprintf("%s%s/%s/%s", base+ProvidersV1Path, namespace, typeName, version)
|
|
||||||
|
|
||||||
type gpgKey struct {
|
|
||||||
KeyID string `json:"key_id"`
|
|
||||||
ASCIIArmor string `json:"ascii_armor"`
|
|
||||||
}
|
|
||||||
resp := struct {
|
|
||||||
Protocols []string `json:"protocols"`
|
|
||||||
OS string `json:"os"`
|
|
||||||
Arch string `json:"arch"`
|
|
||||||
Filename string `json:"filename"`
|
|
||||||
DownloadURL string `json:"download_url"`
|
|
||||||
SHASumsURL string `json:"shasums_url"`
|
|
||||||
SHASumsSignatureURL string `json:"shasums_signature_url"`
|
|
||||||
SHASum string `json:"shasum"`
|
|
||||||
SigningKeys struct {
|
|
||||||
GPGPublicKeys []gpgKey `json:"gpg_public_keys"`
|
|
||||||
} `json:"signing_keys"`
|
|
||||||
}{
|
|
||||||
Protocols: h.protocols,
|
|
||||||
OS: match.os,
|
|
||||||
Arch: match.arch,
|
|
||||||
Filename: path.Base(match.filePath),
|
|
||||||
DownloadURL: fmt.Sprintf("%s/api/v1/local/%s/%s", base, namespace, match.filePath),
|
|
||||||
SHASumsURL: verBase + "/sha256sums",
|
|
||||||
SHASumsSignatureURL: verBase + "/sha256sums.sig",
|
|
||||||
SHASum: match.sha256,
|
|
||||||
}
|
|
||||||
resp.SigningKeys.GPGPublicKeys = []gpgKey{{
|
|
||||||
KeyID: h.signer.KeyID(),
|
|
||||||
ASCIIArmor: h.signer.PublicKeyArmor(),
|
|
||||||
}}
|
|
||||||
|
|
||||||
writeJSON(w, resp)
|
|
||||||
}
|
|
||||||
|
|
||||||
func (h *Handler) sha256sums(w http.ResponseWriter, r *http.Request) {
|
|
||||||
sums, ok := h.buildSums(w, r)
|
|
||||||
if !ok {
|
|
||||||
return
|
|
||||||
}
|
|
||||||
w.Header().Set("Content-Type", "text/plain; charset=utf-8")
|
|
||||||
w.Write(sums)
|
|
||||||
}
|
|
||||||
|
|
||||||
func (h *Handler) sha256sumsSig(w http.ResponseWriter, r *http.Request) {
|
|
||||||
sums, ok := h.buildSums(w, r)
|
|
||||||
if !ok {
|
|
||||||
return
|
|
||||||
}
|
|
||||||
sig, err := h.signer.Sign(sums)
|
|
||||||
if err != nil {
|
|
||||||
http.Error(w, err.Error(), http.StatusInternalServerError)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
w.Header().Set("Content-Type", "application/octet-stream")
|
|
||||||
w.Write(sig)
|
|
||||||
}
|
|
||||||
|
|
||||||
// buildSums renders the SHA256SUMS body for one version: one "<hex> <filename>"
|
|
||||||
// line per platform zip, sorted by filename so the signed bytes are stable.
|
|
||||||
func (h *Handler) buildSums(w http.ResponseWriter, r *http.Request) ([]byte, bool) {
|
|
||||||
if !h.Enabled() {
|
|
||||||
http.NotFound(w, r)
|
|
||||||
return nil, false
|
|
||||||
}
|
|
||||||
namespace := chi.URLParam(r, "namespace")
|
|
||||||
typeName := chi.URLParam(r, "type")
|
|
||||||
version := chi.URLParam(r, "version")
|
|
||||||
|
|
||||||
files, err := h.resolve(r, namespace, typeName)
|
|
||||||
if err != nil {
|
|
||||||
http.Error(w, err.Error(), http.StatusInternalServerError)
|
|
||||||
return nil, false
|
|
||||||
}
|
|
||||||
|
|
||||||
var lines []string
|
|
||||||
for _, f := range files {
|
|
||||||
if f.version != version {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
lines = append(lines, fmt.Sprintf("%s %s", f.sha256, path.Base(f.filePath)))
|
|
||||||
}
|
|
||||||
if len(lines) == 0 {
|
|
||||||
http.NotFound(w, r)
|
|
||||||
return nil, false
|
|
||||||
}
|
|
||||||
sort.Strings(lines)
|
|
||||||
return []byte(strings.Join(lines, "\n") + "\n"), true
|
|
||||||
}
|
|
||||||
|
|
||||||
func writeJSON(w http.ResponseWriter, v any) {
|
|
||||||
w.Header().Set("Content-Type", "application/json")
|
|
||||||
json.NewEncoder(w).Encode(v)
|
|
||||||
}
|
|
||||||
|
|
||||||
func baseURL(r *http.Request) string {
|
|
||||||
scheme := "http"
|
|
||||||
if r.TLS != nil {
|
|
||||||
scheme = "https"
|
|
||||||
}
|
|
||||||
if fwd := r.Header.Get("X-Forwarded-Proto"); fwd != "" {
|
|
||||||
scheme = fwd
|
|
||||||
}
|
|
||||||
return scheme + "://" + r.Host
|
|
||||||
}
|
|
||||||
@@ -1,186 +0,0 @@
|
|||||||
package terraform
|
|
||||||
|
|
||||||
import (
|
|
||||||
"bytes"
|
|
||||||
"context"
|
|
||||||
"encoding/json"
|
|
||||||
"net/http/httptest"
|
|
||||||
"os"
|
|
||||||
"path/filepath"
|
|
||||||
"testing"
|
|
||||||
|
|
||||||
"github.com/go-chi/chi/v5"
|
|
||||||
"golang.org/x/crypto/openpgp"
|
|
||||||
"golang.org/x/crypto/openpgp/armor"
|
|
||||||
|
|
||||||
"git.unkin.net/unkin/artifactapi/internal/database"
|
|
||||||
"git.unkin.net/unkin/artifactapi/internal/testsupport"
|
|
||||||
"git.unkin.net/unkin/artifactapi/internal/tfsign"
|
|
||||||
"git.unkin.net/unkin/artifactapi/pkg/models"
|
|
||||||
)
|
|
||||||
|
|
||||||
var testDSN string
|
|
||||||
|
|
||||||
func TestMain(m *testing.M) {
|
|
||||||
ctx := context.Background()
|
|
||||||
dsn, terminate, err := testsupport.StartPostgres(ctx)
|
|
||||||
if err != nil {
|
|
||||||
os.Exit(m.Run())
|
|
||||||
}
|
|
||||||
testDSN = dsn
|
|
||||||
code := m.Run()
|
|
||||||
terminate()
|
|
||||||
os.Exit(code)
|
|
||||||
}
|
|
||||||
|
|
||||||
// testSigner writes a throwaway armored key and loads it.
|
|
||||||
func testSigner(t *testing.T) *tfsign.Signer {
|
|
||||||
t.Helper()
|
|
||||||
e, err := openpgp.NewEntity("artifactapi test", "tf", "tf@example.com", nil)
|
|
||||||
if err != nil {
|
|
||||||
t.Fatal(err)
|
|
||||||
}
|
|
||||||
var buf bytes.Buffer
|
|
||||||
w, _ := armor.Encode(&buf, openpgp.PrivateKeyType, nil)
|
|
||||||
if err := e.SerializePrivate(w, nil); err != nil {
|
|
||||||
t.Fatal(err)
|
|
||||||
}
|
|
||||||
w.Close()
|
|
||||||
p := filepath.Join(t.TempDir(), "private-key.asc")
|
|
||||||
if err := os.WriteFile(p, buf.Bytes(), 0o600); err != nil {
|
|
||||||
t.Fatal(err)
|
|
||||||
}
|
|
||||||
s, err := tfsign.Load(p, "")
|
|
||||||
if err != nil {
|
|
||||||
t.Fatal(err)
|
|
||||||
}
|
|
||||||
return s
|
|
||||||
}
|
|
||||||
|
|
||||||
func TestProviderRegistryFlow(t *testing.T) {
|
|
||||||
if testDSN == "" {
|
|
||||||
t.Skip("Docker unavailable")
|
|
||||||
}
|
|
||||||
ctx := context.Background()
|
|
||||||
db, err := database.New(testDSN)
|
|
||||||
if err != nil {
|
|
||||||
t.Fatal(err)
|
|
||||||
}
|
|
||||||
defer db.Close()
|
|
||||||
|
|
||||||
const repo = "tf-reg" // Terraform namespace == repo name
|
|
||||||
const filePath = "unkin/artifactapi/terraform-provider-artifactapi_1.2.3_linux_amd64.zip"
|
|
||||||
const hash = "sha256:983cdb25cb7b976538e4334d26e52dee5f44749b9be1500c760cf5cf66be659b"
|
|
||||||
const wantSha = "983cdb25cb7b976538e4334d26e52dee5f44749b9be1500c760cf5cf66be659b"
|
|
||||||
|
|
||||||
if err := db.CreateRemote(ctx, &models.Remote{Name: repo, PackageType: models.PackageTerraform, RepoType: models.RepoTypeLocal}); err != nil {
|
|
||||||
t.Fatal(err)
|
|
||||||
}
|
|
||||||
if err := db.UpsertBlob(ctx, hash, "blobs/98/3c", 6381007, "application/zip"); err != nil {
|
|
||||||
t.Fatal(err)
|
|
||||||
}
|
|
||||||
if err := db.CreateLocalFile(ctx, repo, filePath, hash); err != nil {
|
|
||||||
t.Fatal(err)
|
|
||||||
}
|
|
||||||
|
|
||||||
signer := testSigner(t)
|
|
||||||
h := NewHandler(db, signer, "5.0,6.0")
|
|
||||||
router := chi.NewRouter()
|
|
||||||
router.Get("/.well-known/terraform.json", h.ServiceDiscovery)
|
|
||||||
router.Mount(MountPath, h.Routes())
|
|
||||||
|
|
||||||
get := func(p string) *httptest.ResponseRecorder {
|
|
||||||
req := httptest.NewRequest("GET", p, nil)
|
|
||||||
w := httptest.NewRecorder()
|
|
||||||
router.ServeHTTP(w, req)
|
|
||||||
return w
|
|
||||||
}
|
|
||||||
|
|
||||||
// Service discovery.
|
|
||||||
w := get("/.well-known/terraform.json")
|
|
||||||
if w.Code != 200 {
|
|
||||||
t.Fatalf("discovery = %d", w.Code)
|
|
||||||
}
|
|
||||||
var disc map[string]string
|
|
||||||
json.Unmarshal(w.Body.Bytes(), &disc)
|
|
||||||
if disc["providers.v1"] != ProvidersV1Path {
|
|
||||||
t.Errorf("providers.v1 = %q", disc["providers.v1"])
|
|
||||||
}
|
|
||||||
|
|
||||||
// Versions.
|
|
||||||
w = get("/terraform/v1/providers/tf-reg/artifactapi/versions")
|
|
||||||
if w.Code != 200 {
|
|
||||||
t.Fatalf("versions = %d %s", w.Code, w.Body)
|
|
||||||
}
|
|
||||||
var vresp struct {
|
|
||||||
Versions []struct {
|
|
||||||
Version string `json:"version"`
|
|
||||||
Protocols []string `json:"protocols"`
|
|
||||||
Platforms []map[string]string `json:"platforms"`
|
|
||||||
} `json:"versions"`
|
|
||||||
}
|
|
||||||
json.Unmarshal(w.Body.Bytes(), &vresp)
|
|
||||||
if len(vresp.Versions) != 1 || vresp.Versions[0].Version != "1.2.3" {
|
|
||||||
t.Fatalf("unexpected versions: %+v", vresp)
|
|
||||||
}
|
|
||||||
if len(vresp.Versions[0].Platforms) != 1 || vresp.Versions[0].Platforms[0]["os"] != "linux" {
|
|
||||||
t.Fatalf("unexpected platforms: %+v", vresp.Versions[0].Platforms)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Download.
|
|
||||||
w = get("/terraform/v1/providers/tf-reg/artifactapi/1.2.3/download/linux/amd64")
|
|
||||||
if w.Code != 200 {
|
|
||||||
t.Fatalf("download = %d %s", w.Code, w.Body)
|
|
||||||
}
|
|
||||||
var dl struct {
|
|
||||||
Filename string `json:"filename"`
|
|
||||||
DownloadURL string `json:"download_url"`
|
|
||||||
SHASumsURL string `json:"shasums_url"`
|
|
||||||
SHASumsSignatureURL string `json:"shasums_signature_url"`
|
|
||||||
SHASum string `json:"shasum"`
|
|
||||||
SigningKeys struct {
|
|
||||||
GPGPublicKeys []struct {
|
|
||||||
KeyID string `json:"key_id"`
|
|
||||||
ASCIIArmor string `json:"ascii_armor"`
|
|
||||||
} `json:"gpg_public_keys"`
|
|
||||||
} `json:"signing_keys"`
|
|
||||||
}
|
|
||||||
json.Unmarshal(w.Body.Bytes(), &dl)
|
|
||||||
if dl.SHASum != wantSha {
|
|
||||||
t.Errorf("shasum = %q", dl.SHASum)
|
|
||||||
}
|
|
||||||
wantURL := "http://example.com/api/v1/local/tf-reg/" + filePath
|
|
||||||
if dl.DownloadURL != wantURL {
|
|
||||||
t.Errorf("download_url = %q, want %q", dl.DownloadURL, wantURL)
|
|
||||||
}
|
|
||||||
if len(dl.SigningKeys.GPGPublicKeys) != 1 || dl.SigningKeys.GPGPublicKeys[0].KeyID != signer.KeyID() {
|
|
||||||
t.Errorf("signing key mismatch: %+v", dl.SigningKeys)
|
|
||||||
}
|
|
||||||
|
|
||||||
// SHA256SUMS + signature verify against the advertised key.
|
|
||||||
sums := get("/terraform/v1/providers/tf-reg/artifactapi/1.2.3/sha256sums")
|
|
||||||
wantLine := wantSha + " terraform-provider-artifactapi_1.2.3_linux_amd64.zip\n"
|
|
||||||
if sums.Body.String() != wantLine {
|
|
||||||
t.Errorf("sha256sums = %q, want %q", sums.Body.String(), wantLine)
|
|
||||||
}
|
|
||||||
sig := get("/terraform/v1/providers/tf-reg/artifactapi/1.2.3/sha256sums.sig")
|
|
||||||
keyring, err := openpgp.ReadArmoredKeyRing(bytes.NewReader([]byte(dl.SigningKeys.GPGPublicKeys[0].ASCIIArmor)))
|
|
||||||
if err != nil {
|
|
||||||
t.Fatal(err)
|
|
||||||
}
|
|
||||||
if _, err := openpgp.CheckDetachedSignature(keyring, bytes.NewReader(sums.Body.Bytes()), bytes.NewReader(sig.Body.Bytes())); err != nil {
|
|
||||||
t.Errorf("sha256sums.sig did not verify: %v", err)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func TestRegistryDisabledWithoutSigner(t *testing.T) {
|
|
||||||
h := NewHandler(nil, nil, "")
|
|
||||||
router := chi.NewRouter()
|
|
||||||
router.Get("/.well-known/terraform.json", h.ServiceDiscovery)
|
|
||||||
req := httptest.NewRequest("GET", "/.well-known/terraform.json", nil)
|
|
||||||
w := httptest.NewRecorder()
|
|
||||||
router.ServeHTTP(w, req)
|
|
||||||
if w.Code != 404 {
|
|
||||||
t.Errorf("disabled discovery = %d, want 404", w.Code)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,486 +0,0 @@
|
|||||||
package v1
|
|
||||||
|
|
||||||
import (
|
|
||||||
"bytes"
|
|
||||||
"context"
|
|
||||||
"crypto/sha256"
|
|
||||||
"encoding/hex"
|
|
||||||
"errors"
|
|
||||||
"fmt"
|
|
||||||
"io"
|
|
||||||
"log/slog"
|
|
||||||
"net/http"
|
|
||||||
"os"
|
|
||||||
"sort"
|
|
||||||
"strings"
|
|
||||||
|
|
||||||
"github.com/go-chi/chi/v5"
|
|
||||||
"github.com/google/uuid"
|
|
||||||
|
|
||||||
"git.unkin.net/unkin/artifactapi/internal/database"
|
|
||||||
"git.unkin.net/unkin/artifactapi/internal/storage"
|
|
||||||
"git.unkin.net/unkin/artifactapi/pkg/models"
|
|
||||||
)
|
|
||||||
|
|
||||||
// This file implements the write half of the Docker Registry HTTP API V2 for
|
|
||||||
// *local* docker repositories, so a `docker push` / `docker pull` against
|
|
||||||
// artifactapi treats a local docker repo as a genuine registry (matching the
|
|
||||||
// project's "local repos are the real thing" principle) rather than a mirror.
|
|
||||||
//
|
|
||||||
// Storage reuses the existing content-addressable primitives:
|
|
||||||
// - blob and manifest bytes are stored via the CAS (deduplicated by sha256)
|
|
||||||
// - a local_files row per (repo, "<image>/blobs/<digest>") and
|
|
||||||
// (repo, "<image>/manifests/<ref>") keeps the blob referenced so the GC
|
|
||||||
// does not reap it, and lets pulls resolve a reference back to a blob.
|
|
||||||
// Tags are mutable references (UpsertLocalFile); digests and blobs are
|
|
||||||
// immutable (CreateLocalFile, tolerating an already-exists on re-push).
|
|
||||||
|
|
||||||
const dockerAPIVersionHeader = "registry/2.0"
|
|
||||||
|
|
||||||
// Chunked blob uploads are staged in object storage under uploads/<uuid> rather
|
|
||||||
// than in process memory, so the POST / PATCH / PUT of a single push can each be
|
|
||||||
// served by a different replica (the API runs with minReplicas>1 and no session
|
|
||||||
// affinity). The upload UUID travels in the Location URL handed back to the
|
|
||||||
// client, so any replica reconstructs the staging key with no shared in-process
|
|
||||||
// state. Abandoned stages are dropped by the GC's uploads sweep.
|
|
||||||
func uploadKey(id string) string { return "uploads/" + id }
|
|
||||||
|
|
||||||
var errUploadUnknown = errors.New("unknown upload")
|
|
||||||
|
|
||||||
// appendUpload appends a chunk to the staged upload object and returns the new
|
|
||||||
// total size. The staged bytes live entirely in object storage (download,
|
|
||||||
// append to a per-request temp file, re-upload), which keeps the session state
|
|
||||||
// replica-independent. Docker sends the whole layer in one PATCH, so this is a
|
|
||||||
// single append in the common case.
|
|
||||||
func (h *ProxyHandler) appendUpload(ctx context.Context, id string, chunk io.Reader) (int64, error) {
|
|
||||||
key := uploadKey(id)
|
|
||||||
reader, info, err := h.store.Download(ctx, key)
|
|
||||||
if err != nil {
|
|
||||||
return 0, errUploadUnknown
|
|
||||||
}
|
|
||||||
|
|
||||||
tmp, err := os.CreateTemp("", "docker-upload-*")
|
|
||||||
if err != nil {
|
|
||||||
reader.Close()
|
|
||||||
return 0, err
|
|
||||||
}
|
|
||||||
defer os.Remove(tmp.Name())
|
|
||||||
defer tmp.Close()
|
|
||||||
|
|
||||||
if _, err := io.Copy(tmp, reader); err != nil {
|
|
||||||
reader.Close()
|
|
||||||
return 0, err
|
|
||||||
}
|
|
||||||
reader.Close()
|
|
||||||
|
|
||||||
n, err := io.Copy(tmp, chunk)
|
|
||||||
if err != nil {
|
|
||||||
return 0, err
|
|
||||||
}
|
|
||||||
size := info.Size + n
|
|
||||||
if _, err := tmp.Seek(0, io.SeekStart); err != nil {
|
|
||||||
return 0, err
|
|
||||||
}
|
|
||||||
if err := h.store.Upload(ctx, key, tmp, size, "application/octet-stream"); err != nil {
|
|
||||||
return 0, err
|
|
||||||
}
|
|
||||||
return size, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// dockerReq is a parsed /v2/<remote>/<image>/... request. kind is one of
|
|
||||||
// "manifest", "blob", "upload", "tags".
|
|
||||||
type dockerReq struct {
|
|
||||||
image string
|
|
||||||
kind string
|
|
||||||
ref string // tag, digest, or upload uuid depending on kind
|
|
||||||
}
|
|
||||||
|
|
||||||
// parseDockerPath splits the chi "*" remainder (everything after the repo name)
|
|
||||||
// into the image name and the registry operation. The image name may itself
|
|
||||||
// contain slashes, so operations are located by their well-known infixes.
|
|
||||||
func parseDockerPath(rest string) (dockerReq, bool) {
|
|
||||||
rest = strings.TrimPrefix(rest, "/")
|
|
||||||
switch {
|
|
||||||
case strings.HasSuffix(rest, "/tags/list"):
|
|
||||||
return dockerReq{image: strings.TrimSuffix(rest, "/tags/list"), kind: "tags"}, true
|
|
||||||
case rest == "tags/list":
|
|
||||||
return dockerReq{}, false // no image
|
|
||||||
}
|
|
||||||
if i := strings.Index(rest, "/blobs/uploads"); i >= 0 {
|
|
||||||
image := rest[:i]
|
|
||||||
ref := strings.TrimPrefix(rest[i+len("/blobs/uploads"):], "/")
|
|
||||||
return dockerReq{image: image, kind: "upload", ref: ref}, image != ""
|
|
||||||
}
|
|
||||||
if i := strings.LastIndex(rest, "/manifests/"); i >= 0 {
|
|
||||||
return dockerReq{image: rest[:i], kind: "manifest", ref: rest[i+len("/manifests/"):]}, true
|
|
||||||
}
|
|
||||||
if i := strings.LastIndex(rest, "/blobs/"); i >= 0 {
|
|
||||||
return dockerReq{image: rest[:i], kind: "blob", ref: rest[i+len("/blobs/"):]}, true
|
|
||||||
}
|
|
||||||
return dockerReq{}, false
|
|
||||||
}
|
|
||||||
|
|
||||||
func isDigest(ref string) bool { return strings.HasPrefix(ref, "sha256:") }
|
|
||||||
|
|
||||||
// localDockerRemote returns the repo if name is a local docker repository.
|
|
||||||
func (h *ProxyHandler) localDockerRemote(r *http.Request, name string) (*models.Remote, bool) {
|
|
||||||
remote, err := h.db.GetRemote(r.Context(), name)
|
|
||||||
if err != nil {
|
|
||||||
return nil, false
|
|
||||||
}
|
|
||||||
return remote, remote.RepoType == models.RepoTypeLocal && remote.PackageType == models.PackageDocker
|
|
||||||
}
|
|
||||||
|
|
||||||
func dockerError(w http.ResponseWriter, status int, code, msg string) {
|
|
||||||
w.Header().Set("Content-Type", "application/json")
|
|
||||||
w.Header().Set("Docker-Distribution-Api-Version", dockerAPIVersionHeader)
|
|
||||||
w.WriteHeader(status)
|
|
||||||
fmt.Fprintf(w, `{"errors":[{"code":%q,"message":%q}]}`, code, msg)
|
|
||||||
}
|
|
||||||
|
|
||||||
// dockerGet dispatches a registry GET to the local handler for local docker
|
|
||||||
// repos and falls through to the upstream proxy for everything else.
|
|
||||||
func (h *ProxyHandler) dockerGet(w http.ResponseWriter, r *http.Request) {
|
|
||||||
name := chi.URLParam(r, "remoteName")
|
|
||||||
if remote, ok := h.localDockerRemote(r, name); ok {
|
|
||||||
h.dockerLocalGet(w, r, remote, false)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
h.handleProxy(w, r)
|
|
||||||
}
|
|
||||||
|
|
||||||
func (h *ProxyHandler) dockerHead(w http.ResponseWriter, r *http.Request) {
|
|
||||||
name := chi.URLParam(r, "remoteName")
|
|
||||||
if remote, ok := h.localDockerRemote(r, name); ok {
|
|
||||||
h.dockerLocalGet(w, r, remote, true)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
h.handleProxyHead(w, r)
|
|
||||||
}
|
|
||||||
|
|
||||||
func (h *ProxyHandler) dockerPost(w http.ResponseWriter, r *http.Request) {
|
|
||||||
name := chi.URLParam(r, "remoteName")
|
|
||||||
remote, ok := h.localDockerRemote(r, name)
|
|
||||||
if !ok {
|
|
||||||
dockerError(w, http.StatusMethodNotAllowed, "UNSUPPORTED", "push is only supported for local docker repositories")
|
|
||||||
return
|
|
||||||
}
|
|
||||||
h.dockerStartUpload(w, r, remote)
|
|
||||||
}
|
|
||||||
|
|
||||||
func (h *ProxyHandler) dockerPatch(w http.ResponseWriter, r *http.Request) {
|
|
||||||
name := chi.URLParam(r, "remoteName")
|
|
||||||
remote, ok := h.localDockerRemote(r, name)
|
|
||||||
if !ok {
|
|
||||||
dockerError(w, http.StatusMethodNotAllowed, "UNSUPPORTED", "push is only supported for local docker repositories")
|
|
||||||
return
|
|
||||||
}
|
|
||||||
h.dockerPatchUpload(w, r, remote)
|
|
||||||
}
|
|
||||||
|
|
||||||
func (h *ProxyHandler) dockerPut(w http.ResponseWriter, r *http.Request) {
|
|
||||||
name := chi.URLParam(r, "remoteName")
|
|
||||||
remote, ok := h.localDockerRemote(r, name)
|
|
||||||
if !ok {
|
|
||||||
dockerError(w, http.StatusMethodNotAllowed, "UNSUPPORTED", "push is only supported for local docker repositories")
|
|
||||||
return
|
|
||||||
}
|
|
||||||
req, ok := parseDockerPath(chi.URLParam(r, "*"))
|
|
||||||
if !ok {
|
|
||||||
dockerError(w, http.StatusNotFound, "NAME_UNKNOWN", "unrecognised registry path")
|
|
||||||
return
|
|
||||||
}
|
|
||||||
switch req.kind {
|
|
||||||
case "upload":
|
|
||||||
h.dockerFinishUpload(w, r, remote, req)
|
|
||||||
case "manifest":
|
|
||||||
h.dockerPutManifest(w, r, remote, req)
|
|
||||||
default:
|
|
||||||
dockerError(w, http.StatusMethodNotAllowed, "UNSUPPORTED", "PUT not supported for this path")
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (h *ProxyHandler) dockerDelete(w http.ResponseWriter, r *http.Request) {
|
|
||||||
name := chi.URLParam(r, "remoteName")
|
|
||||||
remote, ok := h.localDockerRemote(r, name)
|
|
||||||
if !ok {
|
|
||||||
dockerError(w, http.StatusMethodNotAllowed, "UNSUPPORTED", "delete is only supported for local docker repositories")
|
|
||||||
return
|
|
||||||
}
|
|
||||||
req, ok := parseDockerPath(chi.URLParam(r, "*"))
|
|
||||||
if !ok {
|
|
||||||
dockerError(w, http.StatusNotFound, "NAME_UNKNOWN", "unrecognised registry path")
|
|
||||||
return
|
|
||||||
}
|
|
||||||
// Cancel an in-progress upload: drop its staging object.
|
|
||||||
if req.kind == "upload" && req.ref != "" {
|
|
||||||
_ = h.store.Delete(r.Context(), uploadKey(req.ref))
|
|
||||||
w.Header().Set("Docker-Distribution-Api-Version", dockerAPIVersionHeader)
|
|
||||||
w.WriteHeader(http.StatusNoContent)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
if req.kind != "manifest" && req.kind != "blob" {
|
|
||||||
dockerError(w, http.StatusNotFound, "NAME_UNKNOWN", "unrecognised registry path")
|
|
||||||
return
|
|
||||||
}
|
|
||||||
filePath := req.image + "/" + req.kind + "s/" + req.ref
|
|
||||||
if err := h.db.DeleteLocalFile(r.Context(), remote.Name, filePath); err != nil {
|
|
||||||
dockerError(w, http.StatusInternalServerError, "UNKNOWN", err.Error())
|
|
||||||
return
|
|
||||||
}
|
|
||||||
w.Header().Set("Docker-Distribution-Api-Version", dockerAPIVersionHeader)
|
|
||||||
w.WriteHeader(http.StatusAccepted)
|
|
||||||
}
|
|
||||||
|
|
||||||
// dockerLocalGet serves manifest / blob / tags-list reads for a local repo.
|
|
||||||
func (h *ProxyHandler) dockerLocalGet(w http.ResponseWriter, r *http.Request, remote *models.Remote, head bool) {
|
|
||||||
req, ok := parseDockerPath(chi.URLParam(r, "*"))
|
|
||||||
if !ok {
|
|
||||||
dockerError(w, http.StatusNotFound, "NAME_UNKNOWN", "unrecognised registry path")
|
|
||||||
return
|
|
||||||
}
|
|
||||||
switch req.kind {
|
|
||||||
case "tags":
|
|
||||||
h.dockerTagsList(w, r, remote, req.image)
|
|
||||||
case "manifest":
|
|
||||||
h.dockerServeRef(w, r, remote, req.image+"/manifests/"+req.ref, head, true)
|
|
||||||
case "blob":
|
|
||||||
h.dockerServeRef(w, r, remote, req.image+"/blobs/"+req.ref, head, false)
|
|
||||||
default:
|
|
||||||
dockerError(w, http.StatusNotFound, "NAME_UNKNOWN", "unrecognised registry path")
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// dockerServeRef streams the blob backing a local_files path. isManifest
|
|
||||||
// controls only the default content type; the stored blob content type wins.
|
|
||||||
func (h *ProxyHandler) dockerServeRef(w http.ResponseWriter, r *http.Request, remote *models.Remote, filePath string, head, isManifest bool) {
|
|
||||||
file, err := h.db.GetLocalFile(r.Context(), remote.Name, filePath)
|
|
||||||
if err != nil {
|
|
||||||
dockerError(w, http.StatusInternalServerError, "UNKNOWN", err.Error())
|
|
||||||
return
|
|
||||||
}
|
|
||||||
if file == nil {
|
|
||||||
code := "BLOB_UNKNOWN"
|
|
||||||
if isManifest {
|
|
||||||
code = "MANIFEST_UNKNOWN"
|
|
||||||
}
|
|
||||||
dockerError(w, http.StatusNotFound, code, "not found")
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
s3Key := storage.BlobKey(file.ContentHash[len("sha256:"):])
|
|
||||||
reader, info, err := h.store.Download(r.Context(), s3Key)
|
|
||||||
if err != nil {
|
|
||||||
dockerError(w, http.StatusInternalServerError, "UNKNOWN", err.Error())
|
|
||||||
return
|
|
||||||
}
|
|
||||||
defer reader.Close()
|
|
||||||
|
|
||||||
contentType := info.ContentType
|
|
||||||
if contentType == "" {
|
|
||||||
if isManifest {
|
|
||||||
contentType = "application/vnd.docker.distribution.manifest.v2+json"
|
|
||||||
} else {
|
|
||||||
contentType = "application/octet-stream"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
w.Header().Set("Content-Type", contentType)
|
|
||||||
w.Header().Set("Content-Length", fmt.Sprintf("%d", info.Size))
|
|
||||||
w.Header().Set("Docker-Content-Digest", file.ContentHash)
|
|
||||||
w.Header().Set("Docker-Distribution-Api-Version", dockerAPIVersionHeader)
|
|
||||||
w.Header().Set("X-Artifact-Source", "local")
|
|
||||||
if head {
|
|
||||||
w.WriteHeader(http.StatusOK)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
w.WriteHeader(http.StatusOK)
|
|
||||||
io.Copy(w, reader)
|
|
||||||
}
|
|
||||||
|
|
||||||
func (h *ProxyHandler) dockerTagsList(w http.ResponseWriter, r *http.Request, remote *models.Remote, image string) {
|
|
||||||
prefix := image + "/manifests/"
|
|
||||||
files, err := h.db.ListLocalFilesByPrefix(r.Context(), remote.Name, prefix)
|
|
||||||
if err != nil {
|
|
||||||
dockerError(w, http.StatusInternalServerError, "UNKNOWN", err.Error())
|
|
||||||
return
|
|
||||||
}
|
|
||||||
tags := []string{}
|
|
||||||
for _, f := range files {
|
|
||||||
ref := strings.TrimPrefix(f.FilePath, prefix)
|
|
||||||
if ref == "" || isDigest(ref) {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
tags = append(tags, ref)
|
|
||||||
}
|
|
||||||
sort.Strings(tags)
|
|
||||||
w.Header().Set("Content-Type", "application/json")
|
|
||||||
w.Header().Set("Docker-Distribution-Api-Version", dockerAPIVersionHeader)
|
|
||||||
w.WriteHeader(http.StatusOK)
|
|
||||||
fmt.Fprintf(w, `{"name":%q,"tags":`, remote.Name+"/"+image)
|
|
||||||
writeJSONStringList(w, tags)
|
|
||||||
fmt.Fprint(w, "}")
|
|
||||||
}
|
|
||||||
|
|
||||||
func writeJSONStringList(w io.Writer, items []string) {
|
|
||||||
fmt.Fprint(w, "[")
|
|
||||||
for i, s := range items {
|
|
||||||
if i > 0 {
|
|
||||||
fmt.Fprint(w, ",")
|
|
||||||
}
|
|
||||||
fmt.Fprintf(w, "%q", s)
|
|
||||||
}
|
|
||||||
fmt.Fprint(w, "]")
|
|
||||||
}
|
|
||||||
|
|
||||||
// dockerStartUpload begins a blob upload. It honours a monolithic
|
|
||||||
// POST?digest=... (blob in the POST body) and otherwise opens a chunked
|
|
||||||
// session, returning its Location for the client's PATCH/PUT.
|
|
||||||
func (h *ProxyHandler) dockerStartUpload(w http.ResponseWriter, r *http.Request, remote *models.Remote) {
|
|
||||||
req, ok := parseDockerPath(chi.URLParam(r, "*"))
|
|
||||||
if !ok || req.kind != "upload" {
|
|
||||||
dockerError(w, http.StatusNotFound, "NAME_UNKNOWN", "unrecognised registry path")
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
if digest := r.URL.Query().Get("digest"); digest != "" {
|
|
||||||
h.dockerCommitBlob(w, r, remote, req.image, digest, r.Body)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
// Stage an empty object keyed by the upload UUID; PATCH/PUT append to it.
|
|
||||||
id := uuid.NewString()
|
|
||||||
if err := h.store.Upload(r.Context(), uploadKey(id), bytes.NewReader(nil), 0, "application/octet-stream"); err != nil {
|
|
||||||
dockerError(w, http.StatusInternalServerError, "UNKNOWN", err.Error())
|
|
||||||
return
|
|
||||||
}
|
|
||||||
loc := fmt.Sprintf("/v2/%s/%s/blobs/uploads/%s", remote.Name, req.image, id)
|
|
||||||
w.Header().Set("Location", loc)
|
|
||||||
w.Header().Set("Docker-Upload-UUID", id)
|
|
||||||
w.Header().Set("Range", "0-0")
|
|
||||||
w.Header().Set("Docker-Distribution-Api-Version", dockerAPIVersionHeader)
|
|
||||||
w.WriteHeader(http.StatusAccepted)
|
|
||||||
}
|
|
||||||
|
|
||||||
func (h *ProxyHandler) dockerPatchUpload(w http.ResponseWriter, r *http.Request, remote *models.Remote) {
|
|
||||||
req, ok := parseDockerPath(chi.URLParam(r, "*"))
|
|
||||||
if !ok || req.kind != "upload" || req.ref == "" {
|
|
||||||
dockerError(w, http.StatusNotFound, "BLOB_UPLOAD_UNKNOWN", "unknown upload")
|
|
||||||
return
|
|
||||||
}
|
|
||||||
size, err := h.appendUpload(r.Context(), req.ref, r.Body)
|
|
||||||
if err != nil {
|
|
||||||
if errors.Is(err, errUploadUnknown) {
|
|
||||||
dockerError(w, http.StatusNotFound, "BLOB_UPLOAD_UNKNOWN", "unknown upload")
|
|
||||||
return
|
|
||||||
}
|
|
||||||
dockerError(w, http.StatusInternalServerError, "UNKNOWN", err.Error())
|
|
||||||
return
|
|
||||||
}
|
|
||||||
loc := fmt.Sprintf("/v2/%s/%s/blobs/uploads/%s", remote.Name, req.image, req.ref)
|
|
||||||
w.Header().Set("Location", loc)
|
|
||||||
w.Header().Set("Docker-Upload-UUID", req.ref)
|
|
||||||
w.Header().Set("Range", fmt.Sprintf("0-%d", size-1))
|
|
||||||
w.Header().Set("Docker-Distribution-Api-Version", dockerAPIVersionHeader)
|
|
||||||
w.WriteHeader(http.StatusAccepted)
|
|
||||||
}
|
|
||||||
|
|
||||||
// dockerFinishUpload completes a chunked upload: appends any final PUT body,
|
|
||||||
// stores the assembled blob, and verifies its digest.
|
|
||||||
func (h *ProxyHandler) dockerFinishUpload(w http.ResponseWriter, r *http.Request, remote *models.Remote, req dockerReq) {
|
|
||||||
digest := r.URL.Query().Get("digest")
|
|
||||||
if digest == "" {
|
|
||||||
dockerError(w, http.StatusBadRequest, "DIGEST_INVALID", "digest query parameter required")
|
|
||||||
return
|
|
||||||
}
|
|
||||||
if req.ref == "" {
|
|
||||||
// Monolithic PUT with no prior session: body is the whole blob.
|
|
||||||
h.dockerCommitBlob(w, r, remote, req.image, digest, r.Body)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
key := uploadKey(req.ref)
|
|
||||||
reader, _, err := h.store.Download(r.Context(), key)
|
|
||||||
if err != nil {
|
|
||||||
dockerError(w, http.StatusNotFound, "BLOB_UPLOAD_UNKNOWN", "unknown upload")
|
|
||||||
return
|
|
||||||
}
|
|
||||||
defer reader.Close()
|
|
||||||
// Drop the staging object once we're done, regardless of outcome; a fresh
|
|
||||||
// context so cleanup still runs if the client disconnects.
|
|
||||||
defer h.store.Delete(context.Background(), key)
|
|
||||||
|
|
||||||
// Stream the staged bytes plus any trailing PUT body through the CAS in one
|
|
||||||
// pass — no extra round trip to re-assemble.
|
|
||||||
combined := io.MultiReader(reader, r.Body)
|
|
||||||
h.dockerCommitBlob(w, r, remote, req.image, digest, combined)
|
|
||||||
}
|
|
||||||
|
|
||||||
// dockerCommitBlob stores blob bytes through the CAS, verifies the client's
|
|
||||||
// declared digest, and records the per-image local_files reference.
|
|
||||||
func (h *ProxyHandler) dockerCommitBlob(w http.ResponseWriter, r *http.Request, remote *models.Remote, image, digest string, body io.Reader) {
|
|
||||||
result, err := h.cas.Store(r.Context(), body, "application/octet-stream")
|
|
||||||
if err != nil {
|
|
||||||
dockerError(w, http.StatusInternalServerError, "UNKNOWN", fmt.Sprintf("store failed: %v", err))
|
|
||||||
return
|
|
||||||
}
|
|
||||||
if result.ContentHash != digest {
|
|
||||||
dockerError(w, http.StatusBadRequest, "DIGEST_INVALID", fmt.Sprintf("digest mismatch: got %s, declared %s", result.ContentHash, digest))
|
|
||||||
return
|
|
||||||
}
|
|
||||||
if err := h.db.UpsertBlob(r.Context(), result.ContentHash, result.S3Key, result.SizeBytes, "application/octet-stream"); err != nil {
|
|
||||||
dockerError(w, http.StatusInternalServerError, "UNKNOWN", err.Error())
|
|
||||||
return
|
|
||||||
}
|
|
||||||
if err := h.db.CreateLocalFile(r.Context(), remote.Name, image+"/blobs/"+digest, result.ContentHash); err != nil && !errors.Is(err, database.ErrAlreadyExists) {
|
|
||||||
dockerError(w, http.StatusInternalServerError, "UNKNOWN", err.Error())
|
|
||||||
return
|
|
||||||
}
|
|
||||||
w.Header().Set("Location", fmt.Sprintf("/v2/%s/%s/blobs/%s", remote.Name, image, digest))
|
|
||||||
w.Header().Set("Docker-Content-Digest", digest)
|
|
||||||
w.Header().Set("Docker-Distribution-Api-Version", dockerAPIVersionHeader)
|
|
||||||
w.WriteHeader(http.StatusCreated)
|
|
||||||
}
|
|
||||||
|
|
||||||
// dockerPutManifest stores a manifest and points its reference (tag or digest)
|
|
||||||
// at it. Tags are mutable so a re-push moves the tag; digests are immutable.
|
|
||||||
func (h *ProxyHandler) dockerPutManifest(w http.ResponseWriter, r *http.Request, remote *models.Remote, req dockerReq) {
|
|
||||||
body, err := io.ReadAll(r.Body)
|
|
||||||
if err != nil {
|
|
||||||
dockerError(w, http.StatusInternalServerError, "UNKNOWN", err.Error())
|
|
||||||
return
|
|
||||||
}
|
|
||||||
contentType := r.Header.Get("Content-Type")
|
|
||||||
if contentType == "" {
|
|
||||||
contentType = "application/vnd.docker.distribution.manifest.v2+json"
|
|
||||||
}
|
|
||||||
sum := sha256.Sum256(body)
|
|
||||||
digest := "sha256:" + hex.EncodeToString(sum[:])
|
|
||||||
|
|
||||||
result, err := h.cas.Store(r.Context(), strings.NewReader(string(body)), contentType)
|
|
||||||
if err != nil {
|
|
||||||
dockerError(w, http.StatusInternalServerError, "UNKNOWN", fmt.Sprintf("store failed: %v", err))
|
|
||||||
return
|
|
||||||
}
|
|
||||||
if err := h.db.UpsertBlob(r.Context(), result.ContentHash, result.S3Key, result.SizeBytes, contentType); err != nil {
|
|
||||||
dockerError(w, http.StatusInternalServerError, "UNKNOWN", err.Error())
|
|
||||||
return
|
|
||||||
}
|
|
||||||
// Always addressable by digest (immutable).
|
|
||||||
if err := h.db.CreateLocalFile(r.Context(), remote.Name, req.image+"/manifests/"+digest, result.ContentHash); err != nil && !errors.Is(err, database.ErrAlreadyExists) {
|
|
||||||
dockerError(w, http.StatusInternalServerError, "UNKNOWN", err.Error())
|
|
||||||
return
|
|
||||||
}
|
|
||||||
// If pushed under a tag, (re)point the tag at this manifest.
|
|
||||||
if !isDigest(req.ref) {
|
|
||||||
if err := h.db.UpsertLocalFile(r.Context(), remote.Name, req.image+"/manifests/"+req.ref, result.ContentHash); err != nil {
|
|
||||||
dockerError(w, http.StatusInternalServerError, "UNKNOWN", err.Error())
|
|
||||||
return
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
slog.Info("local docker manifest pushed", "repo", remote.Name, "image", req.image, "ref", req.ref, "digest", digest)
|
|
||||||
w.Header().Set("Location", fmt.Sprintf("/v2/%s/%s/manifests/%s", remote.Name, req.image, req.ref))
|
|
||||||
w.Header().Set("Docker-Content-Digest", digest)
|
|
||||||
w.Header().Set("Docker-Distribution-Api-Version", dockerAPIVersionHeader)
|
|
||||||
w.WriteHeader(http.StatusCreated)
|
|
||||||
}
|
|
||||||
@@ -1,50 +0,0 @@
|
|||||||
package v1
|
|
||||||
|
|
||||||
import "testing"
|
|
||||||
|
|
||||||
func TestParseDockerPath(t *testing.T) {
|
|
||||||
tests := []struct {
|
|
||||||
name string
|
|
||||||
rest string
|
|
||||||
wantOK bool
|
|
||||||
wantImage string
|
|
||||||
wantKind string
|
|
||||||
wantRef string
|
|
||||||
}{
|
|
||||||
{"start upload trailing slash", "team/app/blobs/uploads/", true, "team/app", "upload", ""},
|
|
||||||
{"start upload no slash", "team/app/blobs/uploads", true, "team/app", "upload", ""},
|
|
||||||
{"patch upload with uuid", "team/app/blobs/uploads/abc-123", true, "team/app", "upload", "abc-123"},
|
|
||||||
{"single-segment image upload", "app/blobs/uploads/", true, "app", "upload", ""},
|
|
||||||
{"blob by digest", "team/app/blobs/sha256:deadbeef", true, "team/app", "blob", "sha256:deadbeef"},
|
|
||||||
{"manifest by tag", "team/app/manifests/v1.0.0", true, "team/app", "manifest", "v1.0.0"},
|
|
||||||
{"manifest by digest", "team/app/manifests/sha256:cafe", true, "team/app", "manifest", "sha256:cafe"},
|
|
||||||
{"tags list", "team/app/tags/list", true, "team/app", "tags", ""},
|
|
||||||
{"leading slash tolerated", "/team/app/manifests/latest", true, "team/app", "manifest", "latest"},
|
|
||||||
{"deep image name", "a/b/c/manifests/latest", true, "a/b/c", "manifest", "latest"},
|
|
||||||
{"unrecognised", "team/app/whatever", false, "", "", ""},
|
|
||||||
{"tags list without image", "tags/list", false, "", "", ""},
|
|
||||||
}
|
|
||||||
for _, tc := range tests {
|
|
||||||
t.Run(tc.name, func(t *testing.T) {
|
|
||||||
got, ok := parseDockerPath(tc.rest)
|
|
||||||
if ok != tc.wantOK {
|
|
||||||
t.Fatalf("ok = %v, want %v", ok, tc.wantOK)
|
|
||||||
}
|
|
||||||
if !tc.wantOK {
|
|
||||||
return
|
|
||||||
}
|
|
||||||
if got.image != tc.wantImage || got.kind != tc.wantKind || got.ref != tc.wantRef {
|
|
||||||
t.Fatalf("got %+v, want image=%q kind=%q ref=%q", got, tc.wantImage, tc.wantKind, tc.wantRef)
|
|
||||||
}
|
|
||||||
})
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func TestIsDigest(t *testing.T) {
|
|
||||||
if !isDigest("sha256:abc") {
|
|
||||||
t.Fatal("sha256: prefix should be a digest")
|
|
||||||
}
|
|
||||||
if isDigest("v1.0.0") {
|
|
||||||
t.Fatal("a tag is not a digest")
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,260 +0,0 @@
|
|||||||
package v1
|
|
||||||
|
|
||||||
import (
|
|
||||||
"bytes"
|
|
||||||
"errors"
|
|
||||||
"fmt"
|
|
||||||
"io"
|
|
||||||
"log/slog"
|
|
||||||
"net/http"
|
|
||||||
|
|
||||||
"github.com/go-chi/chi/v5"
|
|
||||||
|
|
||||||
v2 "git.unkin.net/unkin/artifactapi/internal/api/v2"
|
|
||||||
"git.unkin.net/unkin/artifactapi/internal/database"
|
|
||||||
"git.unkin.net/unkin/artifactapi/internal/provider"
|
|
||||||
"git.unkin.net/unkin/artifactapi/internal/proxy"
|
|
||||||
"git.unkin.net/unkin/artifactapi/internal/storage"
|
|
||||||
"git.unkin.net/unkin/artifactapi/internal/virtual"
|
|
||||||
)
|
|
||||||
|
|
||||||
type ProxyHandler struct {
|
|
||||||
engine *proxy.Engine
|
|
||||||
virtualEngine *virtual.Engine
|
|
||||||
db *database.DB
|
|
||||||
store *storage.S3
|
|
||||||
local *v2.LocalHandler
|
|
||||||
cas *storage.CAS
|
|
||||||
}
|
|
||||||
|
|
||||||
func NewProxyHandler(engine *proxy.Engine, virtualEngine *virtual.Engine, db *database.DB, store *storage.S3, local *v2.LocalHandler) *ProxyHandler {
|
|
||||||
return &ProxyHandler{
|
|
||||||
engine: engine,
|
|
||||||
virtualEngine: virtualEngine,
|
|
||||||
db: db,
|
|
||||||
store: store,
|
|
||||||
local: local,
|
|
||||||
cas: storage.NewCAS(store),
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (h *ProxyHandler) Routes() chi.Router {
|
|
||||||
r := chi.NewRouter()
|
|
||||||
r.Get("/remote/{remoteName}/*", h.handleProxy)
|
|
||||||
r.Get("/local/{localName}/*", h.handleLocal)
|
|
||||||
r.Get("/virtual/{virtualName}/*", h.handleVirtual)
|
|
||||||
return r
|
|
||||||
}
|
|
||||||
|
|
||||||
// DockerV2Routes mounts the Docker Registry HTTP API V2. Reads (GET/HEAD)
|
|
||||||
// dispatch to a local registry implementation for local docker repos and fall
|
|
||||||
// through to the upstream proxy otherwise; writes (POST/PATCH/PUT/DELETE) are
|
|
||||||
// only valid for local docker repos and drive push.
|
|
||||||
func (h *ProxyHandler) DockerV2Routes() chi.Router {
|
|
||||||
r := chi.NewRouter()
|
|
||||||
r.Get("/", h.handleDockerPing)
|
|
||||||
r.Head("/", h.handleDockerPing)
|
|
||||||
r.Get("/{remoteName}/*", h.dockerGet)
|
|
||||||
r.Head("/{remoteName}/*", h.dockerHead)
|
|
||||||
r.Post("/{remoteName}/*", h.dockerPost)
|
|
||||||
r.Patch("/{remoteName}/*", h.dockerPatch)
|
|
||||||
r.Put("/{remoteName}/*", h.dockerPut)
|
|
||||||
r.Delete("/{remoteName}/*", h.dockerDelete)
|
|
||||||
return r
|
|
||||||
}
|
|
||||||
|
|
||||||
func (h *ProxyHandler) handleDockerPing(w http.ResponseWriter, r *http.Request) {
|
|
||||||
w.Header().Set("Docker-Distribution-Api-Version", "registry/2.0")
|
|
||||||
w.WriteHeader(http.StatusOK)
|
|
||||||
}
|
|
||||||
|
|
||||||
func (h *ProxyHandler) handleProxy(w http.ResponseWriter, r *http.Request) {
|
|
||||||
remoteName := chi.URLParam(r, "remoteName")
|
|
||||||
path := chi.URLParam(r, "*")
|
|
||||||
|
|
||||||
remote, err := h.db.GetRemote(r.Context(), remoteName)
|
|
||||||
if err != nil {
|
|
||||||
http.Error(w, fmt.Sprintf("remote %q not found", remoteName), http.StatusNotFound)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
prov, err := provider.Get(remote.PackageType)
|
|
||||||
if err != nil {
|
|
||||||
http.Error(w, fmt.Sprintf("no provider for %q", remote.PackageType), http.StatusInternalServerError)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
// Metadata-only remotes (e.g. github_rpm) synthesize their own responses and
|
|
||||||
// redirect package downloads to a backend remote instead of proxying bytes.
|
|
||||||
if rs, ok := prov.(provider.RemoteServer); ok {
|
|
||||||
proxyBaseURL := fmt.Sprintf("%s://%s", scheme(r), r.Host)
|
|
||||||
if rs.ServeRemote(w, r, *remote, path, proxyBaseURL, h.db) {
|
|
||||||
return
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
result, err := h.engine.Fetch(r.Context(), *remote, path, prov, r.Header)
|
|
||||||
if err != nil {
|
|
||||||
var proxyErr *proxy.ProxyError
|
|
||||||
if errors.As(err, &proxyErr) {
|
|
||||||
http.Error(w, proxyErr.Message, proxyErr.Status)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
slog.Error("proxy fetch failed", "remote", remoteName, "path", path, "error", err)
|
|
||||||
http.Error(w, "bad gateway", http.StatusBadGateway)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
defer result.Reader.Close()
|
|
||||||
|
|
||||||
var body io.Reader = result.Reader
|
|
||||||
if sr, ok := prov.(provider.ServeRewriter); ok && prov.Classify(path) == provider.Mutable {
|
|
||||||
raw, err := io.ReadAll(result.Reader)
|
|
||||||
if err != nil {
|
|
||||||
http.Error(w, "bad gateway", http.StatusBadGateway)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
raw = sr.RewriteServed(raw, *remote, fmt.Sprintf("%s://%s", scheme(r), r.Host))
|
|
||||||
body, result.Size = bytes.NewReader(raw), int64(len(raw))
|
|
||||||
}
|
|
||||||
|
|
||||||
w.Header().Set("Content-Type", result.ContentType)
|
|
||||||
w.Header().Set("X-Artifact-Source", result.Source)
|
|
||||||
if result.Size > 0 {
|
|
||||||
w.Header().Set("X-Artifact-Size", fmt.Sprintf("%d", result.Size))
|
|
||||||
}
|
|
||||||
w.WriteHeader(http.StatusOK)
|
|
||||||
io.Copy(w, body)
|
|
||||||
}
|
|
||||||
|
|
||||||
func (h *ProxyHandler) handleProxyHead(w http.ResponseWriter, r *http.Request) {
|
|
||||||
remoteName := chi.URLParam(r, "remoteName")
|
|
||||||
path := chi.URLParam(r, "*")
|
|
||||||
|
|
||||||
remote, err := h.db.GetRemote(r.Context(), remoteName)
|
|
||||||
if err != nil {
|
|
||||||
http.Error(w, fmt.Sprintf("remote %q not found", remoteName), http.StatusNotFound)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
prov, err := provider.Get(remote.PackageType)
|
|
||||||
if err != nil {
|
|
||||||
http.Error(w, fmt.Sprintf("no provider for %q", remote.PackageType), http.StatusInternalServerError)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
result, err := h.engine.Head(r.Context(), *remote, path, prov)
|
|
||||||
if err != nil {
|
|
||||||
var proxyErr *proxy.ProxyError
|
|
||||||
if errors.As(err, &proxyErr) {
|
|
||||||
http.Error(w, proxyErr.Message, proxyErr.Status)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
slog.Error("proxy head failed", "remote", remoteName, "path", path, "error", err)
|
|
||||||
http.Error(w, "bad gateway", http.StatusBadGateway)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
w.Header().Set("Content-Type", result.ContentType)
|
|
||||||
w.Header().Set("X-Artifact-Source", result.Source)
|
|
||||||
if result.Size > 0 {
|
|
||||||
w.Header().Set("Content-Length", fmt.Sprintf("%d", result.Size))
|
|
||||||
}
|
|
||||||
w.WriteHeader(http.StatusOK)
|
|
||||||
}
|
|
||||||
|
|
||||||
func (h *ProxyHandler) handleVirtual(w http.ResponseWriter, r *http.Request) {
|
|
||||||
virtualName := chi.URLParam(r, "virtualName")
|
|
||||||
path := chi.URLParam(r, "*")
|
|
||||||
|
|
||||||
virt, err := h.db.GetVirtual(r.Context(), virtualName)
|
|
||||||
if err != nil {
|
|
||||||
http.Error(w, fmt.Sprintf("virtual %q not found", virtualName), http.StatusNotFound)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
proxyBaseURL := fmt.Sprintf("%s://%s", scheme(r), r.Host)
|
|
||||||
|
|
||||||
loc, ok, err := h.virtualEngine.MemberRedirect(r.Context(), *virt, path, r.URL.RawQuery, proxyBaseURL)
|
|
||||||
if err != nil {
|
|
||||||
http.Error(w, err.Error(), http.StatusBadRequest)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
if ok {
|
|
||||||
http.Redirect(w, r, loc, http.StatusFound)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
body, contentType, err := h.virtualEngine.Fetch(r.Context(), *virt, path, proxyBaseURL)
|
|
||||||
if errors.Is(err, virtual.ErrNotFound) {
|
|
||||||
http.Error(w, "not found", http.StatusNotFound)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
if err != nil {
|
|
||||||
slog.Error("virtual fetch failed", "virtual", virtualName, "path", path, "error", err)
|
|
||||||
http.Error(w, "bad gateway", http.StatusBadGateway)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
w.Header().Set("Content-Type", contentType)
|
|
||||||
w.Header().Set("X-Artifact-Source", "virtual")
|
|
||||||
w.WriteHeader(http.StatusOK)
|
|
||||||
w.Write(body)
|
|
||||||
}
|
|
||||||
|
|
||||||
func (h *ProxyHandler) handleLocal(w http.ResponseWriter, r *http.Request) {
|
|
||||||
localName := chi.URLParam(r, "localName")
|
|
||||||
path := chi.URLParam(r, "*")
|
|
||||||
|
|
||||||
remote, err := h.db.GetRemote(r.Context(), localName)
|
|
||||||
if err != nil {
|
|
||||||
http.Error(w, fmt.Sprintf("local %q not found", localName), http.StatusNotFound)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
prov, _ := provider.Get(remote.PackageType)
|
|
||||||
if indexer, ok := prov.(provider.LocalIndexer); ok {
|
|
||||||
if indexer.ServeLocalIndex(w, r, h.db, remote.Name, path) {
|
|
||||||
return
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
h.serveLocalFile(w, r, localName, path)
|
|
||||||
}
|
|
||||||
|
|
||||||
func (h *ProxyHandler) serveLocalFile(w http.ResponseWriter, r *http.Request, repoName, path string) {
|
|
||||||
file, err := h.db.GetLocalFile(r.Context(), repoName, path)
|
|
||||||
if err != nil {
|
|
||||||
slog.Error("local file lookup failed", "repo", repoName, "path", path, "error", err)
|
|
||||||
http.Error(w, "internal error", http.StatusInternalServerError)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
if file == nil {
|
|
||||||
http.Error(w, "not found", http.StatusNotFound)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
s3Key := storage.BlobKey(file.ContentHash[len("sha256:"):])
|
|
||||||
reader, info, err := h.store.Download(r.Context(), s3Key)
|
|
||||||
if err != nil {
|
|
||||||
slog.Error("local file download failed", "repo", repoName, "path", path, "error", err)
|
|
||||||
http.Error(w, "internal error", http.StatusInternalServerError)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
defer reader.Close()
|
|
||||||
|
|
||||||
w.Header().Set("Content-Type", info.ContentType)
|
|
||||||
w.Header().Set("Content-Length", fmt.Sprintf("%d", info.Size))
|
|
||||||
w.Header().Set("X-Artifact-Source", "local")
|
|
||||||
w.WriteHeader(http.StatusOK)
|
|
||||||
io.Copy(w, reader)
|
|
||||||
}
|
|
||||||
|
|
||||||
func scheme(r *http.Request) string {
|
|
||||||
if r.TLS != nil {
|
|
||||||
return "https"
|
|
||||||
}
|
|
||||||
if fwd := r.Header.Get("X-Forwarded-Proto"); fwd != "" {
|
|
||||||
return fwd
|
|
||||||
}
|
|
||||||
return "http"
|
|
||||||
}
|
|
||||||
@@ -1,20 +0,0 @@
|
|||||||
package v1
|
|
||||||
|
|
||||||
import (
|
|
||||||
"crypto/tls"
|
|
||||||
"net/http"
|
|
||||||
"testing"
|
|
||||||
)
|
|
||||||
|
|
||||||
func TestScheme(t *testing.T) {
|
|
||||||
if got := scheme(&http.Request{TLS: &tls.ConnectionState{}}); got != "https" {
|
|
||||||
t.Errorf("TLS request scheme = %q, want https", got)
|
|
||||||
}
|
|
||||||
r := &http.Request{Header: http.Header{"X-Forwarded-Proto": {"https"}}}
|
|
||||||
if got := scheme(r); got != "https" {
|
|
||||||
t.Errorf("X-Forwarded-Proto scheme = %q, want https", got)
|
|
||||||
}
|
|
||||||
if got := scheme(&http.Request{Header: http.Header{}}); got != "http" {
|
|
||||||
t.Errorf("default scheme = %q, want http", got)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,130 +0,0 @@
|
|||||||
package v2
|
|
||||||
|
|
||||||
import (
|
|
||||||
"context"
|
|
||||||
"io"
|
|
||||||
"net/http"
|
|
||||||
"net/http/httptest"
|
|
||||||
"os"
|
|
||||||
"strings"
|
|
||||||
"testing"
|
|
||||||
|
|
||||||
"git.unkin.net/unkin/artifactapi/internal/database"
|
|
||||||
"git.unkin.net/unkin/artifactapi/internal/testsupport"
|
|
||||||
)
|
|
||||||
|
|
||||||
var testDSN string
|
|
||||||
|
|
||||||
func TestMain(m *testing.M) {
|
|
||||||
ctx := context.Background()
|
|
||||||
dsn, terminate, err := testsupport.StartPostgres(ctx)
|
|
||||||
if err != nil {
|
|
||||||
os.Exit(m.Run())
|
|
||||||
}
|
|
||||||
testDSN = dsn
|
|
||||||
code := m.Run()
|
|
||||||
terminate()
|
|
||||||
if code != 0 {
|
|
||||||
os.Exit(code)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// closedDB returns a DB whose pool has been closed, so every query fails —
|
|
||||||
// used to drive the handlers' error branches.
|
|
||||||
func closedDB(t *testing.T) *database.DB {
|
|
||||||
t.Helper()
|
|
||||||
if testDSN == "" {
|
|
||||||
t.Skip("Docker unavailable")
|
|
||||||
}
|
|
||||||
db, err := database.New(testDSN)
|
|
||||||
if err != nil {
|
|
||||||
t.Fatalf("new db: %v", err)
|
|
||||||
}
|
|
||||||
db.Close()
|
|
||||||
return db
|
|
||||||
}
|
|
||||||
|
|
||||||
func do(t *testing.T, h http.Handler, method, path, body string) int {
|
|
||||||
t.Helper()
|
|
||||||
var r io.Reader
|
|
||||||
if body != "" {
|
|
||||||
r = strings.NewReader(body)
|
|
||||||
}
|
|
||||||
req := httptest.NewRequest(method, path, r)
|
|
||||||
w := httptest.NewRecorder()
|
|
||||||
h.ServeHTTP(w, req)
|
|
||||||
return w.Code
|
|
||||||
}
|
|
||||||
|
|
||||||
func TestRemotesErrorPaths(t *testing.T) {
|
|
||||||
h := NewRemotesHandler(closedDB(t), nil, nil).Routes()
|
|
||||||
if c := do(t, h, "GET", "/", ""); c != 500 {
|
|
||||||
t.Errorf("list with dead db = %d, want 500", c)
|
|
||||||
}
|
|
||||||
if c := do(t, h, "POST", "/", `{"name":"x","package_type":"generic","repo_type":"remote","base_url":"https://x"}`); c != 500 {
|
|
||||||
t.Errorf("create with dead db = %d, want 500", c)
|
|
||||||
}
|
|
||||||
if c := do(t, h, "PUT", "/x", `{"package_type":"generic","base_url":"https://x"}`); c != 500 {
|
|
||||||
t.Errorf("update with dead db = %d, want 500", c)
|
|
||||||
}
|
|
||||||
if c := do(t, h, "GET", "/x", ""); c != 404 {
|
|
||||||
t.Errorf("get missing = %d, want 404", c)
|
|
||||||
}
|
|
||||||
if c := do(t, h, "DELETE", "/x", ""); c != 500 {
|
|
||||||
t.Errorf("delete with dead db = %d, want 500", c)
|
|
||||||
}
|
|
||||||
// Bad request bodies never reach the db.
|
|
||||||
if c := do(t, h, "POST", "/", `not json`); c != 400 {
|
|
||||||
t.Errorf("invalid json = %d, want 400", c)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func TestVirtualsErrorPaths(t *testing.T) {
|
|
||||||
h := NewVirtualsHandler(closedDB(t)).Routes()
|
|
||||||
if c := do(t, h, "GET", "/", ""); c != 500 {
|
|
||||||
t.Errorf("list = %d, want 500", c)
|
|
||||||
}
|
|
||||||
if c := do(t, h, "GET", "/x", ""); c != 404 {
|
|
||||||
t.Errorf("get missing = %d, want 404", c)
|
|
||||||
}
|
|
||||||
if c := do(t, h, "POST", "/", `{"name":"v","package_type":"helm","members":["a"]}`); c != 500 {
|
|
||||||
t.Errorf("create = %d, want 500", c)
|
|
||||||
}
|
|
||||||
if c := do(t, h, "PUT", "/v", `{"package_type":"helm","members":["a"]}`); c != 500 {
|
|
||||||
t.Errorf("update = %d, want 500", c)
|
|
||||||
}
|
|
||||||
if c := do(t, h, "DELETE", "/v", ""); c != 500 {
|
|
||||||
t.Errorf("delete = %d, want 500", c)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func TestStatsErrorPaths(t *testing.T) {
|
|
||||||
h := NewStatsHandler(closedDB(t)).Routes()
|
|
||||||
for _, p := range []string{"/", "/top-remotes", "/top-files-by-hits", "/top-files-by-bandwidth"} {
|
|
||||||
if c := do(t, h, "GET", p, ""); c != 500 {
|
|
||||||
t.Errorf("stats %s = %d, want 500", p, c)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func TestLocalErrorPaths(t *testing.T) {
|
|
||||||
h := NewLocalHandler(closedDB(t), nil).Routes()
|
|
||||||
// GetRemote fails on the closed db -> not found.
|
|
||||||
if c := do(t, h, "PUT", "/x/files/a.bin", "data"); c != 404 {
|
|
||||||
t.Errorf("upload unknown repo = %d, want 404", c)
|
|
||||||
}
|
|
||||||
// download / remove hit the db and 500.
|
|
||||||
if c := do(t, h, "GET", "/x/files/a.bin", ""); c != 500 {
|
|
||||||
t.Errorf("download = %d, want 500", c)
|
|
||||||
}
|
|
||||||
if c := do(t, h, "DELETE", "/x/files/a.bin", ""); c != 500 {
|
|
||||||
t.Errorf("remove = %d, want 500", c)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func TestLocalHandlerDBAccessor(t *testing.T) {
|
|
||||||
db := closedDB(t)
|
|
||||||
if NewLocalHandler(db, nil).DB() != db {
|
|
||||||
t.Error("DB() should return the handler's database")
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,49 +0,0 @@
|
|||||||
package v2
|
|
||||||
|
|
||||||
import (
|
|
||||||
"fmt"
|
|
||||||
"net/http"
|
|
||||||
"time"
|
|
||||||
|
|
||||||
"github.com/go-chi/chi/v5"
|
|
||||||
)
|
|
||||||
|
|
||||||
type EventsHandler struct{}
|
|
||||||
|
|
||||||
func NewEventsHandler() *EventsHandler {
|
|
||||||
return &EventsHandler{}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (h *EventsHandler) Routes() chi.Router {
|
|
||||||
r := chi.NewRouter()
|
|
||||||
r.Get("/", h.stream)
|
|
||||||
return r
|
|
||||||
}
|
|
||||||
|
|
||||||
func (h *EventsHandler) stream(w http.ResponseWriter, r *http.Request) {
|
|
||||||
flusher, ok := w.(http.Flusher)
|
|
||||||
if !ok {
|
|
||||||
http.Error(w, "streaming not supported", http.StatusInternalServerError)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
w.Header().Set("Content-Type", "text/event-stream")
|
|
||||||
w.Header().Set("Cache-Control", "no-cache")
|
|
||||||
w.Header().Set("Connection", "keep-alive")
|
|
||||||
w.Header().Set("X-Accel-Buffering", "no")
|
|
||||||
w.WriteHeader(http.StatusOK)
|
|
||||||
flusher.Flush()
|
|
||||||
|
|
||||||
ticker := time.NewTicker(30 * time.Second)
|
|
||||||
defer ticker.Stop()
|
|
||||||
|
|
||||||
for {
|
|
||||||
select {
|
|
||||||
case <-r.Context().Done():
|
|
||||||
return
|
|
||||||
case <-ticker.C:
|
|
||||||
fmt.Fprintf(w, ": keepalive\n\n")
|
|
||||||
flusher.Flush()
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,43 +0,0 @@
|
|||||||
package v2
|
|
||||||
|
|
||||||
import (
|
|
||||||
"net/http"
|
|
||||||
|
|
||||||
"github.com/go-chi/chi/v5"
|
|
||||||
|
|
||||||
"git.unkin.net/unkin/artifactapi/internal/cache"
|
|
||||||
"git.unkin.net/unkin/artifactapi/internal/database"
|
|
||||||
"git.unkin.net/unkin/artifactapi/internal/storage"
|
|
||||||
)
|
|
||||||
|
|
||||||
type HealthHandler struct {
|
|
||||||
db *database.DB
|
|
||||||
cache *cache.Redis
|
|
||||||
store *storage.S3
|
|
||||||
}
|
|
||||||
|
|
||||||
func NewHealthHandler(db *database.DB, c *cache.Redis, s *storage.S3) *HealthHandler {
|
|
||||||
return &HealthHandler{db: db, cache: c, store: s}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (h *HealthHandler) Routes() chi.Router {
|
|
||||||
r := chi.NewRouter()
|
|
||||||
r.Get("/", h.health)
|
|
||||||
return r
|
|
||||||
}
|
|
||||||
|
|
||||||
func (h *HealthHandler) health(w http.ResponseWriter, r *http.Request) {
|
|
||||||
status := map[string]string{
|
|
||||||
"status": "ok",
|
|
||||||
"postgres": "ok",
|
|
||||||
"redis": "ok",
|
|
||||||
"s3": "ok",
|
|
||||||
}
|
|
||||||
|
|
||||||
if err := h.db.Pool.Ping(r.Context()); err != nil {
|
|
||||||
status["postgres"] = "error"
|
|
||||||
status["status"] = "degraded"
|
|
||||||
}
|
|
||||||
|
|
||||||
writeJSON(w, http.StatusOK, status)
|
|
||||||
}
|
|
||||||
@@ -1,227 +0,0 @@
|
|||||||
package v2
|
|
||||||
|
|
||||||
import (
|
|
||||||
"context"
|
|
||||||
"errors"
|
|
||||||
"fmt"
|
|
||||||
"io"
|
|
||||||
"net/http"
|
|
||||||
|
|
||||||
"github.com/go-chi/chi/v5"
|
|
||||||
|
|
||||||
"git.unkin.net/unkin/artifactapi/internal/database"
|
|
||||||
"git.unkin.net/unkin/artifactapi/internal/provider"
|
|
||||||
"git.unkin.net/unkin/artifactapi/internal/storage"
|
|
||||||
"git.unkin.net/unkin/artifactapi/pkg/models"
|
|
||||||
)
|
|
||||||
|
|
||||||
type LocalHandler struct {
|
|
||||||
db *database.DB
|
|
||||||
store *storage.S3
|
|
||||||
cas *storage.CAS
|
|
||||||
}
|
|
||||||
|
|
||||||
func NewLocalHandler(db *database.DB, store *storage.S3) *LocalHandler {
|
|
||||||
return &LocalHandler{
|
|
||||||
db: db,
|
|
||||||
store: store,
|
|
||||||
cas: storage.NewCAS(store),
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (h *LocalHandler) Routes() chi.Router {
|
|
||||||
r := chi.NewRouter()
|
|
||||||
r.Put("/*", h.upload)
|
|
||||||
r.Get("/*", h.download)
|
|
||||||
r.Delete("/*", h.remove)
|
|
||||||
return r
|
|
||||||
}
|
|
||||||
|
|
||||||
func (h *LocalHandler) upload(w http.ResponseWriter, r *http.Request) {
|
|
||||||
repoName := chi.URLParam(r, "name")
|
|
||||||
filePath := chi.URLParam(r, "*")
|
|
||||||
|
|
||||||
if filePath == "" {
|
|
||||||
http.Error(w, "file path required", http.StatusBadRequest)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
remote, err := h.db.GetRemote(r.Context(), repoName)
|
|
||||||
if err != nil {
|
|
||||||
http.Error(w, fmt.Sprintf("remote %q not found", repoName), http.StatusNotFound)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
if remote.RepoType != models.RepoTypeLocal {
|
|
||||||
http.Error(w, "upload only allowed for local repository types", http.StatusBadRequest)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
prov, _ := provider.Get(remote.PackageType)
|
|
||||||
|
|
||||||
if uploader, ok := prov.(provider.LocalUploader); ok {
|
|
||||||
h.uploadValidated(w, r, remote, filePath, prov, uploader)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
h.uploadGeneric(w, r, remote, filePath)
|
|
||||||
}
|
|
||||||
|
|
||||||
func (h *LocalHandler) uploadValidated(w http.ResponseWriter, r *http.Request, remote *models.Remote, filePath string, prov provider.Provider, uploader provider.LocalUploader) {
|
|
||||||
storagePath, contentType, err := uploader.ValidateUpload(filePath)
|
|
||||||
if err != nil {
|
|
||||||
http.Error(w, err.Error(), http.StatusBadRequest)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
existing, err := h.db.GetLocalFile(r.Context(), remote.Name, storagePath)
|
|
||||||
if err != nil {
|
|
||||||
http.Error(w, err.Error(), http.StatusInternalServerError)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
if existing != nil {
|
|
||||||
http.Error(w, fmt.Sprintf("file %q already exists; overwrites are not allowed", storagePath), http.StatusConflict)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
result, err := h.cas.Store(r.Context(), r.Body, contentType)
|
|
||||||
if err != nil {
|
|
||||||
http.Error(w, fmt.Sprintf("store failed: %v", err), http.StatusInternalServerError)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
if err := h.db.UpsertBlob(r.Context(), result.ContentHash, result.S3Key, result.SizeBytes, contentType); err != nil {
|
|
||||||
http.Error(w, fmt.Sprintf("record blob: %v", err), http.StatusInternalServerError)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
if err := h.db.CreateLocalFile(r.Context(), remote.Name, storagePath, result.ContentHash); err != nil {
|
|
||||||
if errors.Is(err, database.ErrAlreadyExists) {
|
|
||||||
http.Error(w, fmt.Sprintf("file %q already exists; overwrites are not allowed", storagePath), http.StatusConflict)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
http.Error(w, fmt.Sprintf("record file: %v", err), http.StatusInternalServerError)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
if hook, ok := prov.(provider.PostUploadHook); ok {
|
|
||||||
go hook.AfterUpload(context.Background(), remote.Name, storagePath, result.ContentHash, h, h.db)
|
|
||||||
}
|
|
||||||
|
|
||||||
writeJSON(w, http.StatusCreated, uploader.UploadResponse(storagePath, result.ContentHash, result.SizeBytes))
|
|
||||||
}
|
|
||||||
|
|
||||||
func (h *LocalHandler) uploadGeneric(w http.ResponseWriter, r *http.Request, remote *models.Remote, filePath string) {
|
|
||||||
existing, err := h.db.GetLocalFile(r.Context(), remote.Name, filePath)
|
|
||||||
if err != nil {
|
|
||||||
http.Error(w, err.Error(), http.StatusInternalServerError)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
if existing != nil {
|
|
||||||
http.Error(w, fmt.Sprintf("file %q already exists; overwrites are not allowed", filePath), http.StatusConflict)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
contentType := "application/octet-stream"
|
|
||||||
if ct := r.Header.Get("Content-Type"); ct != "" && ct != "application/octet-stream" {
|
|
||||||
contentType = ct
|
|
||||||
}
|
|
||||||
|
|
||||||
result, err := h.cas.Store(r.Context(), r.Body, contentType)
|
|
||||||
if err != nil {
|
|
||||||
http.Error(w, fmt.Sprintf("store failed: %v", err), http.StatusInternalServerError)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
if err := h.db.UpsertBlob(r.Context(), result.ContentHash, result.S3Key, result.SizeBytes, contentType); err != nil {
|
|
||||||
http.Error(w, fmt.Sprintf("record blob: %v", err), http.StatusInternalServerError)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
if err := h.db.CreateLocalFile(r.Context(), remote.Name, filePath, result.ContentHash); err != nil {
|
|
||||||
if errors.Is(err, database.ErrAlreadyExists) {
|
|
||||||
http.Error(w, fmt.Sprintf("file %q already exists; overwrites are not allowed", filePath), http.StatusConflict)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
http.Error(w, fmt.Sprintf("record file: %v", err), http.StatusInternalServerError)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
writeJSON(w, http.StatusCreated, map[string]any{
|
|
||||||
"path": filePath,
|
|
||||||
"content_hash": result.ContentHash,
|
|
||||||
"size_bytes": result.SizeBytes,
|
|
||||||
})
|
|
||||||
}
|
|
||||||
|
|
||||||
func (h *LocalHandler) download(w http.ResponseWriter, r *http.Request) {
|
|
||||||
repoName := chi.URLParam(r, "name")
|
|
||||||
filePath := chi.URLParam(r, "*")
|
|
||||||
|
|
||||||
file, err := h.db.GetLocalFile(r.Context(), repoName, filePath)
|
|
||||||
if err != nil {
|
|
||||||
http.Error(w, err.Error(), http.StatusInternalServerError)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
if file == nil {
|
|
||||||
http.Error(w, "not found", http.StatusNotFound)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
s3Key := storage.BlobKey(file.ContentHash[len("sha256:"):])
|
|
||||||
reader, info, err := h.store.Download(r.Context(), s3Key)
|
|
||||||
if err != nil {
|
|
||||||
http.Error(w, fmt.Sprintf("download failed: %v", err), http.StatusInternalServerError)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
defer reader.Close()
|
|
||||||
|
|
||||||
w.Header().Set("Content-Type", info.ContentType)
|
|
||||||
w.Header().Set("Content-Length", fmt.Sprintf("%d", info.Size))
|
|
||||||
w.WriteHeader(http.StatusOK)
|
|
||||||
io.Copy(w, reader)
|
|
||||||
}
|
|
||||||
|
|
||||||
func (h *LocalHandler) remove(w http.ResponseWriter, r *http.Request) {
|
|
||||||
repoName := chi.URLParam(r, "name")
|
|
||||||
filePath := chi.URLParam(r, "*")
|
|
||||||
|
|
||||||
if err := deleteLocalFile(r.Context(), h.db, repoName, filePath); err != nil {
|
|
||||||
http.Error(w, err.Error(), http.StatusInternalServerError)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
w.WriteHeader(http.StatusNoContent)
|
|
||||||
}
|
|
||||||
|
|
||||||
// deleteLocalFile removes a local file and runs the provider's post-delete hook,
|
|
||||||
// so provider-derived state (e.g. RPM metadata that feeds generated repodata)
|
|
||||||
// stops referencing a package that no longer exists.
|
|
||||||
func deleteLocalFile(ctx context.Context, db *database.DB, repoName, filePath string) error {
|
|
||||||
if err := db.DeleteLocalFile(ctx, repoName, filePath); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
|
|
||||||
remote, err := db.GetRemote(ctx, repoName)
|
|
||||||
if err != nil {
|
|
||||||
return nil // file is gone; no repo left to resolve a cleanup hook from
|
|
||||||
}
|
|
||||||
prov, err := provider.Get(remote.PackageType)
|
|
||||||
if err != nil {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
if hook, ok := prov.(provider.PostDeleteHook); ok {
|
|
||||||
return hook.AfterDelete(ctx, repoName, filePath, db)
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (h *LocalHandler) DB() *database.DB {
|
|
||||||
return h.db
|
|
||||||
}
|
|
||||||
|
|
||||||
func (h *LocalHandler) Download(ctx context.Context, key string) (io.ReadCloser, int64, error) {
|
|
||||||
reader, info, err := h.store.Download(ctx, key)
|
|
||||||
if err != nil {
|
|
||||||
return nil, 0, err
|
|
||||||
}
|
|
||||||
return reader, info.Size, nil
|
|
||||||
}
|
|
||||||
@@ -1,75 +0,0 @@
|
|||||||
package v2
|
|
||||||
|
|
||||||
import (
|
|
||||||
"context"
|
|
||||||
"net/http/httptest"
|
|
||||||
"testing"
|
|
||||||
|
|
||||||
"github.com/go-chi/chi/v5"
|
|
||||||
|
|
||||||
"git.unkin.net/unkin/artifactapi/internal/database"
|
|
||||||
"git.unkin.net/unkin/artifactapi/internal/provider"
|
|
||||||
_ "git.unkin.net/unkin/artifactapi/internal/provider/rpm" // register the rpm provider so its PostDeleteHook runs
|
|
||||||
"git.unkin.net/unkin/artifactapi/pkg/models"
|
|
||||||
)
|
|
||||||
|
|
||||||
// TestLocalEvictCleansRPMMetadata verifies that evicting an RPM from a local
|
|
||||||
// repo also removes the derived rpm_metadata row, so generated repodata stops
|
|
||||||
// listing the deleted package.
|
|
||||||
func TestLocalEvictCleansRPMMetadata(t *testing.T) {
|
|
||||||
if testDSN == "" {
|
|
||||||
t.Skip("Docker unavailable")
|
|
||||||
}
|
|
||||||
ctx := context.Background()
|
|
||||||
db, err := database.New(testDSN)
|
|
||||||
if err != nil {
|
|
||||||
t.Fatal(err)
|
|
||||||
}
|
|
||||||
defer db.Close()
|
|
||||||
|
|
||||||
const repo = "rpm-evict-cleanup"
|
|
||||||
if err := db.CreateRemote(ctx, &models.Remote{Name: repo, PackageType: models.PackageRPM, RepoType: models.RepoTypeLocal}); err != nil {
|
|
||||||
t.Fatal(err)
|
|
||||||
}
|
|
||||||
|
|
||||||
const hash = "sha256:bb22"
|
|
||||||
const path = "Packages/example-0.1.0-1.x86_64.rpm"
|
|
||||||
if err := db.UpsertBlob(ctx, hash, "blobs/bb/22", 2048, "application/x-rpm"); err != nil {
|
|
||||||
t.Fatal(err)
|
|
||||||
}
|
|
||||||
if err := db.CreateLocalFile(ctx, repo, path, hash); err != nil {
|
|
||||||
t.Fatal(err)
|
|
||||||
}
|
|
||||||
if err := db.InsertRPMMetadata(ctx, &provider.RPMMetadata{
|
|
||||||
RepoName: repo, FilePath: path, ContentHash: hash,
|
|
||||||
Name: "example", Version: "0.1.0", Release: "1", Arch: "x86_64",
|
|
||||||
Requires: []provider.RPMDep{}, Provides: []provider.RPMDep{},
|
|
||||||
Files: []provider.RPMFile{}, Changelogs: []provider.RPMChangelog{},
|
|
||||||
}); err != nil {
|
|
||||||
t.Fatal(err)
|
|
||||||
}
|
|
||||||
|
|
||||||
h := NewObjectsHandler(db)
|
|
||||||
router := chi.NewRouter()
|
|
||||||
router.Route("/locals/{name}/objects", func(r chi.Router) {
|
|
||||||
r.Delete("/*", h.LocalRoutes().ServeHTTP)
|
|
||||||
})
|
|
||||||
|
|
||||||
del := httptest.NewRequest("DELETE", "/locals/"+repo+"/objects/"+path, nil)
|
|
||||||
dw := httptest.NewRecorder()
|
|
||||||
router.ServeHTTP(dw, del)
|
|
||||||
if dw.Code != 204 {
|
|
||||||
t.Fatalf("evict = %d, want 204", dw.Code)
|
|
||||||
}
|
|
||||||
|
|
||||||
if f, _ := db.GetLocalFile(ctx, repo, path); f != nil {
|
|
||||||
t.Fatalf("local file still present after evict: %+v", f)
|
|
||||||
}
|
|
||||||
entries, err := db.ListRPMMetadataEntries(ctx, repo)
|
|
||||||
if err != nil {
|
|
||||||
t.Fatal(err)
|
|
||||||
}
|
|
||||||
if len(entries) != 0 {
|
|
||||||
t.Fatalf("rpm_metadata still present after evict: %+v", entries)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,88 +0,0 @@
|
|||||||
package v2
|
|
||||||
|
|
||||||
import (
|
|
||||||
"context"
|
|
||||||
"net/http"
|
|
||||||
"net/http/httptest"
|
|
||||||
"strings"
|
|
||||||
"testing"
|
|
||||||
"time"
|
|
||||||
|
|
||||||
"github.com/go-chi/chi/v5"
|
|
||||||
|
|
||||||
"git.unkin.net/unkin/artifactapi/internal/database"
|
|
||||||
"git.unkin.net/unkin/artifactapi/internal/storage"
|
|
||||||
"git.unkin.net/unkin/artifactapi/internal/testsupport"
|
|
||||||
"git.unkin.net/unkin/artifactapi/pkg/models"
|
|
||||||
)
|
|
||||||
|
|
||||||
// TestLocalUploadStoreFailure covers the upload handlers' store-error branches
|
|
||||||
// by killing the object store after a successful upload.
|
|
||||||
func TestLocalUploadStoreFailure(t *testing.T) {
|
|
||||||
if testDSN == "" {
|
|
||||||
t.Skip("Docker unavailable")
|
|
||||||
}
|
|
||||||
ctx := context.Background()
|
|
||||||
db, err := database.New(testDSN)
|
|
||||||
if err != nil {
|
|
||||||
t.Fatal(err)
|
|
||||||
}
|
|
||||||
defer db.Close()
|
|
||||||
|
|
||||||
conn, termMinio, err := testsupport.StartMinio(ctx)
|
|
||||||
if err != nil {
|
|
||||||
t.Skip("minio unavailable")
|
|
||||||
}
|
|
||||||
var store *storage.S3
|
|
||||||
for i := 0; i < 20; i++ {
|
|
||||||
if store, err = storage.NewS3(conn.Endpoint, conn.AccessKey, conn.SecretKey, "fault", false, ""); err == nil {
|
|
||||||
break
|
|
||||||
}
|
|
||||||
time.Sleep(500 * time.Millisecond)
|
|
||||||
}
|
|
||||||
if err != nil {
|
|
||||||
termMinio()
|
|
||||||
t.Fatal(err)
|
|
||||||
}
|
|
||||||
|
|
||||||
for _, pt := range []models.PackageType{models.PackageGeneric, models.PackagePyPI} {
|
|
||||||
if err := db.CreateRemote(ctx, &models.Remote{Name: "fault-" + string(pt), PackageType: pt, RepoType: models.RepoTypeLocal}); err != nil {
|
|
||||||
t.Fatal(err)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
h := NewLocalHandler(db, store)
|
|
||||||
router := chi.NewRouter()
|
|
||||||
router.Route("/remotes/{name}/files", func(r chi.Router) {
|
|
||||||
r.Put("/*", h.Routes().ServeHTTP)
|
|
||||||
})
|
|
||||||
srv := httptest.NewServer(router)
|
|
||||||
defer srv.Close()
|
|
||||||
|
|
||||||
put := func(name, path, body string) int {
|
|
||||||
rq, _ := http.NewRequest("PUT", srv.URL+"/remotes/"+name+"/files/"+path, strings.NewReader(body))
|
|
||||||
resp, err := http.DefaultClient.Do(rq)
|
|
||||||
if err != nil {
|
|
||||||
t.Fatalf("put: %v", err)
|
|
||||||
}
|
|
||||||
resp.Body.Close()
|
|
||||||
return resp.StatusCode
|
|
||||||
}
|
|
||||||
|
|
||||||
// Sanity: uploads succeed while the store is up.
|
|
||||||
if c := put("fault-generic", "ok.bin", "data"); c != 201 {
|
|
||||||
t.Fatalf("generic upload while up = %d", c)
|
|
||||||
}
|
|
||||||
if c := put("fault-pypi", "foo-1.0-py3-none-any.whl", "wheel"); c != 201 {
|
|
||||||
t.Fatalf("pypi upload while up = %d", c)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Kill the store; subsequent CAS.Store calls fail -> 500.
|
|
||||||
termMinio()
|
|
||||||
if c := put("fault-generic", "after.bin", "data"); c != 500 {
|
|
||||||
t.Errorf("generic upload after store down = %d, want 500", c)
|
|
||||||
}
|
|
||||||
if c := put("fault-pypi", "bar-1.0-py3-none-any.whl", "wheel"); c != 500 {
|
|
||||||
t.Errorf("pypi upload after store down = %d, want 500", c)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user