在容器化部署的实践中我们常常会遇到一个核心需求如何将一个现有的应用或服务连同其运行环境打包成一个标准、可移植的镜像。很多教程会直接使用docker commit命令但这通常不被推荐用于生产环境因为它缺乏可重复性和透明性。本文将系统性地讲解如何从零开始通过编写Dockerfile来定制一个简单的应用镜像并深入解决容器内部环境配置的痛点——例如如何在基于 CentOS 的容器内配置可用的 Yum 仓库并成功安装部署 Nginx 服务。整个过程遵循“一次编写处处运行”的 Docker 哲学适合希望从基础操作进阶到镜像定制的开发者。1. 核心概念与准备工作在开始动手之前我们需要明确几个关键概念并准备好实验环境。1.1 Docker 镜像与容器Docker 镜像是一个轻量级、可执行的独立软件包它包含运行某个软件所需的所有内容代码、运行时环境、系统工具、系统库和设置。你可以把它理解为一个应用程序的“模板”或“安装包”。Docker 容器是镜像的运行实例。当你运行一个镜像时Docker 会创建一个隔离的进程空间容器镜像中的文件系统加上一层可写层容器层就构成了容器的运行环境。容器可以被启动、停止、删除每个容器都是相互隔离的。简单来说镜像是静态的定义容器是动态的运行实体。我们今天的任务就是创建一个自定义的镜像并用它来运行容器。1.2 为什么需要定制镜像和配置内部仓库环境一致性确保开发、测试、生产环境完全一致避免“在我机器上能跑”的问题。依赖管理将应用依赖如特定版本的库、系统工具固化在镜像中简化部署。离线或内网部署在企业内网环境中容器可能无法直接访问互联网。预先在镜像中配置好内部 Yum 仓库可以保证容器在启动后依然能安装必要的软件包。安全与合规使用经过审核的内部源避免从不可信的公共源下载软件。1.3 环境准备与版本说明本文的操作基于以下环境但核心步骤和思路适用于大多数 Linux 发行版。宿主机操作系统CentOS 7.9 或 Ubuntu 20.04本文演示以 CentOS 7.9 为主Docker 版本Docker Engine 20.10.0 及以上安装命令CentOS 7sudo yum install -y docker启动 Dockersudo systemctl start docker sudo systemctl enable docker基础镜像我们将使用centos:7作为基础镜像来定制。目标服务在容器内安装并运行 Nginx 作为示例服务。请确保你的宿主机已安装 Docker 并可正常执行docker version和docker run hello-world命令。2. 编写 Dockerfile 定制简单镜像Dockerfile是一个文本文件其中包含了一系列的指令Instruction用于指导 Docker 如何自动构建镜像。我们将创建一个包含 Nginx 的镜像。2.1 创建项目目录与 Dockerfile首先创建一个干净的工作目录并在其中创建Dockerfile。mkdir -p ~/docker-nginx-demo cd ~/docker-nginx-demo touch Dockerfile2.2 编写 Dockerfile 内容使用你熟悉的文本编辑器如vim或nano打开Dockerfile并输入以下内容。我们将逐段进行解释。# 文件Dockerfile # 使用官方 CentOS 7 镜像作为构建基础 FROM centos:7 # 维护者信息可选已弃用但可作说明 LABEL maintaineryour-emailexample.com # 设置容器内的环境变量便于后续指令引用 ENV NGINX_VERSION1.20.1 \ APP_HOME/usr/share/nginx/html # 1. 配置 Yum 仓库解决容器内无仓库或网络问题 # 备份原有 repo 文件centos:7 镜像内通常为空或指向不可用的外部源 RUN mv /etc/yum.repos.d/CentOS-Base.repo /etc/yum.repos.d/CentOS-Base.repo.backup 2/dev/null || true # 添加阿里云镜像源国内加速也可替换为公司内网源 COPY CentOS-Base.repo /etc/yum.repos.d/ # 清理缓存并生成新缓存 RUN yum clean all yum makecache # 2. 安装必要的系统工具和 Nginx 编译依赖 RUN yum install -y wget gcc gcc-c make pcre-devel zlib-devel openssl-devel # 3. 下载并编译安装 Nginx WORKDIR /tmp RUN wget http://nginx.org/download/nginx-${NGINX_VERSION}.tar.gz \ tar -zxvf nginx-${NGINX_VERSION}.tar.gz \ cd nginx-${NGINX_VERSION} \ ./configure --prefix/usr/local/nginx \ make make install \ ln -s /usr/local/nginx/sbin/nginx /usr/sbin/nginx \ rm -rf /tmp/nginx* # 4. 创建必要的目录并调整权限 RUN mkdir -p ${APP_HOME} mkdir -p /var/log/nginx # 创建一个默认的测试页面 RUN echo h1Hello, Docker Nginx from Custom Image!/h1 ${APP_HOME}/index.html # 5. 暴露 Nginx 默认端口 EXPOSE 80 # 6. 定义容器启动时执行的命令 # 以前台方式启动 Nginx CMD [nginx, -g, daemon off;]关键指令解析FROM指定基础镜像所有操作都基于此镜像。LABEL为镜像添加元数据。ENV设置环境变量使 Dockerfile 更易维护和阅读。RUN在构建镜像时执行的命令用于安装软件、配置系统等。每一条RUN指令都会创建一个新的镜像层。COPY将宿主机文件复制到镜像中。这里我们计划将一个预配置的CentOS-Base.repo文件复制进去。WORKDIR设置工作目录后续的RUN、CMD等指令会在此目录下执行。EXPOSE声明容器运行时监听的端口这只是一个文档性说明实际映射需要在docker run时通过-p参数指定。CMD指定容器启动时默认执行的命令。一个 Dockerfile 中只能有一个有效的CMD。2.3 创建内部的 Yum 仓库配置文件在宿主机上创建一个CentOS-Base.repo文件与Dockerfile在同一目录。这里以阿里云镜像源为例如果你有内网仓库请替换为内网地址。# 文件CentOS-Base.repo [base] nameCentOS-$releasever - Base - mirrors.aliyun.com failovermethodpriority baseurlhttp://mirrors.aliyun.com/centos/$releasever/os/$basearch/ http://mirrors.aliyuncs.com/centos/$releasever/os/$basearch/ http://mirrors.cloud.aliyuncs.com/centos/$releasever/os/$basearch/ gpgcheck1 gpgkeyhttp://mirrors.aliyun.com/centos/RPM-GPG-KEY-CentOS-7 [updates] nameCentOS-$releasever - Updates - mirrors.aliyun.com failovermethodpriority baseurlhttp://mirrors.aliyun.com/centos/$releasever/updates/$basearch/ http://mirrors.aliyuncs.com/centos/$releasever/updates/$basearch/ http://mirrors.cloud.aliyuncs.com/centos/$releasever/updates/$basearch/ gpgcheck1 gpgkeyhttp://mirrors.aliyun.com/centos/RPM-GPG-KEY-CentOS-7 [extras] nameCentOS-$releasever - Extras - mirrors.aliyun.com failovermethodpriority baseurlhttp://mirrors.aliyun.com/centos/$releasever/extras/$basearch/ http://mirrors.aliyuncs.com/centos/$releasever/extras/$basearch/ http://mirrors.cloud.aliyuncs.com/centos/$releasever/extras/$basearch/ gpgcheck1 gpgkeyhttp://mirrors.aliyuncs.com/centos/RPM-GPG-KEY-CentOS-7 [centosplus] nameCentOS-$releasever - Plus - mirrors.aliyun.com failovermethodpriority baseurlhttp://mirrors.aliyun.com/centos/$releasever/centosplus/$basearch/ http://mirrors.aliyuncs.com/centos/$releasever/centosplus/$basearch/ http://mirrors.cloud.aliyuncs.com/centos/$releasever/centosplus/$basearch/ gpgcheck1 gpgkeyhttp://mirrors.aliyun.com/centos/RPM-GPG-KEY-CentOS-7为什么需要这一步默认的centos:7镜像为了保持最小化通常移除了或指向了不可用的默认 Yum 源。直接在容器内运行yum install可能会失败。通过COPY指令将配置好的 repo 文件放入镜像可以确保构建过程和在容器内运行时都能使用稳定、高速的软件源。3. 构建自定义镜像并运行容器3.1 构建镜像在包含Dockerfile和CentOS-Base.repo的目录下执行构建命令。# -t 参数为镜像指定标签格式为 name:tag # 最后的 . 表示构建上下文为当前目录 docker build -t my-custom-nginx:1.0 .构建过程会逐条执行 Dockerfile 中的指令下载基础镜像、安装软件、编译 Nginx 等。这可能需要几分钟时间取决于你的网络速度。构建成功后使用docker images命令查看本地镜像列表应该能看到my-custom-nginx镜像。docker images | grep my-custom-nginx3.2 运行容器现在使用我们刚刚构建的镜像来创建并运行一个容器。# -d: 后台运行 # -p 8080:80: 将宿主机的 8080 端口映射到容器的 80 端口 # --name: 为容器指定一个名称 docker run -d -p 8080:80 --name my-nginx-container my-custom-nginx:1.0运行后可以使用docker ps查看容器状态确认其正在运行。docker ps3.3 验证服务打开你的浏览器访问http://你的宿主机IP:8080。你应该能看到显示 “Hello, Docker Nginx from Custom Image!” 的页面。这证明我们的自定义镜像已经成功运行Nginx 服务正常启动并且我们通过端口映射可以从外部访问它。你也可以进入容器内部验证 Yum 仓库是否可用以及 Nginx 是否安装。# 进入容器内部的 bash shell docker exec -it my-nginx-container /bin/bash # 在容器内执行命令 [root容器ID /]# cat /etc/redhat-release # 查看系统版本 [root容器ID /]# yum repolist # 查看配置的仓库列表确认仓库可用 [root容器ID /]# nginx -v # 查看 Nginx 版本 [root容器ID /]# exit # 退出容器4. 深入解析Dockerfile 优化与最佳实践上面的 Dockerfile 是一个功能完整的示例但在生产环境中我们可以从以下几个角度进行优化。4.1 减少镜像层数与大小Docker 镜像由一系列只读层Layer组成。每条RUN、COPY、ADD指令都会创建一个新层。层数过多、过大不仅增加构建时间也占用更多存储和网络传输带宽。优化前层数多未清理缓存RUN yum install -y wget RUN yum install -y gcc RUN yum install -y make RUN wget http://example.com/pkg.tar.gz RUN tar -zxvf pkg.tar.gz RUN cd pkg ./configure make make install # 中间文件 pkg.tar.gz 和源码目录 pkg 仍存在于镜像中优化后合并指令清理无用文件RUN yum install -y wget gcc make \ wget http://example.com/pkg.tar.gz \ tar -zxvf pkg.tar.gz \ cd pkg \ ./configure make make install \ cd .. \ rm -rf pkg.tar.gz pkg \ yum clean all # 清理 Yum 缓存使用连接多个命令并用\换行使一个RUN指令完成所有相关工作。在同一个RUN指令的最后删除下载的压缩包、编译产生的中间文件并清理包管理器的缓存。这样所有这些操作产生的文件变化最终只存在于一个镜像层中并且该层不包含任何无用的大文件。4.2 使用 .dockerignore 文件类似于.gitignore.dockerignore文件可以排除在构建上下文docker build命令最后的.所指目录中不需要发送给 Docker 守护进程的文件和目录。这可以加速构建过程避免将本地日志、临时文件、.git目录等不必要的内容打包进上下文。# 文件.dockerignore .git *.log tmp/ .DS_Store README.md4.3 选择合适的基础镜像alpine一个极简的 Linux 发行版镜像体积通常只有 5MB 左右。非常适合制作生产环境镜像。但 musl libc 可能与某些依赖 glibc 的软件不兼容。FROM alpine:latest RUN apk add --no-cache nginxslim 或 -slim 变体例如python:slim、node:slim。这些是官方镜像的裁剪版移除了非必要的通用工具和文档比完整版如python:latest小很多。scratch一个空镜像。用于构建完全静态链接的二进制文件应用如 Go 语言编译的程序镜像体积最小。对于我们的 Nginx 示例如果追求极致体积可以考虑使用alpine作为基础使用apk安装预编译的 Nginx 包而不是从源码编译。4.4 非 root 用户运行默认情况下容器内的进程以 root 用户运行。为了增强安全性最好创建一个非 root 用户和用户组来运行应用进程。# 在 Dockerfile 中增加以下指令 RUN groupadd -r nginx useradd -r -g nginx -s /bin/false -M nginx # ... 其他安装步骤 ... # 在 COPY 静态文件或启动前更改文件所属用户 RUN chown -R nginx:nginx /usr/share/nginx/html /var/log/nginx # 使用 USER 指令切换用户 USER nginx # 注意如果使用非 root 用户则 EXPOSE 的端口必须大于 1024或者需要特殊权限处理 CMD [nginx, -g, daemon off;]5. 常见问题与排查思路在定制镜像和运行容器的过程中你可能会遇到以下问题。问题现象可能原因排查与解决思路docker build失败提示yum install错误1. 容器内无法访问网络。2. Yum 仓库配置错误或不可用。3. 基础镜像的仓库配置被清除。1. 检查宿主机的网络确保能访问互联网或内网仓库地址。2. 进入临时容器测试docker run -it --rm centos:7 bash尝试curl仓库地址。3. 检查COPY到镜像内的CentOS-Base.repo文件路径和内容是否正确。镜像构建成功但docker run后容器立刻退出1. 容器内前台进程结束。2.CMD或ENTRYPOINT指定的命令执行失败。3. 应用启动报错。1. 使用docker logs 容器名查看容器日志这是最重要的排查手段。2. 确保CMD是以前台方式运行例如 Nginx 使用nginx -g ‘daemon off;‘。3. 以交互模式运行容器排查docker run -it --rm my-image bash然后手动执行启动命令看报错。宿主机访问http://localhost:8080连接被拒绝1. 容器没有正常运行。2. 端口映射 (-p) 参数错误。3. 容器内应用未监听预期端口。1.docker ps确认容器状态是否为Up。2.docker port 容器名查看端口映射情况。3. 进入容器 (docker exec) 检查应用进程ps aux和监听端口netstat -tlnp。镜像体积过大1. 每一层RUN指令产生了大量缓存或中间文件。2. 基础镜像本身较大。3. 复制了不必要的文件进入镜像。1. 遵循 4.1 节的优化原则合并RUN并清理缓存。2. 考虑使用更小的基础镜像Alpine, slim。3. 使用.dockerignore文件并确保COPY只复制必需文件。容器内服务无法解析域名容器默认使用宿主机的 DNS 配置但可能在某些网络环境下失效。1. 运行容器时指定 DNSdocker run --dns 8.8.8.8 ...。2. 在 Docker 守护进程配置中修改默认 DNS (/etc/docker/daemon.json)。3. 检查宿主机的/etc/resolv.conf。6. 进阶使用 Docker Compose 管理多容器应用当应用包含多个服务如 Web 服务器 数据库时使用docker run手动管理每个容器非常繁琐。Docker Compose 是一个用于定义和运行多容器 Docker 应用的工具。创建一个docker-compose.yml文件来定义我们的 Nginx 服务。# 文件docker-compose.yml version: 3.8 services: web: build: . # 使用当前目录的 Dockerfile 构建镜像 image: my-custom-nginx:compose container_name: my-nginx-compose ports: - 8081:80 # 宿主机端口:容器端口 # volumes: # - ./html:/usr/share/nginx/html # 挂载本地HTML目录实现动态内容更新 # - ./nginx.conf:/etc/nginx/nginx.conf # 挂载自定义Nginx配置 restart: unless-stopped # 容器退出时自动重启除非手动停止 networks: - app-network networks: app-network: driver: bridge然后在包含docker-compose.yml和Dockerfile的目录下执行# 构建镜像并启动所有服务 docker-compose up -d # 查看服务状态 docker-compose ps # 停止并移除容器、网络默认不删除镜像 docker-compose down # 停止并移除容器、网络同时删除构建的镜像 docker-compose down --rmi localDocker Compose 极大地简化了多服务环境的部署和管理是本地开发和测试的利器。7. 总结与后续学习方向通过本文的实践我们完整走通了 Docker 镜像定制的核心流程从编写Dockerfile定义构建步骤到解决容器内部环境配置Yum仓库再到编译安装应用Nginx最后构建镜像并运行容器。我们不仅完成了“怎么做”还深入探讨了“为什么这么做”以及如何做得更好优化与最佳实践。关键收获Dockerfile 是指令蓝图它决定了镜像的每一层内容。上下文配置至关重要容器内的软件源、时区、语言环境等都需要在构建时或运行时妥善配置。镜像优化是持续过程通过减少层数、选择小基础镜像、清理缓存来打造精益镜像。日志是排错第一线索docker logs和docker exec是诊断容器问题的必备工具。下一步可以探索多阶段构建用于分离构建环境和运行环境进一步减小最终镜像体积。例如在一个阶段用完整的 SDK 编译应用在另一个阶段只复制编译好的二进制文件到精简的运行镜像中。镜像仓库学习如何将本地镜像推送到 Docker Hub、阿里云容器镜像服务等公共或私有仓库实现镜像的分享和分发。容器数据持久化了解 Docker 卷和绑定挂载解决容器内数据持久化的问题。容器编排学习 Kubernetes 或 Docker Swarm管理大规模、高可用的容器化应用集群。定制 Docker 镜像是容器化技术的基石。掌握它你就能将任何应用封装成标准、可靠的交付件为后续的持续集成和自动化部署打下坚实基础。动手尝试修改 Dockerfile为你自己的项目创建一个定制镜像吧。
