stargate01/portus

Portus-Docker

镜像概述和主要用途

Portus-Docker是一个轻量级Docker镜像，包含SUSE Portus的安装，基于Alpine Linux构建。该镜像直接从官方源代码构建，旨在提供生产环境可用的Portus版本，支持运行官方代码分支或自定义代码，便于用户精确控制镜像中的代码内容。

核心功能和特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• 源代码构建：直接从指定仓库源代码构建，确保代码的可控性
• 生产版本优化：预编译所有资产，构建生产环境适用的软件版本
• 灵活定制：支持自定义仓库URL、分支/标签，便于运行官方代码分支或fork版本

使用场景和适用范围

• 需要运行Portus官方代码分支的场景
• 需要自定义Portus代码并构建镜像的场景
• 对镜像体积和资源占用有要求的生产环境部署
• 需要精确控制镜像中代码内容的场景

详细使用方法和配置说明

镜像编译

使用Docker命令构建镜像：

bash
docker build -t stargate01/portus:latest .

可选构建参数（--build-arg）

• VERSION_STRING：显示的版本字符串（默认：v2.5）
• REPO_TAG：要构建的仓库标签或分支（默认：master）
• REPO_URL：仓库URL，用于构建fork版本（默认：https://github.com/StarGate01/Portus.git%EF%BC%89

本地测试

提供基础Docker Compose配置用于本地测试，步骤如下：

1. 检查配置文件：确认config/*.env和docker-compose.yml中的域名设置（默认：registry.home和portus.home）

2. 生成认证证书：

   bash
   cd config && ./gen-certs.sh
   

3. 启动服务堆栈：包含Portus、Portus后台工作器、Docker registry和MariaDB数据库

   bash
   docker compose build && docker-compose up