mall项目在Linux环境下基于Docker的部署

Mall项目是一个基于Spring Boot、Spring Cloud、MyBatis、Redis等技术栈构建的微服务电商系统。为了简化在生产环境中的部署，我们可以基于Docker进行打包和部署，使其能够快速、稳定地运行在Linux服务器上。本文将详细介绍如何在Linux环境下基于Docker部署mall项目。

一、前置条件

在开始部署之前，需要确保以下软件和工具已经正确安装并配置：

Linux服务器：运行mall项目的操作系统（如Ubuntu或CentOS）。
Docker：Docker容器工具，用于打包和运行应用程序。
Docker Compose（可选）：如果需要管理多个服务（如数据库、Redis、Nginx等），可以使用Docker Compose。

二、Docker安装与配置

2.1 安装Docker

如果尚未安装Docker，可以按照以下步骤进行安装（以Ubuntu为例）：

# 更新包索引
sudo apt-get update

# 安装必要的软件包
sudo apt-get install apt-transport-https ca-certificates curl software-properties-common

# 添加Docker的官方GPG密钥
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

# 添加Docker的APT源
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

# 安装Docker
sudo apt-get update
sudo apt-get install docker-ce

# 启动并配置Docker服务
sudo systemctl start docker
sudo systemctl enable docker

2.2 验证Docker安装

执行以下命令，验证Docker是否正确安装：

docker --version

返回类似 Docker version xx.xx.xx 表示安装成功。

三、编写Dockerfile

为了将mall项目打包为Docker镜像，需要编写一个 Dockerfile。Dockerfile 是用来定义如何构建应用程序容器的文件。在mall项目的根目录下创建一个 Dockerfile 文件，内容如下：

# 使用Java基础镜像
FROM openjdk:8-jdk-alpine

# 作者信息
MAINTAINER YourName <your.email@example.com>

# 创建工作目录
WORKDIR /app

# 将jar包复制到容器中
COPY target/mall.jar /app/mall.jar

# 暴露端口
EXPOSE 8080

# 运行jar包
ENTRYPOINT ["java", "-jar", "mall.jar"]

说明：

FROM openjdk:8-jdk-alpine：使用轻量级的Alpine Linux基础镜像，预装了Java 8。
WORKDIR /app：在容器内部创建并使用 /app 目录作为工作目录。
COPY target/mall.jar /app/mall.jar：将本地编译好的 mall.jar 文件复制到容器的 /app 目录下。
EXPOSE 8080：暴露8080端口供外部访问。
ENTRYPOINT：定义容器启动时执行的命令，这里运行Java应用程序。

四、构建Docker镜像

在mall项目的根目录下，确保已经编译并生成了 mall.jar 文件（通常在 target 文件夹下）。如果没有生成，可以执行以下Maven命令：

mvn clean package

接着，执行以下命令构建Docker镜像：

docker build -t mall:latest .

解释：

docker build：命令用于构建Docker镜像。
-t mall:latest：为镜像指定名称 mall 和标签 latest。

构建完成后，可以通过以下命令查看构建好的镜像：

docker images

五、运行容器

构建完成后，使用以下命令运行Docker容器：

docker run -d -p 8080:8080 --name mall-container mall:latest

解释：

-d：后台运行容器。
-p 8080:8080：将主机的8080端口映射到容器的8080端口。
--name mall-container：为容器指定名称 mall-container。
mall:latest：运行之前构建的 mall 镜像。

六、检查服务状态

运行容器后，可以通过以下命令查看运行中的容器：

docker ps

输出类似如下内容表示容器运行成功：

CONTAINER ID  IMAGE        COMMAND             CREATED        STATUS        PORTS                    NAMES
a1b2c3d4e5f6  mall:latest  "java -jar mall.jar" 2 minutes ago  Up 2 minutes  0.0.0.0:8080->8080/tcp   mall-container

通过访问 http://your-server-ip:8080，可以验证mall项目是否成功启动。

七、使用Docker Compose管理服务（可选）

如果mall项目依赖多个服务（如MySQL、Redis等），可以使用 Docker Compose 来管理。首先，在项目根目录创建一个 docker-compose.yml 文件：

version: '3'
services:
  mall:
    image: mall:latest
    build:
      context: .
      dockerfile: Dockerfile
    ports:
      - "8080:8080"
    depends_on:
      - mysql
      - redis
    environment:
      SPRING_DATASOURCE_URL: jdbc:mysql://mysql:3306/mall?useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai
      SPRING_REDIS_HOST: redis

  mysql:
    image: mysql:5.7
    environment:
      MYSQL_ROOT_PASSWORD: root
      MYSQL_DATABASE: mall
    ports:
      - "3306:3306"
    volumes:
      - ./mysql-data:/var/lib/mysql

  redis:
    image: redis:alpine
    ports:
      - "6379:6379"

说明：

mall 服务：依赖MySQL和Redis服务，并且通过环境变量配置数据库和Redis连接。
mysql 服务：使用 mysql:5.7 镜像，并且创建数据库 mall。
redis 服务：使用 redis:alpine 镜像。

7.1 启动服务

使用 docker-compose 启动所有服务：

docker-compose up -d

-d 参数表示后台运行。启动完成后，可以通过 docker-compose ps 查看服务状态。

八、常见问题及解决

8.1 端口冲突

如果在运行容器时出现端口冲突，可以通过修改 Dockerfile 或 docker-compose.yml 中的端口映射来避免冲突。例如：

ports:
  - "8081:8080"

8.2 数据库连接问题

确保在 docker-compose.yml 中正确配置了MySQL的环境变量，特别是数据库地址、端口和用户名密码。启动后，确保数据库已经启动，并且可以通过MySQL客户端连接。

8.3 容器日志查看

当容器无法正常启动时，可以通过查看容器日志来排查问题：

docker logs mall-container

九、总结

通过以上步骤，我们可以在Linux环境下基于Docker快速部署mall项目。Docker极大地简化了应用的部署流程，使得环境一致性得以保障，同时通过Docker Compose可以轻松管理多个服务。

mall项目的Docker化部署不仅提升了开发和部署效率，还为未来的运维工作（如自动化部署、CI/CD集成）打下了坚实的基础。