文档介绍：运维手册-组件移交语音云运维规范
--edit byfengwei
运维手册-组件移交语音云规范文档
一、概述
为了语音云整体的规范性与安全性,方便新组件移交语音云之后的运行维护,需要新组件在交接之前准备如下工作:
1)新组件需按语音云的运行环境进行相应的修改与优化,使其满足相应规范(参见第2节)。
2)在第一步规范化工作之后,提供关于新组件运行的软硬件需求、功能结构等信息介绍及维护文档(模板参见第3节)。
二、新组件移交至语音云的运行规范
磁盘规范
组件运行的服务器在移交语音云运维时,会对磁盘的raid阵列进行重新调整与初始化,针对不同的磁盘配置默认的raid初始化规则如下:
1)两块磁盘服务器:默认为单盘Raid0
2)两块以上数据库服务器:默认为系统盘双盘Raid1,剩余磁盘单盘raid0
如有特殊需求,须与运维组共同商议确定定。
目录规范
语音云现网目录有三个,/msp、/log与/channel,目的是为了实现日志、组件、大缓存文件的分离,其相应的结构划分如下:
1)/msp目录:用于存放组件本身,根据不同组件所处的功能或层级(引擎层、负载层、平台类、服务层、资源包)不同,又划分了多个二级目录(engine、loadbalance、platform、server、resource)。新组件需要根据不同的功能归类至对应二级目录下,以组件名称生成自己的三级目录(名称需与运维组商议),并将组件部署存放于自己的三级目录下(例如/msp/engine/XXX)。
如果新组件的功能较为特殊,也可以与运维组商议,新创建一个自有的二级目录(例如/msp/aiui)。
现网的组件存放目录结构可参考下图:
--edit byfengwei
2)/log目录:用于存放组件的运行状态日志,其结构需与/msp目录一致,例如/msp/engine/XXX组件的状态日志,需存放打印至/log/engine/XXX目录下,方便普通用户查阅。
日志的命名格式:当前正在生成的日志格式为””(例如/msp/engine/XXX/),历史或者切片日志的格式为”组件名称-日期(年月日时分秒).log”(例如/msp/engine/XXX/xxx-)。
3)/channel目录:用于存放大缓存文件,目录结构可与运维组共同确定,目前使用该目录的组件为flume,后续会根据需要增加。其与/log目录的结构参考图如下图:
新组件在移交之前,须该组件在自有的非root服务账户下运行。例如
ats组件需运行在ats账户而非root账户下。该服务账户创建时,需与运维组商定,分配特定的名称、uid和gid,采用非登陆式shell(/sbin/nologin)。无论用何种账户运行启动脚本或操作命令时,该组件都能以自有的用户身份启动运行。
新组件运行时若有固定端口号,需提前与运维组确认是否与现网服务端口号冲突。
监控守护与部署规范
新组件须要有开机自启动机制与守护机制。若无特殊情况,须集成语音云的pmi动态库,供pmc组件监控守护。关于守护方式上,也可与监控组运维组协商,使用自己的守护程序。