Dockerfile 完全入门:10 分钟学会自定义镜像
Docker 官方镜像(如 Nginx、MySQL、Redis)虽然提供了基础运行环境,但往往不包含具体的应用代码和个性化配置。为了实现应用与环境的一体化打包,确保在任意 Docker 环境中的一致性运行,需要使用 Dockerfile 编写构建脚本。Dockerfile 是一个文本文件,包含了构建镜像所需的一系列指令,通过自动化流程将应用代码、运行环境及配置整合为独立的镜像。
01构建原理与流程
Dockerfile 的构建过程基于分层存储机制。Docker 守护进程读取 Dockerfile 中的指令,逐条执行。每执行一条指令,就会创建一个临时容器并在其中运行命令,执行结束后将容器的文件变更提交为一个新的镜像层。这些层叠加在一起,最终形成完整的镜像。此外,构建过程中会利用缓存机制,若指令及依赖文件未发生变化,则直接复用之前的镜像层,从而显著提升构建速度。
02实战案例:Python Flask 应用打包
以下通过一个 Python Flask 应用示例,展示从编写 Dockerfile 到运行容器的完整过程。该过程包括准备应用代码、编写构建脚本、执行构建命令及验证运行效果。
- 准备应用文件
创建目录并包含 app.py(应用主程序)和 requirements.txt(依赖清单)。 - 编写 Dockerfile
基于 python:3.9-slim 镜像,设置工作目录,复制依赖文件并安装,随后复制应用代码,暴露端口并定义启动命令。 - 执行构建
在项目根目录运行 docker build -t my-flask-app:1.0 .,Docker 将根据上下文目录和脚本生成镜像。 - 运行容器
使用 docker run -d -p 5000:5000 --name myapp my-flask-app:1.0 启动服务,通过浏览器访问验证。
03核心指令详解
| 指令 | 功能描述 | 示例 |
|---|---|---|
| FROM | 指定基础镜像 | FROM python:3.9-slim |
| WORKDIR | 设置工作目录 | WORKDIR /app |
| COPY / ADD | 复制文件到镜像(ADD 支持解压和 URL) | COPY . /app |
| RUN | 构建时执行命令 | RUN pip install -r requirements.txt |
| CMD / ENTRYPOINT | 容器启动命令(CMD 可被覆盖,ENTRYPOINT 不可) | CMD ["python", "app.py"] |
| EXPOSE | 声明容器监听端口 | EXPOSE 5000 |
| ENV | 设置环境变量 | ENV PORT=8080 |
Dockerfile 常用指令速查
04最佳实践与注意事项
- 优化构建缓存
将变化较少的指令(如依赖安装)置于前面,变化频繁的代码复制置于后面,以最大化利用缓存。 - 减少镜像层数
合并 RUN 指令,并在同一指令中清理临时文件(如 /var/lib/apt/lists/*),减小镜像体积。 - 使用 .dockerignore
排除不必要的文件(如 .git、__pycache__、node_modules),避免将其打包进镜像。 - 明确版本标签
避免使用 latest 标签,建议为镜像打上具体版本号(如 v1.0),便于版本管理和回溯。
掌握 Dockerfile 的编写与构建原理,是实现应用容器化的关键。通过规范化的脚本定义,开发者能够将复杂的部署环境转化为标准化的镜像,从而大幅提升应用的可移植性和交付效率。
之前手动docker build总报错,后来才搞明白是layer缓存的问题。这篇把缓存机制讲得挺清楚,比官方文档好读多了
没有更多了