Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tchoupinax/fuzzy-engine
Docker registry UI made with love.
https://github.com/tchoupinax/fuzzy-engine
docker docker-registry ecr ui
Last synced: about 1 month ago
JSON representation
Docker registry UI made with love.
- Host: GitHub
- URL: https://github.com/tchoupinax/fuzzy-engine
- Owner: Tchoupinax
- License: mit
- Created: 2020-05-04T17:13:49.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-12-30T03:22:11.000Z (about 1 month ago)
- Last Synced: 2024-12-30T04:23:43.941Z (about 1 month ago)
- Topics: docker, docker-registry, ecr, ui
- Language: Vue
- Homepage: https://fuzzy-engine.corentinfiloche.xyz
- Size: 4.99 MB
- Stars: 10
- Watchers: 3
- Forks: 0
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# fuzzy-engine 🐳
Fuzzy engine a is beautiful ✨ and simple 🐹 UI for your [private Docker registry](https://hub.docker.com/_/registry) or another registries.
List of supporting docker registry:
- [x] Self hostable registry
- [x] AWS ECR
- [x] With API keys
- [x] With local authentication (CLI)
- [x] Github Container Registry
- [x] Dockerhub
- [ ] Google Cloud
**demo**: https://fuzzy-engine.corentinfiloche.xyz
## Getting started
The best way to use and to deploy the UI is with Docker.
```
docker run -d -p 3000:3000 tchoupinax/fuzzy-engine
```
### Authentication to ECR using AWS local authentication
In a company enterprise, you are logged to your ECR with the AWS cli. Fuzzy-engine support this authentication.
When you logged in, the cli exposed three environment variables to your shell
- AWS_ACCESS_KEY_ID
- AWS_SECRET_ACCESS_KEY
- AWS_SESSION_TOKEN
Fuzzy-engine will simply use them for talking with AWS api.
If you use a Docker image, you have to share these variable by the following way
```
docker run -d \
-p 3000:3000 \
-e AWS_ACCESS_KEY_ID=$AWS_ACCESS_KEY_ID \
-e AWS_SECRET_ACCESS_KEY=$AWS_SECRET_ACCESS_KEY \
-e AWS_SESSION_TOKEN=$AWS_SESSION_TOKEN \
tchoupinax/fuzzy-engine
```
### FAQ
#### How it works ?
You set your credentials with the form on the home page. Then, they are kept in a cookie. **Not elsewhere**. These credentials are used to request your registry.
#### Why this is not an SPA ?
The docker registy [image](https://hub.docker.com/_/registry) does not allow cross-origin request, so browser prevents from making the requests. The only solution is to make requests backend side.
### Screenshots 🖼
Home page
List of your repositories
List of the digests (with tags) for one repository
#### Built with
- [Nuxt.js 3](https://nuxtjs.org/) - Vue.js framework
- [Tailwindcss](https://tailwindcss.com/) - Utility-first CSS framework
## Docker informations
### Trigger the garbage collector
```bash
docker exec -it container-name bin/registry garbage-collect /etc/docker/registry/config.yml
```