运维手册-组件移交语音云运维规范.docxVIP

运维手册-组件移交语音云规范文档一、概述为了语音云整体的规范性与安全性，方便新组件移交语音云之后的运行维护，需要新组件在交接之前准备如下工作：1）新组件需按语音云的运行环境进行相应的修改与优化，使其满足相应规范（参见第2节）。2） 在第一步规范化工作之后，提供关于新组件运行的软硬件需求、功能结构等信息介绍及维护文档（模板参见第3节）。二、新组件移交至语音云的运行规范2.1 磁盘规范组件运行的服务器在移交语音云运维时，会对磁盘的raid阵列进行重新调整与初始化，针对不同的磁盘配置默认的raid初始化规则如下：1）两块磁盘服务器：默认为单盘Raid02）两块以上数据库服务器：默认为系统盘双盘Raid1，剩余磁盘单盘raid0如有特殊需求，须与运维组共同商议确定定。2.2 目录规范语音云现网目录有三个，/msp、/log与/channel,目的是为了实现日志、组件、大缓存文件的分离，其相应的结构划分如下：1）/msp目录：用于存放组件本身，根据不同组件所处的功能或层级（引擎层、负载层、平台类、服务层、资源包）不同，又划分了多个二级目录（engine、loadbalance、platform、server、resource）。新组件需要根据不同的功能归类至对应二级目录下，以组件名称生成自己的三级目录（名称需与运维组商议），并将组件部署存放于自己的三级目录下（例如/msp/engine/XXX）。如果新组件的功能较为特殊，也可以与运维组商议，新创建一个自有的二级目录（例如/msp/aiui）。现网的组件存放目录结构可参考下图：2）/log目录：用于存放组件的运行状态日志，其结构需与/msp目录一致，例如/msp/engine/XXX组件的状态日志，需存放打印至/log/engine/XXX目录下，方便普通用户查阅。日志的命名格式：当前正在生成的日志格式为”组件名称.log”（例如/msp/engine/XXX/xxx.log）,历史或者切片日志的格式为”组件名称-日期（年月日时分秒）.log”（例如/msp/engine/XXX/xxx-20160615233010.log）。3）/channel目录：用于存放大缓存文件，目录结构可与运维组共同确定，目前使用该目录的组件为flume，后续会根据需要增加。其与/log目录的结构参考图如下图：2.3运行规范新组件在移交之前，须该组件在自有的非root服务账户下运行。例如ats组件需运行在ats账户而非root账户下。该服务账户创建时，需与运维组商定，分配特定的名称、uid和gid，采用非登陆式shell（/sbin/nologin）。无论用何种账户运行启动脚本或操作命令时，该组件都能以自有的用户身份启动运行。新组件运行时若有固定端口号，需提前与运维组确认是否与现网服务端口号冲突。2.4 监控守护与部署规范新组件须要有开机自启动机制与守护机制。若无特殊情况，须集成语音云的pmi动态库，供pmc组件监控守护。关于守护方式上，也可与监控组运维组协商，使用自己的守护程序。部署方式上，要求新组件在部署或扩容时，无需编译或交互，采用直接拷贝的方式部署，以便集成于自动化部署平台。2.5 配套基础配置与服务新组件移交语音云，对于服务器的基础配置（如主机名、DNS、网卡、时间同步等）都会进行重新设置，并配套部署语音云监控组件pmc、自动化部署组件pauto、配置管理组件salt以及日志收集组件flume（可选），需确认新组件服务能在新的环境下正常运行。三、组件信息介绍文档模板新组件交接时需单独准备组件信息交接文档《XXX组件移交运维文档》，内容需包括如下小节（格式可直接复制）：XXX组件运维交接文档1）组件简要介绍介绍需涵盖组件的简单相关概况，使得运维人员能够简要了解该组件的功能用途和基本信息，例如xxx组件是什么组件，实现什么功能。2）组件上下游功能结构图需绘制组件功能调用图并做简要描述。（示例如下）链路执行顺序大致概括如下：1.请求从nginx接入mss服务器，之后由src组件合并同时调用sluaspk组件，调用spk引擎，判断该请求是属于音乐还是语音请求，之后将请求转给音乐检索链路模块或语音搜歌链路模块。2.音乐检索与语音检索模块执行识别任务之前，对应的组件（sluaqbh和sluaiat）3.会调用登录验证及授权模块（对应组件为srpcs），获取授权及认证。4.执行音乐检索或语音检索模块，结果会返回给src。5.在收到音乐与语音模块返回识别结果之后，src组件将调用stlua组件将识别结果转给存放第三方业务脚本的windows-mss服务器，由win-mss上的stluarpcs调用三方业务脚本去与知识云通信，或将结果反馈给灵犀或者酷音铃声应用供其调用。3）组件信息概览表类别信息1信息2组件名称组件英