kinesis/registry

kinesis/registry 镜像文档

镜像概述

https://registry.hub.docker.com/u/kinesis/registry/ 是一个基于 https://github.com/docker/distribution 源码构建的私有Docker镜像仓库。与官方镜像相比，其核心差异在于不通过容器内引导Go构建环境，而是通过本地交叉编译生成registry二进制文件后打包进容器，从而大幅减小容器体积（从约580MB降至190MB）。

核心功能和特性

• 高效构建：使用 https://github.com/mitchellh/gox 交叉编译Linux AMD64架构的registry二进制文件
• 组件集成：内置nginx 1.9.1和supervisor进程管理工具
• 代理配置：反向代理主registry服务器；将/health/路径代理至调试服务器的/debug/health
• 安全增强：实现HTTP到HTTPS的自动重定向
• API兼容性：在nginx中正确配置registry版本响应头，确保Docker客户端使用v2 API

使用场景和适用范围

适用于需要部署私有Docker镜像仓库的场景，特别适合对容器体积和资源占用有要求的环境。默认假设：

• 使用S3作为存储后端
• 由负载均衡器处理SSL终止

每日构建

通过SemaphoreCI配置每日自动构建，构建成功后会推送标记为daily的镜像至 https://registry.hub.docker.com/u/kinesis/registry/%E3%80%82

构建要求

本地构建需配置Go开发环境，以便通过go get安装gox工具。

基本认证

所有端点（健康检查除外）均需基本认证。通过以下命令创建密码文件：

shell
htpasswd -bc docker-registry.htpasswd USERNAME PASSWORD

使用方法

配置说明

registry的大多数配置项可通过环境变量设置，但registry 2.0启动必须依赖配置文件，因此需从宿主机挂载配置文件。

运行示例

以下是启动容器的示例脚本：

shell
#!/bin/bash

NAME=registry
IMAGE="kinesis/registry"

docker pull $IMAGE
docker stop $NAME
docker kill $NAME
docker rm $NAME

docker run \
  -v /root/docker-registry.htpasswd:/etc/nginx/docker-registry.htpasswd \
  -v /root/config.yml:/app/config.yml \
  -p 80:80 \
  --name registry \
  -d kinesis/registry

部署建议

建议在主机启动时配置相关参数。例如，在AWS EC2实例上可通过user-data实现自动化部署。