image.png

环境要求

  1. 系统建议使用 Linux 或 Unix 系统，Windows 系统还没有写相应的一键部署脚本，请参照 build_docker.sh 脚本中的命令自行测试；
  2. docker：可以使用 国内安装源 进行安装，具体请自行检索；
  3. docker-compose：推荐使用 pip 安装，国内直接使用 Github 的 Release 有点慢。

构建镜像

进入项目目录，直接执行以下命令：

  1. # 给build_docker.sh脚本增加可执行权限
  2. $ chmod +x ./build_docker.sh
  3. # 给mvnw增加可执行权限
  4. $ chmod +x ./mvnw
  5. $ ./build_docker.sh --log

显示Docker镜像构建完成说明镜像构建完成。

关于 build_docker.sh 脚本的参数说明

  • -l 或 --log 查看构建日志，不使用该参数，默认不显示构建日志

查看构建好的镜像

执行 docker images查看构建好的镜像：

  1. $ docker images
  2. REPOSITORY       TAG        IMAGE ID       CREATED         SIZE
  3. linkwechat       latest     91a5c7769454   18 hours ago    260MB
  4. linkwechat       3.1.0      91a5c7769454   18 hours ago    260MB

运行 docker 中构建好的镜像

修改docker-compose.yml

在运行之前请检查docker-compose.yml文件中的配置，按照自己的需要配置相应的端口号、目录挂载以及服务的host等信息

运行构建好的镜像

建议使用docker-compose运行镜像，在项目根目录执行以下命令：

  1. # 启动服务
  2. $ docker-compose up -d
  3. # 关闭服务
  4. $ docker-compose down

关于构建脚本的一些说明

  • 第一次使用build_docker.sh脚本进行镜像构建时，建议添加--log参数以打印构建日志
  • 首次执行时，会自动下载项目所需的maven工具，可能需要等待一些时间

如果等待时间过久，或出现连接超时等问题，建议替换.mvn/wrapper/maven-wrapper.properties文件中的distributionUrl为:
https://mirrors.tuna.tsinghua.edu.cn/apache/maven/maven-3/3.6.3/binaries/apache-maven-3.6.3-bin.zip

  • 如果有其他问题，建议保留日志截图，并在gitee上对本项目提issue