Add readme
All checks were successful
Gitea/docker-debmirror/pipeline/head This commit looks good

This commit is contained in:
dave 2022-09-28 22:44:34 -07:00
parent d68fbc2232
commit 6bab95c962

36
README.md Normal file
View File

@ -0,0 +1,36 @@
docker-debmirror
================
Runs the `debmirror` utility and cron under docker.
Usage
-----
* Mount the data volume at `/data`. Packages and other data will be kept here. Packages & indexes will be kept in the
`files` subdirectory.
* Set any of the below options as environment variables in the container to further configure the mirror.
Options
-------
These environment variables configure the mirror and container. Defaults are shown
* `MIRROR_UID=1000` - filesystem uid for mirrored files
* `MIRROR_GID=1000` - filesystem gid for mirrored files
* `MIRROR_ARCH=amd64` - architectures to mirror
* `MIRROR_SECTION=main,restricted,universe,multiverse` - sections to mirror
* `MIRROR_RELEASE=jammy,jammy-security,jammy-updates,jammy-backports` - releases to mirror
* `MIRROR_SERVER=archive.ubuntu.com` - mirroring source server
* `MIRROR_PROTO=http` - mirring protocol
* `MIRROR_CRON="8 4 * * *"` - cron expression for mirroring job
TODO
----
- Have the container kill itself if the cronjob fails?