使用 Docker Compose 启动产禅道并配置外部 MySQL 的详细指南

在现代软件开发中，使用 Docker 来管理应用程序环境越来越流行。通过 Docker Compose，我们可以轻松管理多个服务，同时整合各种工具以实现高效的开发和部署。本篇文章将介绍如何通过 Docker Compose 启动产禅道，并配置外部 MySQL 数据库。我们将从环境配置、代码示例，到序列图和旅行图，逐步完成整个过程。

1. 环境准备

在开始之前，确保你的系统上已经安装了以下软件：

  • Docker
  • Docker Compose

如果你还没有安装这些软件，可以参考官方文档进行安装。

2. 创建项目目录

首先，创建一个新的项目目录来存放相关配置文件：

mkdir zenhub-docker
cd zenhub-docker

3. 设置 Docker Compose 文件

在项目目录中创建一个名为 docker-compose.yml 的文件，并在其中写入以下内容：

version: '3.7'

services:
  zenhub:
    image: zenoss/zenhub:latest
    restart: always
    environment:
      - DB_HOST=mysql-db
      - DB_USER=zenhub_user
      - DB_PASSWORD=your_password
      - DB_NAME=zenhub_db
    ports:
      - "8080:80"
    depends_on:
      - mysql-db

  mysql-db:
    image: mysql:5.7
    restart: always
    environment:
      - MYSQL_DATABASE=zenhub_db
      - MYSQL_USER=zenhub_user
      - MYSQL_PASSWORD=your_password
      - MYSQL_ROOT_PASSWORD=root_password
    ports:
      - "3306:3306"

在这里，我们定义了两个服务：zenhub（产禅道）和 mysql-db（MySQL数据库）。我们通过环境变量来配置连接信息。

4. 启动服务

确保 MySQL 数据库的环境变量中配置的用户和密码符合你的需求，然后使用以下命令启动服务：

docker-compose up -d

这会在后台启动配置的服务。你可以使用以下命令查看服务的状态：

docker-compose ps

5. 连接 MySQL 数据库

在启动数据库后，可以使用 MySQL 客户端连接到数据库验证是否成功：

docker exec -it zenhub-docker_mysql-db_1 mysql -u zenhub_user -p

使用上面在 docker-compose.yml 中配置的密码进入 MySQL。

输入 SHOW DATABASES; 来检查数据库是否已创建。

6. 启动产禅道

在成功连接到数据库后，访问 http://localhost:8080 来启动产禅道的配置向导，按照页面上的提示完成配置。

序列图

在启动过程中，各个组件之间的交互关系可以通过序列图来展示。下面是一个简单的序列图，展示了产禅道如何与 MySQL 进行交互：

sequenceDiagram
    participant C as Client
    participant Z as Zenhub
    participant M as MySQL Database

    C->>Z: Request for service
    Z->>M: Query database
    M-->>Z: Return data
    Z-->>C: Respond with service data

7. 旅行图

为了展示用户的使用过程，我们也可以使用旅行图来表示用户访问产禅道的步骤。

journey
    title User journey for Zenhub setup
    section Start Service
      User starts Docker Compose: 5: User
      Docker Compose starts services: 5: Docker
    section Access Application
      User visits http://localhost:8080: 5: User
      Zenhub loads configuration: 5: Zenhub
    section Database Interaction
      Zenhub connects to MySQL: 5: Zenhub
      MySQL returns database data: 5: MySQL
    section Finish Setup
      User completes setup: 5: User

8. 注意事项

  • 确保防火墙允许访问所配置的端口（8080 和 3306）。
  • 在生产环境中使用时，建议对 Docker 大小的机器进行合理配置，避免资源不足的问题。
  • 如果在使用过程中出现问题，可以使用 docker-compose logs 来查看各个服务的日志输出。

结论

通过 Docker Compose 启动产禅道并配置外部 MySQL 数据库的步骤相对简单。本文从环境准备、代码示例到可视化组件交互，详细阐述了整个过程。这种方法不仅提高了开发效率，而且使得服务的管理变得易于维护和扩展。

希望这篇文章能帮助你顺利搭建产禅道环境。如果您有任何问题或建议，请随时与我们分享，让我们在探讨中一起进步！