cloudflare/sciuro

开源代码镜像发布工具

镜像概述

本Docker镜像专为开源项目设计，提供一站式的镜像构建与发布解决方案。它集成了项目构建、版本管理和容器仓库发布功能，帮助开发者将开源代码高效转化为标准化Docker镜像，并便捷地分发到主流容器仓库，降低开源软件的部署门槛。

核心功能与特性

• 自动化构建流程：支持从源代码自动构建Docker镜像，集成代码编译、依赖管理等步骤
• 版本管理：自动识别项目版本标签（如Git Tag），生成对应版本的镜像标签
• 多仓库支持：兼容Docker Hub、GitHub Container Registry、GitLab Container Registry等主流容器仓库
• 配置灵活：通过环境变量和配置文件自定义构建参数、镜像名称、仓库地址等
• 轻量级设计：基于 Alpine 基础镜像，体积小，资源占用低

使用场景与适用范围

• 开源项目维护者发布官方Docker镜像
• CI/CD流水线中集成镜像构建与发布步骤
• 需要跨平台分发开源软件的场景
• 个人开发者分享开源项目的Docker化版本

使用方法与配置说明

基本使用（docker run）

bash
docker run -it --rm \
  -v /path/to/your/open-source-project:/app \
  -e PROJECT_PATH=/app \
  -e REGISTRY_URL=https://index.docker.io/v1/ \
  -e REGISTRY_USER=your-username \
  -e REGISTRY_PASSWORD=your-password \
  -e IMAGE_NAME=your-project-name \
  open-source-image-publisher

环境变量配置

docker-compose配置示例

yaml
version: '3'
services:
  image-publisher:
    image: open-source-image-publisher
    volumes:
      - ./my-open-project:/app
    environment:
      - PROJECT_PATH=/app
      - REGISTRY_URL=https://ghcr.io/v1/
      - REGISTRY_USER=github-username
      - REGISTRY_PASSWORD=github-personal-access-token
      - IMAGE_NAME=my-open-project
      - IMAGE_TAG=latest

注意事项

1. 确保宿主机与容器内的项目路径映射正确（如-v /local/path:/app）
2. 仓库认证信息建议通过安全方式注入（如Docker Secrets或环境变量文件）
3. 首次使用前建议通过--dry-run参数测试构建流程（需镜像支持该功能）
4. 支持多架构构建，可通过BUILD_PLATFORMS环境变量指定（如linux/amd64,linux/arm64）