Roadmap & changelog
Entrepot is being built in phases.
Phase 1 — core
Section titled “Phase 1 — core”- Single Go binary: format endpoints, management API, embedded React UI, background maintenance.
- Postgres metadata. Content-addressed blob stores:
file(PVC/EBS/EFS) ands3. Each repository picks its own store. - Formats: raw, PyPI, npm, Docker/OCI, each hosted + proxy + group.
- Authentication: Keycloak/OIDC login and bearer tokens, GitLab CI/CD id_tokens with trust policies, API tokens, service accounts, bootstrap token. RBAC with roles and bindings. Audit log.
- OpenAPI 3 spec with Swagger UI (
/api/docs) and a generated Go client (pkg/client). - Helm chart (EBS / EFS / S3 examples, IRSA), Dockerfile, docker compose dev stack with Keycloak and MinIO, CI with a kind smoke test.
Phase 2 — more formats and the scanning pipeline
Section titled “Phase 2 — more formats and the scanning pipeline”- Apt: hosted, with generated
Packages/Releaseand a signedInRelease/Release.gpg; proxy. - Yum/RPM: hosted, with createrepo-compatible repodata and a signed
repomd.xml; proxy. - Helm: HTTP repositories (hosted with the ChartMuseum API, proxy, group).
- Signing keys per repository, managed by Entrepot, with rotation and import.
- Scanning pipeline: Trivy, Grype and webhook scanners; a Postgres job queue; warn or quarantine policies with waivers; scheduled rescans; a separate scan-worker image and Deployment; GitLab commit statuses and MR notes.
- Cleanup policies (age, downloads, regex, prerelease, keep-latest, untagged Docker manifests) with preview and a scheduled run.
- Routing rules for proxies, and prefer-hosted groups against dependency confusion.
- Secrets at rest: AES-GCM encryption of proxy passwords, S3 keys, scanner secrets and signing keys, with key rotation.
- Usage metrics: a dashboard home page, per-repository usage charts and Prometheus counters, an activity log of downloads, uploads and deletes, and audit-log search with CSV export.
- Releases: multi-arch server and scanner images and an OCI Helm chart published to GHCR on version tags.
Follow-ups
Section titled “Follow-ups”- Apt/Yum group repositories (these need re-signing of merged metadata).
- Signing individual RPM packages, not just repository metadata.
- Kubernetes Job scanner driver (one Job per scan).
- Filtering npm/PyPI search results by prefer-hosted.
Phase 3 — Terraform / OpenTofu provider
Section titled “Phase 3 — Terraform / OpenTofu provider”terraform-provider-entrepot, built on
terraform-plugin-framework, published as entrepotproj/entrepot to the
Terraform and OpenTofu registries:
- resources for blob stores, repositories, roles and bindings, GitLab trust policies, service accounts and tokens, signing keys, scanners, waivers, cleanup policies and routing rules;
- data sources and import support;
- acceptance tests against a server started in CI.
The management API is designed for it: every object has a stable name or ID, PUT replaces mutable fields, write-only secrets are never returned, and the immutable fields (format, kind, blob store) map to “requires replacement”.