Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ngc7331/docker-registry
An unofficial docker registry image based on s6-overlay.
https://github.com/ngc7331/docker-registry
Last synced: 13 days ago
JSON representation
An unofficial docker registry image based on s6-overlay.
- Host: GitHub
- URL: https://github.com/ngc7331/docker-registry
- Owner: ngc7331
- Created: 2022-09-02T09:11:22.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-10-08T05:20:09.000Z (4 months ago)
- Last Synced: 2024-11-19T09:52:54.410Z (3 months ago)
- Language: Makefile
- Homepage: https://hub.docker.com/r/ngc7331/registry
- Size: 60.5 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# docker-registry
An unofficial docker registry image based on s6-overlay.
## Default version
Just a registry.
Uses cron task to do garbage-collection everyday (also removes all untagged images).
## Skopeo version
A registry with built-in skopeo, see their repo [here](https://github.com/containers/skopeo).
Uses cron task to run `skopeo sync` hourly.
## Usage
```sh
docker run -d --name docker-registry \
-p 5000:5000 \
-v your/path/to/data:/data \
-v your/path/to/config:/config \
-e AUTH_USER=username \
-e AUTH_PASS=password \
ngc7331/registry:
```
Notes:
- Replace `your/path/to/xxx` with your actual path
- Replace `username` and `password` with some hard-to-guess string, this will be used for client's `docker login`
- Replace `` with latest or any valid tag, checkout [tags](https://hub.docker.com/r/ngc7331/registry/tags) on Docker Hub
## Configuration file
The first time the container is run, the following files and directories are generated in `/config`:
```
/config
├── auth
│ └── htpasswd
├── registry
│ └── config.yml
└── skopeo
└── config.yml
```
### `auth/htpasswd`
This is generated from environment variable `AUTH_USER` and `AUTH_PASS`, which was set by `docker run -e`.
**DO NOT MODIFY THIS FILE DIRECTLY**.
If you want to change the username or password, just recreate the container with new env.
### `registry/config.yml`
Defines the registry.
See [official docs](https://docs.docker.com/registry/configuration/).
### `skopeo/config.yml`
(skopeo version only)
Defines the images that will be synchronized.
See [official docs](https://github.com/containers/skopeo/blob/main/docs/skopeo-sync.1.md#yaml-file-content-used-source-for---src-yaml).
## Known issue
### Registry v2 bug with multi-arch garbage-collection
See https://github.com/distribution/distribution/issues/3178
This bug is fixed in v3.0.0, but it's still in beta. You can use `ngc7331/registry:nightly[-skopeo]` (or explicitly `ngc7331/registry:3.0.0-beta.1[-skopeo1.15.1]`) as a workaround. `ngc7331/registry:latest[-skopeo]` will be updated to v3.0.0 once it's stable, and `ngc7331/registry:nightly[-skopeo]` will **no longer be updated** at that time.
If you're still using `ngc7331/registry:latest[-skopeo]`, you can disable multi-arch support by setting `SKOPEO_MULTIARCH=false`, this is also the default behavior now. If `SKOPEO_MULTIARCH=true`, garbage-collection will be disabled automatically.