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

运维手册-组件移交语音云规范文档
一、概述
为了语音云整体的规范性与安全性，方便新组件移交语音云之后的运行维护，需要新组件在交接之前准备如下工作：
1）新组件需按语音云的运行环境进行相应的修改与优化，使其满足相应规范（参见第2节）。me，后续会根据需要增加。其与/log目录的结构参考图如下图：

新组件在移交之前，须该组件在自有的非root服务账户下运行。例如ats组件需运行在ats账户而非root账户下。该服务账户创建时，需与运维组商定，分配特定的名称、uid和gid，采用非登陆式shell（/sbin/nologin）。无论用何种账户运行启动脚本或操作命令时，该组件都能以自有的用户身份启动运行。
新组件运行时若有固定端口号，需提前与运维组确认是否与现网服务端口号冲突。
监控守护与部署规范
新组件须要有开机自启动机制与守护机制。若无特殊情况，须集成语音云的pmi动态库，供pmc组件监控守护。关于守护方式上，也可与监控组运维组协商，使用自己的守护程序。
部署方式上，要求新组件在部署或扩容时，无需编译或交互，采用直接拷贝的方式部署，以便集成于自动化部署平台。
配套基础配置与服务
新组件移交语音云，对于服务器的基础配置（如主机名、DNS、网卡、时间同步等）都会进行重新设置，并配套部署语音云监控组件pmc、自动化部署组件pauto、配置管理组件salt以及日志收集组件flume（可选），需确认新组件服务能在新的环境下正常运行。
三、组件信息介绍文档模板
新组件交接时需单独准备组件信息交接文档《XXX组件移交运维文档》，内容需包括如下小节（格式可直接复制）：

XXX组件运维交接文档
1）组件简要介绍
介绍需涵盖组件的简单相关概况，使得运维人员能够简要了解该组件的功能用途和基本信息，例如xxx组件是什么组件，实现什么功能。
2）组件上下游功能结构图
需绘制组件功能调用图并做简要描述。（示例如下）
链路执行顺序大致概括如下：
，之后由src组件合并同时调用sluaspk组件，调用spk引擎，判断该请求是属于音乐还是语音请求，之后将请求转给音乐检索链路模块或语音搜歌链路模块。
，对应的组件（sluaqbh和sluaiat）
（对应组件为srpcs），获取授权及认证。
，结果会返回给src。
，src组件将调用stlua组件将识别结果转给存放第三方业务脚本的windows-mss服务器，由win-mss上的stluarpcs调用三方业务脚本去与知识云通信，或将结果反馈给灵犀或者酷音铃声应用供其调用。
3）组件信息概览表
类别
信息1
信息2
组件名称
组件英文名
组件中文名
组件版本号
？
组件包含的类别层级
业务层+引擎+资源
属于哪一层组件（接入、服务、负载、引擎、数据库等）
开发负责人
姓名
部门组别联系方式
测试负责人
姓名
部门组别联系方式
运维责任人
姓名
部门组别联系方式
组件运行固定端口
组件运