infuseai/docker-stacks

Primehub 公共 Docker 镜像文档

1. 镜像概述

Primehub 公共 Docker 镜像是由 Primehub 官方维护的标准化容器镜像集合，旨在简化 Primehub 机器学习平台的部署流程、确保运行环境一致性，并提供便捷的组件管理方式。所有镜像均基于官方推荐的基础镜像构建，包含运行 Primehub 所需的依赖和配置。

2. 核心功能与特性

• 官方维护与更新：镜像由 Primehub 团队持续维护，同步跟进平台版本更新，确保兼容性和安全性。
• 标准化环境：预配置 Primehub 核心组件（如控制器、代理、UI 等）的运行环境，无需手动安装依赖。
• 版本化管理：通过标签（tag）区分不同版本，支持指定 Primehub 版本进行部署，满足不同环境需求（如生产、测试、开发）。
• 跨平台兼容性：支持主流容器运行时（Docker、containerd 等）及 Kubernetes 环境，适配常见操作系统架构。

3. 使用场景

• Primehub 平台部署：机器学习团队可直接使用镜像快速部署 Primehub 完整平台或独立组件。
• 开发与测试：开发者可基于镜像搭建本地开发环境，测试 Primehub 新功能或自定义配置。
• 生产环境运行：提供稳定的生产级镜像，支持高可用部署和规模化扩展。

4. 使用方法

4.1 获取镜像

Primehub 公共 Docker 镜像托管于官方镜像仓库，可通过以下命令拉取指定镜像（以 primehub/controller 为例）：

bash
docker pull primehub/controller:latest  # 获取最新版本
# 或指定版本
docker pull primehub/controller:v3.0.0

4.2 运行示例

以运行 Primehub 控制器组件为例，基本 docker run 命令如下：

bash
docker run -d \
  --name primehub-controller \
  -p 8080:8080 \
  -e PRIMEHUB_NAMESPACE=default \
  -e LOG_LEVEL=info \
  primehub/controller:latest

• -d：后台运行容器
• --name：指定容器名称
• -p：端口映射（根据组件需求调整）
• -e：设置环境变量（具体变量见 4.3 节）

4.3 环境变量配置

通用常用环境变量（具体组件请参考对应镜像文档）：

• PRIMEHUB_NAMESPACE：指定 Primehub 运行的 Kubernetes 命名空间，默认 default
• LOG_LEVEL：日志级别，可选 debug、info、warn、error，默认 info
• API_SERVER_URL：Primehub API 服务地址，用于组件间通信

4.4 版本管理

镜像标签格式：primehub/<component>:<version>，其中：

• <component>：组件名称（如 controller、ui、agent 等）
• <version>：Primehub 版本号（如 v3.0.0），或 latest（最新稳定版）、nightly（每日构建测试版）

5. 注意事项

• 生产环境建议使用指定版本标签，避免 latest 标签导致版本不可控。
• 运行前需参考具体组件文档，确认端口映射、存储挂载及权限配置要求。
• 镜像更新与 Primehub 版本发布同步，建议定期关注官方仓库获取更新信息。

6. 官方镜像仓库

Docker Hub 地址：https://hub.docker.com/u/primehub%EF%BC%88%E6%88%96%E5%AE%98%E6%96%B9%E6%8C%87%E5%AE%9A%E7%A7%81%E6%9C%89%E4%BB%93%E5%BA%93%EF%BC%8C%E4%BB%A5%E5%B9%B3%E5%8F%B0%E6%96%87%E6%A1%A3%E4%B8%BA%E5%87%86%EF%BC%89