cyeradocker/public-images

公共基础Docker镜像文档

镜像概述

本镜像为公共Docker镜像，不包含任何Cyera相关的特定配置、依赖、工具或功能。其设计目标是提供一个通用、纯净的基础镜像，适用于多种标准容器化场景，无需依赖Cyera专属环境或服务。

核心功能与特性

通用性

• 无任何Cyera品牌相关的特定标识、配置文件或元数据
• 不捆绑Cyera专属工具链、SDK或运行时依赖
• 完全遵循Docker官方规范，兼容主流容器引擎（Docker Engine、containerd等）

轻量与精简

• 基于主流精简基础镜像（如Alpine Linux或Debian Slim）构建，最小化镜像体积
• 仅包含操作系统基础组件，无冗余功能模块
• 优化层缓存结构，提升镜像拉取与构建效率

兼容性

• 支持多架构（如amd64、arm64）部署（具体架构支持以镜像仓库标签为准）
• 兼容Docker Compose、Kubernetes等主流容器编排平台
• 可直接作为基础镜像用于Dockerfile构建流程

适用场景

• 通用开发环境：作为本地开发、测试的基础容器环境
• 基础服务部署：运行无厂商特定依赖的标准应用（如静态文件服务、基础网络服务）
• 镜像构建基础：在Dockerfile中作为FROM指令的基础镜像，构建自定义应用镜像
• 纯净环境测试：需要排除特定厂商依赖干扰的功能验证场景

使用方法与配置说明

基本使用

直接运行镜像

通过docker run命令启动容器，验证基础环境：

bash
docker run --rm [镜像名称]:[标签]

注：[镜像名称]和[标签]需替换为实际镜像仓库中的完整标识（如cyera/public-base:latest）

作为基础镜像构建应用

在Dockerfile中使用本镜像作为基础：

dockerfile
# 以本镜像为基础构建自定义应用
FROM [镜像名称]:[标签]

# 添加应用代码与依赖
COPY ./app /app
WORKDIR /app

# 运行应用
CMD ["./start.sh"]

高级配置

指定运行用户

为增强安全性，可通过--user参数指定非root用户运行：

bash
docker run --rm --user 1000:1000 [镜像名称]:[标签]

挂载数据卷

如需持久化数据或共享文件，可挂载主机目录：

bash
docker run --rm -v /host/path:/container/path [镜像名称]:[标签]

环境变量注入

虽无特定功能依赖，但可注入标准环境变量用于自定义配置：

bash
docker run --rm -e "APP_ENV=production" -e "LOG_LEVEL=info" [镜像名称]:[标签]

注意事项

• 本镜像不提供Cyera相关技术支持，如需Cyera专属功能，请使用Cyera官方特定镜像
• 镜像版本更新遵循语义化版本控制（SemVer），建议在生产环境中固定使用具体版本标签（如:1.0.0）而非:latest
• 如需扩展功能，建议通过Dockerfile基于本镜像构建，并显式添加所需依赖

镜像获取

可从Docker Hub或其他公共镜像仓库拉取：

bash
docker pull [镜像仓库地址]/[镜像名称]:[标签]

具体仓库地址与可用标签请参考官方镜像仓库说明。