## 自动部署服务和阿里云OSS的使用
为简化手工部署项目的操作。目前实现了一套进行自动化部署系统。以下介绍如何使用:
### 一. 安装和配置客户端：
- 第一次使用，需在自己电脑安装和配置阿里云oss客户端:
- 下载安装阿里云ossBrowser客户端：https://help.aliyun.com/document_detail/209974.htm#task-2065478
- 客户端配置信息：
```
endpoint=oss-cn-hangzhou.aliyuncs.com
accessKeyID=${yourAccessKeyID}
accessKeySecret=${yourAccessKeySecret}
预设OSS路径：oss://ztupload/
```
上述仅为演示。具体的key和secret, 此文档之外单独提供。上面没提到的，保持为空
bucket名：**ztupload**, 打开客户端后, 此bucket下目录层级如下:
```
.
├── production
│ ├── investigate
│ │ ├── backEnd
│ │ │ └── investigate.jar
│ │ └── frontEnd
│ │ └── zhuize.zip
│ ├── logs
│ │ ├── autoDeploy.log
│ │ └── ${serviceName}.log
│ └── ztsjxxxt
│ ├── backEnd
│ │ └── ztsjxxxt.jar
│ └── frontEnd
│ └── html.zip
└── stage
├── investigate
│ ├── backEnd
│ │ └── investigate.jar
│ └── frontEnd
│ └── zhuize.zip
├── logs
│ ├── autoDeploy.log
│ └── ${serviceName}.log
└── ztsjxxxt
├── backEnd
│ └── ztsjxxxt.jar
└── frontEnd
└── html.zip
```
其中：
1. 追责前端包叫zhuize.zip,后端包叫investigate.jar；审计前端包叫html.zip, 后端包叫ztsjxxxt.jar
2. production对应中铁环境，stage对应公司内网环境。
3. 请保持文件目录结构和文件与上面的目录树完全一致，**不要修改现有目录结构、删除现有文件，或额外上传其他不相关的文件**。
4. logs目录下包含:
- autoDeploy.log: 自动部署服务执行过程中发生事件的相关log。上传前端zip包，5分钟内，会触发此文件更新。
- ${serviceName}.log: 为后端服务相关log, 比如investigate.log。上传后端jar包, 5分钟内，会触发此文件更新。
### 二. 手动执行部分
安装并配置好oss客户端后, 日常发版需执行以下操作
#### 1. 上传
1. 将特定项目的特定构建完成的前端/后端包，上传到阿里云特定的私有存储桶下的特定位置，无需删除原有文件，直接上传同名文件，会自动替换掉原有文件。
2. 5分钟后，对应服务会自动使用新包部署完成。
> 注意！不要执行上传新包覆盖现有包之外的其他动作。如果不小心上传错了位置、删了oss里现有的老包, 不会触发自动部署。但如果修改了目录层级或目录名，**后续正常的自动部署将不会执行!**
#### 2. 查看log (可选操作)
以下操作可了解部署详情
1. 上传完成5分钟后，用ossBrowser查看并刷新 production/${项目名}/${logs} 目录下的内容
2. 如果上传的是前端zip包，logs目录下的autoDeloy.log的文件创建时间会更新到最新。点击查看log，找到类似如下图的相关信息
3. 如果上传的是后端jar包，logs目录下的${项目名}.jar的文件创建时间会更新到最新。点击查看log，找到类似如下图的相关信息
#### 3. 校验 (可选操作)
为确保上传的包和部署成功的包版本一致，可查看本地最新构建好的包的md5值，和log中描述的业务服务中使用的最新jar/zip包的md5值(也就是上图中划线部分的md5值)是否一致, 以便确认。
### 三. 自动执行部分
以下部分无需手动执行, 自动完成, 仅作为介绍。
1. 每台受此系统纳管的虚机，通过5分钟定时任务，去阿里云此存储桶下特定位置，查看特定文件的md5信息，如果发现和本地缓存的包的md5值不一致，就进行下载，替换本地缓存的包。
2. 相关服务重启时，先验证本地缓存包是否和当前服务正在使用的包的md5值是否一样，如果不一样，把本地缓存包替换到项目运行目录下，替换正在运行的包。kill掉服务进程，重新开启进程。
3. 相关log会上传到oss中