畅写在线部署

【单机部署】

一、上传部署包：在部署编辑器之前需要将部署包上传到服务器，编辑器的部署包名称为docker_deploy.zip

二、安装docker和docker-compose

#1、将部署包上传到系统中的目录，例如/usr/local/srccd /usr/local/src

#2、解压缩部署包unzip docker_deploy.zip

#3、进入到解压后的目录cd docker_deploy/docker/

#4、执行脚本安装docker和docker-composesource install.sh

三、部署并启动编辑器服务：默认情况下，docker-compose.yml文件中定义的镜像地址是畅写在阿里云上的镜像仓库地址，如果网络环境可以访问公网，则直接在线部署即可，反之选择离线部署。

【在线部署】

cd ../online/

docker-compose up -d

【离线部署】

离线部署需要先将畅写人员发送的离线镜像包上传到服务器，然后导入到本地，再部署编辑器服务。离线镜像包的名称为changxie.tar

# 例如，将离线镜像包上传到了/usr/local/src目录下，执行如下命令导入镜像到本地

docker load -i /usr/local/src/changxie.tar# 导入之后启动编辑器服务cd ../online/

docker-compose up -d

四、验证服务是否正常：打开浏览器，输入http://yourip/welcome

yourip表示部署编辑器服务的服务器IP，返回上面的信息表示编辑器已经部署成功了。

五、获取机器码：打开浏览器，输入http://yourip/info/register.html

yourip表示部署编辑器服务的服务器IP

六、做授权处理：将上一步获取到的机器码给到畅写商务人员，然后商务人员会返回一个授权文件给您，在授权页面上传即可完成授权操作。

【集群部署】

集群部署与单机部署的操作步骤是一样的，服务器由单台扩容为2台或以上。由于集群环境涉及到数据同步、统一访问入口等问题，所以需要将依赖的组件都连接外部的。具体配置方式如下：

一、畅写编辑器依赖的组件说明

二、 docker-compose.yaml中关于依赖组件的配置信息

三、 编辑器配置连接外部依赖组件配置信息详解：

四、存储(NFS)：挂载文件共享服务器的配置需要在每台部署了畅写编辑器服务的服务器上都要做

1、用文本编辑工具打开/etc/fstab配置文件，添加以下配置

2、NFS服务器地址:NFS共享目录 编辑器服务所在服务器上的挂载点 nfs defaults,_netdev 0 0

3、执行以下命令使上面的配置生效

mount -a

负载均衡和反向代理(Nginx)：

http {

    upstream changxieoffice-document-server {

        server app1:80;

        server app2:80;

        ...

    }

    server {

        server_name IP;

        listen IP:POST;

        location /doc { #该配置为websocket配置，该URI不能改

            proxy_pass http://changxieoffice-document-server;

            proxy_redirect     off; 

            client_max_body_size 100m;

            proxy_http_version 1.1; 

            proxy_set_header Upgrade $http_upgrade;

            proxy_set_header Connection "upgrade";

            proxy_set_header Host $http_host;

            proxy_set_header X-Real-IP $remote_addr;

            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

            proxy_set_header X-Forwarded-Host $host/ds-vpath;  #如果编辑器服务本身的URI未配置二级目录，只是/的话，这里也不需要带二级目录

            proxy_set_header X-Forwarded-Proto $scheme;

        }

        location ~* ^/ds-vpath { #该配置为畅写编辑器服务本身配置

            proxy_pass http://changxieoffice-document-server;

        }

    }

}