Dockerfile Registry WebUI 之 docker-registry-frontend 基础应用

  简介

  docker-registry-frontend是一个基于浏览器的解决方案，用于浏览和修改私有仓库信息。

  docker-registry-frontend已于四五年前停止更新，但其功能仍能满足一般应用。

  docker-registry-frontend的最新版本仅支持Docker Registry V2版本。

  搭建应用，只需从Docker Hub拉取konradkleine/docker-registry-frontend:v2镜像即可。

  Github源码地址：https://github.com/kwk/docker-registry-frontend。

  启动参数

  docker-registry-frontend作为镜像，允许使用docker run启动，在启动时，允许添加自定义参数，用来对应用进行配置。

  1) ENV_DOCKER_REGISTRY_HOST

  用于指定私有仓库的主机地址，例如：192.168.20.53。

  2) ENV_DOCKER_REGISTRY_PORT

  用于指定私有仓库的端口号，例如：9011。

  3) ENV_DOCKER_REGISTRY_USE_SSL

  若私有仓库仅允许HTTPS协议连接，这需设置ENV_DOCKER_REGISTRY_USE_SSL=1。

  4) ENV_USE_SSL

  若需应用以HTTPS开放服务，配置ENV_USE_SSL=yes即可。

  5) ENV_MODE_BROWSE_ONLY

  启动容器时，设置ENV_MODE_BROWSE_ONLY=true，用于应用只读模式，将不能对镜像库或标签进行管理的权限。

  6) ENV_DEFAULT_REPOSITORIES_PER_PAGE

  默认情况下，每页显示20个镜像库，若有自定义需求，则需设置ENV_DEFAULT_REPOSITORIES_PER_PAGE=20。

  7) ENV_DEFAULT_TAGS_PER_PAGE

  默认情况下，每页显示10个标签，若有自定义需求，则需设置ENV_DEFAULT_TAGS_PER_PAGE=20。

  简单示例

  · 私有仓库搭建可以参照Dockerfile Registry私服搭建及镜像上传，本文使用已有的仓库http://192.168.20.53:5000。

  · 拉取应用镜像。

docker pull konradkleine/docker-registry-frontend:v2

  · 以最简单形式启动容器。

  1) 指定konradkleine/docker-registry-frontend:v2启动容器。

docker run \
  	-d \
  	-e ENV_DOCKER_REGISTRY_HOST=192.168.20.53 \
  	-e ENV_DOCKER_REGISTRY_PORT=5000 \
  	-p 9011:80 \
  	konradkleine/docker-registry-frontend:v2

  默认情况下，docker-registry-frontend应用端口为80，需要映射为宿主机端口9011，9011可根据自身情况进行修改。

  2) 访问http://192.168.20.50:9011/，确认应用是否可用。

  3) 点击"Browse repositories"查看私有仓库信息。

  docker-registry-frontend提供的功能很简单，只是查看和维护镜像信息，默认启动时，并没有开启维护功能，只能查看。可以在启动时通过ENV_MODE_BROWSE_ONLY=true来开启应用管理镜像的功能。

  总结

  Docker Registry提供了镜像管理功能，但其基于命令行的方式很不友好，在实际使用过程中，学习成本、管理效率、管理准确度都很难保证。这才有了Docker Resgitry WebUI的出现，主要是为帮助镜像维护者提供了更简单、便捷的工具。

  docker-registry-frontend仅提供管理功能，涉及到镜像存储依然由Docker Registry来负责，因此搭建docker-registry-frontend时，需要首先搭建Docker Registry，具体可参考：

  《Dockerfile Registry私服搭建及镜像上传》

  《Dockerfile Registry 配置HTTPS服务》

  若文中存在错误和不足，欢迎指正！