zero88/gh-registry

gh-docker-registry

!Docker Image Version (latest semver)

镜像概述

本镜像基于docker-distribution开发，专为GitHub Actions工作流优化，提供本地Docker Registry服务以缓存构建层，减少重复构建时间。镜像添加了runner:github用户（UID:1001/GID:121），适配GitHub Runner主机的卷挂载权限需求。

核心功能

1. 作为本地Registry缓存Docker构建层，加速GitHub Actions中的Docker构建流程
2. 支持多平台构建缓存（如amd64、arm64、arm/v7）
3. 适配GitHub Runner的权限设置，可直接挂载Runner主机目录作为Registry存储

使用场景

适用于GitHub Actions工作流中需要频繁构建Docker镜像的场景，通过缓存构建层显著缩短构建时间，提升CI/CD效率。

配置说明

• 端口：默认暴露5000端口，用于Registry服务通信
• 存储：建议挂载GitHub Runner主机目录（如/home/runner）到容器内/var/lib/registry路径，实现缓存持久化
• 用户权限：镜像内置runner:github用户，确保与GitHub Runner环境的权限兼容

使用示例

以下是GitHub Actions工作流中的典型配置：

yaml
build:
  runs-on: ubuntu-latest
  services:
    registry:
      image: zero88/gh-registry:latest
      ports:
        - 5000:5000
      options: >-
        -v /home/runner:/var/lib/registry
        --name registry

  steps:
    - uses: actions/checkout@v2
    - name: 缓存Docker层
      uses: actions/cache@v2
      with:
        path: /home/runner/docker
        key: ${{ runner.os }}-docker-${{ github.sha }}
        restore-keys: |
          ${{ runner.os }}-docker-

    - name: 验证缓存
      run: |
        docker buildx imagetools inspect localhost:5000/test:buildcache
    
    - name: 安装QEMU
      uses: docker/setup-qemu-action@v1

    - name: 配置Docker Buildx
      uses: docker/setup-buildx-action@v1

    - name: 构建Docker镜像
      uses: docker/build-push-action@v2
      with:
        context: .
        file: Dockerfile
        platforms: linux/amd64,linux/arm64,linux/arm/v7
        cache-from: type=registry,ref=localhost:5000/test:buildcache
        cache-to: type=registry,ref=localhost:5000/test:buildcache,mode=max
        tags: images/test:1.0.0

    - name: 清理过期缓存
      run: |
        docker buildx imagetools inspect localhost:5000/test:buildcache
        echo "======================================================"
        docker buildx prune --filter until=72h --keep-storage 5GB -f