initialize wiki with homepage

2026-08-12 09:31:46 +00:00
commit 6d6310dec3
1 changed files with 52 additions and 0 deletions
@@ -0,0 +1,52 @@
+# aptly-containerized
+
+[aptly](https://www.aptly.info/) (Debian repository management) as a container image,
+Docker Compose stacks (test + production), and a Helm chart — built so that aptly can
+be **configured through Helm especially easily** and deployed at **any security
+level**, from completely open to fully authenticated.
+
+## What's in here
+
+| | |
+|---|---|
+| `images/aptly-server/` | aptly, cross-compiled from source, non-root, minimal footprint |
+| `images/aptly-deb-builder/` | packaging image: build a `.deb` (nfpm or `dpkg-buildpackage`) and push it, in one step |
+| `compose/` | test stack (one command, wide open) and a production stack (auth, healthchecks, backup) |
+| `charts/aptly/` | Helm chart, aptly-native (no library-chart dependency) |
+| `rootfs/usr/local/bin/` | the scripts shared by both worlds (Compose + Helm) — config rendering, declarative state, push helpers |
+| `action.yaml` | reusable Gitea Action: build + push a package in three lines |
+| `.gitea/workflows/` | CI, independent image/chart releases, weekly CVE rebuild |
+
+## Quickstart
+
+```bash
+docker compose -f compose/docker-compose.test.yaml up -d --build
+curl http://localhost:8080/api/ready
+```
+
+Details and the production path: [Quickstart Compose](quickstart#compose).
+
+```bash
+helm install aptly oci://git.morlana.online/f.weber/aptly --version <version>
+```
+
+Details: [Quickstart Helm](quickstart#helm).
+
+## Keeping itself current
+
+`renovate.json` tracks `aptly-dev/aptly`, `mikefarah/yq`, `goreleaser/nfpm`, and the
+base images via PR. `.gitea/workflows/rebuild.yaml` rebuilds weekly (Debian CVEs in
+the base images) even when aptly itself hasn't changed, and reports on itself (a
+Gitea issue) if a run goes missing.
+
+## Verification
+
+```bash
+make lint   # hadolint, shellcheck, helm lint, helm template over every ci/*.yaml
+make test   # tests/smoke-test.sh — pack -> push -> publish -> a real apt-get, the merge gate
+```
+
+## License
+
+MIT, see [LICENSE](https://git.morlana.online/f.weber/aptly-containerized/src/branch/main/LICENSE). Includes/uses aptly, nginx, and nFPM — see
+[NOTICE.md](https://git.morlana.online/f.weber/aptly-containerized/src/branch/main/NOTICE.md).