cnvrg/custom Docker 镜像 - 轩辕镜像

Docker自定义镜像文档

概述

Docker自定义镜像是用户根据自身需求构建的容器镜像，基于官方或其他基础镜像，添加特定应用程序、配置文件、依赖项和运行环境。自定义镜像允许开发者将应用及其所有依赖打包到标准化单元中，确保应用在任何支持Docker的环境中以相同方式运行。

核心功能和特性

• 环境一致性：确保应用在开发、测试和生产环境中运行行为一致
• 依赖隔离：将应用依赖与系统环境隔离，避免版本冲突
• 标准化部署：提供统一的部署单元，简化分发和部署流程
• 可移植性：可在任何支持Docker的平台上运行，不受底层系统限制
• 版本控制：支持版本标记和管理，便于回滚和版本控制
• 层叠存储：基于Docker的分层文件系统，优化存储和传输效率

使用场景和适用范围

• 企业内部应用的标准化部署
• 微服务架构中的服务容器化
• CI/CD流水线中的自动化构建和测试
• 开发环境的快速搭建和共享
• 应用演示和原型展示
• 复杂应用的简化部署
• 需要隔离不同应用环境的场景

构建方法

使用Dockerfile构建

Dockerfile是包含构建Docker镜像所需指令的文本文件，基本结构如下：

dockerfile
# 基础镜像
FROM [镜像名称]:[标签]

# 设置工作目录
WORKDIR /app

# 复制文件
COPY [源路径] [目标路径]

# 运行命令
RUN [命令]

# 暴露端口
EXPOSE [端口号]

# 设置环境变量
ENV [键]=[值]

# 容器启动命令
CMD ["可执行文件", "参数1", "参数2"]

构建命令

从Dockerfile构建自定义镜像：

bash
docker build -t [镜像名称]:[标签] [Dockerfile所在目录]

示例：

bash
docker build -t myapp:1.0 .

管理和使用

查看本地自定义镜像

bash
docker images

运行自定义镜像

bash
docker run -d --name [容器名称] -p [主机端口]:[容器端口] [镜像名称]:[标签]

示例：

bash
docker run -d --name myapp-container -p 8080:80 myapp:1.0

推送镜像到仓库

bash
# 标记镜像
docker tag [镜像名称]:[标签] [仓库地址]/[用户名]/[镜像名称]:[标签]

# 推送镜像
docker push [仓库地址]/[用户名]/[镜像名称]:[标签]

示例：

bash
docker tag myapp:1.0 docker.io/myusername/myapp:1.0
docker push docker.io/myusername/myapp:1.0

最佳实践

1. 使用适当基础镜像：选择精简基础镜像(如Alpine)减小镜像大小
2. 合并RUN指令：使用&&合并多个RUN指令，减少镜像层数
3. 清理临时文件：在同一RUN指令中清理安装过程中产生的临时文件
4. 使用.dockerignore文件：排除不需要添加到镜像中的文件和目录
5. 不要以root用户运行：在Dockerfile中创建非root用户并切换
6. 使用多阶段构建：减小最终镜像大小，只包含运行时必需文件
7. 添加标签：为镜像添加描述性标签，便于管理和识别

多阶段构建示例

多阶段构建可显著减小最终镜像大小：

dockerfile
# 构建阶段
FROM maven:3.8-openjdk-11 AS builder
WORKDIR /app
COPY pom.xml .
COPY src ./src
RUN mvn package -DskipTests

# 运行阶段
FROM openjdk:11-jre-slim
WORKDIR /app
COPY --from=builder /app/target/*.jar app.jar
EXPOSE 8080
ENTRYPOINT ["java", "-jar", "app.jar"]

构建命令：

bash
docker build -t my-java-app:1.0 .

常见问题解决

镜像体积过大

• 使用多阶段构建
• 选择更小的基础镜像
• 清理构建依赖和临时文件
• 合并多个RUN指令

构建速度慢

• 合理排序Dockerfile指令，利用Docker缓存机制
• 使用国内镜像源
• 优化构建上下文，使用.dockerignore排除不必要文件

镜像安全问题

• 定期更新基础镜像
• 扫描镜像漏洞(docker scan命令)
• 避免在镜像中存储敏感信息
• 不以root用户运行容器