当前位置：首页 > ds >正文

使用Dockerfile创建镜像

ds 2025/8/28 14:30:43

使用Dockerfile创建镜像

Dockerfile是构建Docker镜像的核心工具，通过声明式语法定义镜像的构建流程。本文将系统讲解Dockerfile的核心要素与最佳实践。

一、基本结构

一个标准的Dockerfile包含以下组成部分：

# 注释行（以#开头）
指令 参数# 示例
FROM alpine:3.18
LABEL maintainer="admin@example.com"
COPY app.py /opt/
RUN pip install -r requirements.txt

关键特性：

层次化构建：每条指令生成一个镜像层
上下文依赖：构建时默认将当前目录作为上下文（可通过.dockerignore过滤）
可重复性：相同Dockerfile在不同环境生成一致镜像

二、指令说明

1. 配置指令

指令	作用	示例
FROM	指定基础镜像	FROM python:3.9-alpine
LABEL	添加元数据	LABEL version=“1.0”
ENV	设置环境变量	ENV APP_HOME=/opt
EXPOSE	声明容器监听端口	EXPOSE 8080

2. 操作指令

指令	关键特性	最佳实践
RUN	执行命令并提交结果	合并多条命令减少镜像层数
COPY	复制本地文件到镜像	优先使用COPY而非ADD
CMD	指定容器启动时的默认命令	使用JSON数组格式
ENTRYPOINT	定义容器的主程序	与CMD配合使用

三、创建镜像

1. 命令选项

# 构建镜像（-t指定标签）
docker build -t myapp:v1 .# 跳过缓存构建
docker build --no-cache -t myapp:latest .

2. 选择父镜像

轻量化镜像：优先选择Alpine、Slim版本
安全扫描：定期检查基础镜像漏洞
最小化原则：只包含必要的运行时依赖

3. 使用.dockerignore

排除不需要的文件（语法类似.gitignore）：

.git
node_modules
*.log

4. 多步骤创建

分离构建环境和运行环境：

# 构建阶段
FROM golang:1.21 AS builder
WORKDIR /app
COPY . .
RUN go build -o main .# 运行阶段
FROM alpine:3.18
COPY --from=builder /app/main /
CMD ["/main"]

四、实战示例

Python应用多阶段构建

# 构建阶段
FROM python:3.11 as builder
WORKDIR /app
COPY requirements.txt .
RUN pip install --user -r requirements.txt# 运行时阶段
FROM python:3.11-slim
WORKDIR /app
COPY --from=builder /root/.local /root/.local
COPY . .
ENV PATH=/root/.local/bin:$PATH
CMD ["gunicorn", "app:app", "-b", "0.0.0.0:8000"]# 添加非root用户
RUN useradd -m appuser && chown -R appuser /app
USER appuser

构建命令：

docker build -t my-python-app:2.0 --target builder .

五、总结

传统构建 vs Dockerfile构建

维度	传统构建	Dockerfile构建
环境一致性	依赖本地环境	完全标准化
可重复性	难以保证	完全可重复
构建速度	快	首次较慢（层缓存优化后快）
部署效率	需手动配置	一键部署