1.软件依赖

操作系统

Linux

• Ubuntu 16.04+
• CentOS 7+
• 不同操作系统中运行Docker不同版本的兼容性问题：https://success.docker.com/article/compatibility-matrix.

Windows

• Windows Server 2016 +

Docker

Docker 是一个开源的应用容器引擎，让开发者可以打包他们的应用以及依赖包到一个可移植的镜像中，然后发布到任何流行的 Linux或Windows 机器上，也可以实现虚拟化。容器是完全使用沙箱机制，相互之间不会有任何接口。

举个例子：在一艘大船上，可以把货物规整的摆放起来。并且各种各样的货物被集装箱标准化了，集装箱和集装箱之间不会互相影响。那么我就不需要专门运送水果的船和专门运送化学品的船了。只要这些货物在集装箱里封装的好好的，那我就可以用一艘大船把他们都运走。

Docker就是类似的理念。

• 安装Docker:
  文档：https://docs.docker.com/engine/install/ubuntu/

安装成功之后执行以下两个命令

Docker Compose

定义和运行多个 Docker 容器的应用

Docker Compose 是一个工具，这个工具可以通过yml文件定义多容器的Docker应用
通过一条命令就可以根据yml文件的定义去创建或者管理这多个容器。

• 安装Docker Compose :
  文档：https://docs.docker.com/compose/install/

安装完成之后验证是否安装成功

Git

• 安装Git以及常用工具

Java JDK-Amazon Corretto

• 安装Java JDK-Amazon Corretto
  文档：https://aws.amazon.com/cn/corretto/
• 设置环境变量

安装完成之后验证是否安装成功

Maven

• 安装Maven
  文档：https://maven.apache.org/install.html
• 设置环境变量

安装完成之后验证是否安装成功

2.源码构建

官方代码库及镜像

源码与镜像的关联

下载源码

• 使用Git Clone
  git clone https://github.com/chatopera/cosin.git
  或者
  git clone git@github.com:chatopera/cosin.git

• 使用浏览器
  

文件目录

• 安装机器人客服插件
  cd ~/cosin
./public/plugins/chatbot/scripts/install.sh
  注意：如果是windows系统的话，需要使用Git Bash等Windows下的命令行工具来运行安装脚本

构建镜像

• 生成J2EE应用包
  cd ~/cosin/contact-center
./admin/package.sh
  执行完之后查看是否生成
  ls ./app/target/*.war
• 生成Docker镜像

1. cd ~/cosin/contact-center  2. PACKAGE_VERSION='git rev-parse --short HEAD' # 当前源码版本 3. docker build --build-arg VCS_REF=$PACKAGE_VERSION     --build-arg APPLICATION_BUILD_DATESTR=`date "+%Y%m%d.%H%M%S"`     --build-arg APPLICATION_CUSTOMER_ENTITY=OSC     --no-cache     --force-rm=true --tag chatopera/contact-center:$PACKAGE一VERSION .  

成功之后会看到

发布镜像

• 发布到DockerHub
  docker push chatopera/contact-center:295dc27 //chatopera可以换成自己需要的名字
• 本地保存和加载
  保存：docker save chatopera/contact-center:295dc27 > IMAGE.tgz
  加载：docker load < IMAGE.tgz

3.配置及运行

docker-compose.yml

春松客服的容器编排
vim docker-compose.yml ：描述文件，需要把此文件中services 标签下的contact-center服务中的image改成自己的镜像名称或ID
vim .env ：此文件需要与docker-compose.yml在同级目录下，此文件中设置的环境变量会覆盖docker-compose.yml中的环境变量

启动服务

docker-compose up –d contact-center //运行
docker-compose logs –f contact-center //查看日志
docker-compose ps //查看各个容器状态

停止服务

docker-compose down //停止

4. 服务访问

在项目启动完成之后，使用浏览器访问 https://localhost:8035 （CC_WEB_PORT没有变更的情况下默认为 8035）
默认管理员账号： admin 密码： admin1234

5.延伸阅读

春松客服开源版的HTTPS部署
春松客服测试访客端
春松客服的开发环境