【Docker】P5 Docker Compose 实战指南：一键部署 WordPress + MySQL

脚踏实地的大梦想家2025-11-02 17:05

目录

引言：为什么你需要 Docker Compose？

经过上面几篇博客的内容，我们已经对 Docker 有了初步的认知。但在现实应用中，一个应用往往会使用多个镜像文件，本博文我们以一个简单的博客系统为例，需要一个应用服务（如 WordPress）和一个数据库服务（如 MySQL）。

因此，完整流程来说，我们需要：

  1. 先创建一个共享网络
  2. 启动 MySQL 容器，配置好密码、数据库名、数据卷、网络等
  3. 启动 WordPress 容器，配置好端口、数据库连接信息，并连接到同一个网络
  4. 确保 WordPress 在 MySQL 启动之后再启动

本博文，我们将首先使用之前博文阐述的方法，通过 docker run 命令手动部署应用。然后我们讨论为什么在正式项目中不推荐使用手动部署方式，以及建议的 docker compose 方案及其原因。最后通过 docker compose 方案部署应用。

手动部署项目

明确下，我们将要部署的 WordPress 博客系统需要 wordpress 应用 和 mysql 数据库。

  1. 创建网络： 确保两个容器可以互相通信。

    bash 复制代码 
    docker network create blog

  2. 启动 MySQL 容器：

    bash 复制代码 
    docker run -d -p 3306:3306 \
-e MYSQL_ROOT_PASSWORD=123456 \
-e MYSQL_DATABASE=wordpress \
-v mysql-data:/var/lib/mysql \
-v /app/myconf:/etc/mysql/conf.d \
--restart always --name mysql \
--network blog \
mysql:8.0

  3. 启动 WordPress 容器：

    bash 复制代码 
    docker run -d -p 8080:80 \
-e WORDPRESS_DB_HOST=mysql \
-e WORDPRESS_DB_USER=root \
-e WORDPRESS_DB_PASSWORD=123456 \
-e WORDPRESS_DB_NAME=wordpress \
-v wordpress:/var/www/html \
--restart always --name wordpress-app \
--network blog \
wordpress:latest

完成上述步骤后，用户即可在 localhost:8080 查看到博客首页。但是回头来看，这个过程不仅繁琐，而且难以维护。不管是我们每次部署、迁移或交付给同事，或是修改一个端口、环境变量，可能就需要完整重复上述所有命令行所有步骤。都需要依赖一长串的 docker run 命令和手动步骤，这不仅效率低下，而且极易出错。

Docker Compose 正是为此而生。

什么是 docker compose

根据 Docker 官方文档的定义：

  • Compose 是一个用于定义和运行多容器 Docker 应用程序的工具。通过 Compose，您可以使用一个 YAML 文件来配置应用程序的服务。然后，使用一个命令，就可以从您的配置中创建并启动所有服务。

简而言之，Compose 允许我们将复杂的多容器应用"编排"在一个文件里，实现"一处定义，处处运行"，真正做到事半功倍。

compose 顶级元素

Docker Compose 的魔力在于其核心的 compose.yaml 文件，它使用 YAML 语法来定义应用的蓝图。

我们先来看一下 Compose 文件的几个顶级元素（根据 Docker 官方文档）：

  • services： 定义应用包含的各个容器
  • networks： 定义服务可以加入的网络
  • volumes： 定义服务可以使用的数据卷 ，用于数据持久化
  • configs： 用于存储非敏感的配置信息
  • secrets： 用于存储敏感信息，如密码
  • name： 定义此项目的名称

compose.yaml

现在，我们将上面手动的部署步骤，转换为一个 compose.yaml 文件：

yaml 复制代码 
# 定义项目名称
name: myblog

# 定义所有服务
services:
  # MySQL 服务
  mysql:
    container_name: mysql
    image: mysql:8.0
    ports:
      - "3306:3306"
    environment:
      - MYSQL_ROOT_PASSWORD=123456
      - MYSQL_DATABASE=wordpress
    volumes:
      - mysql-data:/var/lib/mysql
      - /app/myconf:/etc/mysql/conf.d
    restart: always
    networks:
      - blog

  # WordPress 服务
  wordpress:
    container_name: wordpress-app # 自定义容器名称
    image: wordpress:latest # 使用最新版的 wordpress 镜像
    ports:
      - "8080:80" # 映射宿主机的 8080 端口到容器的 80 端口
    environment:
      - WORDPRESS_DB_HOST=mysql
      - WORDPRESS_DB_USER=root
      - WORDPRESS_DB_PASSWORD=123456
      - WORDPRESS_DB_NAME=wordpress
    volumes:
      - wordpress:/var/www/html
    restart: always
    networks:
      - blog
    depends_on: # 依赖关系
      - mysql

# 统一定义数据卷
volumes:
  mysql-data:
  wordpress:

# 统一定义网络
networks:
  blog:

关键信息解读

让我们深入分析上述 YAML 文件中的关键配置，并对照官方 Docker Hub 的说明来理解它们的含义。

1. services: mysql (MySQL 服务)

  • image: mysql:8.0：指定使用 MySQL 官方镜像的 8.0 版本。
  • ports: "3306:3306" ：将宿主机 的 3306 端口映射到容器的 3306 端口，以便外部工具可以连接数据库。
  • environment ：这是配置 MySQL 容器的核心 。 根据 MySQL 官方文档：
    • MYSQL_ROOT_PASSWORD=123456 ：（必需） 设置 MySQL 'root' 用户的密码。
    • MYSQL_DATABASE=wordpress ：（可选） 这会在容器启动时自动创建一个名为 wordpress 的数据库。
  • volumes ： 这是数据持久化的关键 。
    • mysql-data:/var/lib/mysql ：将 Docker 管理的命名卷 mysql-data 通过卷映射到容器内的 /var/lib/mysql 目录。这是 MySQL 存储所有数据的地方。如果不映射，容器删除后所有数据库数据都会丢失。
    • /app/myconf:/etc/mysql/conf.d：将宿主机的 /app/myconf 目录（你需要自己创建并放入 conf.d 文件）挂载到容器内，用于自定义 MySQL 配置。
    • networks: "blog" ：将此服务连接到我们定义的 blog 网络。

2. services: wordpress (WordPress 服务)

  • image: wordpress:latest： 指定使用 WordPress 官方镜像 的 latest 版本。
  • ports: "8080:80"： 将宿主机的 8080 端口映射到容器的 80 端口（WordPress 默认运行在 80 端口）。
  • environment ： 这是配置 WordPress 连接数据库的核心 。 根据 WordPress 官方文档：
    • WORDPRESS_DB_HOST=mysql ：（必需） 数据库主机名。这里我们填写 mysql，即我们在 Compose 中定义的 MySQL 服务名。Compose 提供了内置的 DNS 解析，wordpress 容器可以通过服务名 mysql 找到 MySQL 容器。
    • WORDPRESS_DB_USER=root ：（必需） 数据库用户名。
    • WORDPRESS_DB_PASSWORD=123456 ：（必需） 数据库密码（必须与 MYSQL_ROOT_PASSWORD 一致）。
    • WORDPRESS_DB_NAME=wordpress ：（可选） 要使用的数据库名称（必须与 MYSQL_DATABASE 中创建的库名一致）。
  • volumes ：
    • wordpress:/var/www/html ：将 Docker 命名卷 wordpress 通过卷映射 到容器的 /var/www/html 目录。这是 WordPress 存放其核心文件、主题、插件和上传内容的地方。同样，这是保证网站数据不丢失的必需配置。
  • depends_on: "mysql" ： 这是服务编排的关键。 它告诉 Compose，wordpress 服务依赖于 mysql 服务。在启动时，Compose 会确保 mysql 容器启动后，再去启动 wordpress 容器，避免了 WordPress 启动时因找不到数据库而报错。

3. 顶级元素 volumes 和 networks

  • volumes: { mysql-data:, wordpress: } ： 在这里声明我们在服务中使用的"卷映射"。这让 Docker 来管理这些卷的生命周期。
  • networks: { blog: }： 声明我们要创建的 blog 网络。如果不声明，Compose 会自动创建一个默认网络。

核心命令：管理你的应用栈

现在，我们有了一个 compose.yaml 文件。我们不再需要长串的 docker run 命令，只需要在compose.yaml 文件所在的目录中执行几个简单的 docker compose 命令。

批量上线（创建并启动）

bash 复制代码 
# -d 表示 "detached"，即在后台运行
docker compose up -d

执行此命令，Compose 会：

  1. 读取 compose.yaml 文件。
  2. 创建 blog 网络（如果不存在）。
  3. 创建 mysql-data 和 wordpress 卷（如果不存在）。
  4. 拉取 mysql:8.0 和 wordpress:latest 镜像（如果本地没有）。
  5. 创建并启动 mysql 容器。
  6. 等待 mysql 启动后，创建并启动 wordpress 容器。

批量下线（停止并移除）

bash 复制代码 
docker compose down

此命令会停止并移除 mysql 和 wordpress 容器，并移除 blog 网络。

注意： 默认情况下，docker compose down 会保留数据卷（Volumes）。这是 Docker 的安全机制，防止误删数据。但是，如果你想要彻底清理（下线并删除数据卷），包括数据库和 WordPress 的数据，可以修改 down 指令如下（不推荐）：

bash 复制代码 
# -v (或 --volumes) 表示同时删除在 volumes 块中定义的命名卷
docker compose down -v

如果你还想删除服务使用到的镜像，可以使用 --rmi：

bash 复制代码 
# 删除所有服务使用的镜像
docker compose down --rmi all -v

修改更新应用

这是 Compose 最强大的功能之一。假设你修改了 compose.yaml 文件（例如，将 WordPress 的端口从 8080:80 改为 8081:80）。 你无需先执行 down。只需在更改配置后，再次运行：

bash 复制代码 
docker compose up -d

Compose 会自动进行比对与之前的 yaml 文件差别。它会发现 wordpress 服务的配置已更改，然后智能地停止、移除旧的 wordpress 容器，并用新配置创建一个新的容器。而 mysql 服务因为没有改动，会保持不动。

管理单个服务（启动/停止）

此外，你还可以对栈中的特定指定服务进行操作：

bash 复制代码 
# 停止 wordpress 服务
docker compose stop wordpress

# 启动已停止的 wordpress 服务
docker compose start wordpress

# 重启 mysql 服务
docker compose restart mysql

查看服务状态和日志

bash 复制代码 
# 查看当前 compose 栈中所有服务的运行状态
docker compose ps

# 实时查看 wordpress 服务的日志
docker compose logs -f wordpress

服务扩容（Scale）

注意：scale 命令不适用于定义了 container_name 的服务，且对于 WordPress 这种有状态应用扩容意义不大，但对于无状态 API 则非常有用

bash 复制代码 
# 假设我们有一个叫 api 的服务，将其扩容到 3 个实例
docker compose up --scale api=3 -d

总结

Docker Compose 是从"会用 Docker"到"善用 Docker"的进阶必备工具。它将复杂的、声明式的应用定义（compose.yaml）与简单的、命令式的操作（docker compose up/down）完美结合。

通过本文的 WordPress + MySQL 实例，我们看到 Compose 如何帮助我们：

  1. 声明式定义： 用一个 YAML 文件清晰描述整个应用栈。
  2. 易于管理： 使用 up, down, stop 等简单命令管理整个应用的生命周期。
  3. 依赖管理： 通过 depends_on 保证服务按正确顺序启动。
  4. 配置复用： compose.yaml 文件本身就是最好的文档，易于版本控制和团队共享。

现在，是时候把你那些散落的 docker run 命令，都统一到 compose.yaml 中了！

2025.11.1 西直门

相关推荐
Arva .6 分钟前
MySQL 的存储引擎
数据库·mysql
Logic10112 分钟前
《Mysql数据库应用》 第2版 郭文明 实验5 存储过程与函数的构建与使用核心操作与思路解析
数据库·sql·mysql·学习笔记·计算机网络技术·形考作业·国家开放大学
ljp111217 分钟前
UNRaid安装chfs
docker·免费·文件共享
昵称为空C30 分钟前
Spring Boot 项目docker分层镜像构建案例
spring boot·ci/cd·docker
kali-Myon35 分钟前
快速解决 Docker 环境中无法打开 gdb 调试窗口以及 tmux 中无法滚动页面内容和无法选中复制的问题
运维·安全·docker·容器·gdb·pwn·tmux
何中应1 小时前
【面试题-6】MySQL
数据库·后端·mysql·面试题
TDengine （老段）1 小时前
从关系型数据库到时序数据库的思维转变
大数据·数据库·mysql·时序数据库·tdengine·涛思数据·非关系型数据库
2301_768350231 小时前
MySQL服务配置与管理
数据库·mysql
管理大亨1 小时前
ELK + Redis Docker 企业级部署落地方案
大数据·运维·elk·elasticsearch·docker·jenkins
一周困⁸天.1 小时前
K8S-网络组件 Calico
网络·容器·kubernetes
热门推荐
01GitHub 镜像站点02UV安装并设置国内源03【AutoGLM部署】本地私有化部署AI手机Agent04Linux下V2Ray安装配置指南05Cursor 又偷偷更新，这个功能太实用：Visual Editor for Cursor Browser06Open-AutoGLM Windows 安装部署教程07【超详细教程】手把手教你从微软官网免费下载Windows 10官方原版ISO镜像（2025最新版）08在VSCode配置Java开发环境的保姆级教程（适配各类AI编程IDE）09BongoCat - 跨平台键盘猫动画工具10Windows 11 官方系统安装与重装完整教程（2025年最新版）