Ducter任務与操作脚本编写及使用指南副本.docxVIP

Ducter任务与操作脚本编写及使用指南(V1.0)变更记录日期状态描述作者2014-12-10V0.1初稿cwinux目录1简述42任务脚本42.1任务脚本说明42.2任务脚本的运行环境52.3任务脚本的执行结果文件62.4任务最佳实践72.4.1服务软件包存储72.4.2服务的安装位置82.4.3实现实例93操作脚本213.1操作脚本说明213.2操作脚本例子：213.2.1获取服务器运行进程信息脚本：ps213.2.2获取服务器/proc下信息的脚本：proc_info22简述在产品与服务器的控制与操作上，Ducter只是提供了命令执行的通道、策略及执行的环境，而具体的命令动作完全是由用户自己编写的任务脚本或操作脚本实现的。本手册详细介绍ducter为任务、操作脚本提供的执行环境及编写要求，以便使用者可以正确、快速的编写自己项目所需要的脚本。任务脚本任务的本质是为用户提供在一个服务器集群上安全、可靠、可视、自动执行命令的平台。执行的命令由用户采用各种脚本语言开发，可以用作服务重启、上线等各种目的。而Ducter任务只是按照用户的要求，调度任务脚本在不同服务器上有次序自动执行，并为脚本执行提供所需要的运行环境。下面从任务脚本的运行环境、任务脚本输出、任务最佳实践三个方面描述任务脚本的编写。任务脚本说明任务指令名称：任务指令名称为[a-z,A-Z,0-9,_]范围内的字符。任务指令script文件：dcmd_task_【任务指令名称】.script，其保存在dcmd_center所在的服务器上，存放位置由dcmd_center配置文件的【common：task_script_path】的参数项指定任务指令的参数：参照【任务脚本的运行环境】任务指令的输出：参照【任务脚本的执行结果文件】任务脚本的运行环境Ducter通agent完成任务脚本在服务器上的执行，而且是按照【服务】所指定的OS用户执行。Agent在服务器上执行任务脚本的时候，会清空所有的OS环境变量信息，仅仅提供如下的环境变量供任务脚本使用DCMD_APP_NAME产品名字，可由【字母】、【数字】、【_】组成的任何字符。 DCMD_SVR_ENV_V服务池子的环境版本，可由【字母】、【数字】、【_】组成的任何字符。其在服务的服务池中设定。 DCMD_SVR_IP：执行任务的注册服务器的IP地址 DCMD_SVR_NAME：服务的名字，可由【字母】、【数字】、【_】组成的任何字符DCMD_SVR_NODE_MUTIL_POOL：服务是否允许在一个设备上有多个服务池。1：允许；0：不允许其在服务中设定 DCMD_SVR_PATH：服务在设备上的安装路径，此为OS的绝对路径。其在服务中设定 DCMD_SVR_POOL：服务池的名字，可由【字母】、【数字】、【_】组成的任何字符此为设备所属的服务池。DCMD_SVR_PROCESS：是否实时输出执行进度，在创建任务时指定 DCMD_SVR_REPO：服务的版本库地址，在服务池中设定。此可以是svn、http、ftp、git等等的地址 DCMD_SVR_RESULT_FILE：任务执行结果文件名，由ducter agent指定 DCMD_SVR_UPDATE_ENV是否无条件更新服务的环境配置信息，在创建任务时指定 DCMD_SVR_UPDATE_TAG：是否无条件更新服务软件包，在创建任务时指定 DCMD_SVR_USER：任务执行的OS账号，在服务中设定 DCMD_SVR_VERSION当前任务对应的服务的版本号，可由【字母】、【数字】、【_】组成的任何字符在创建任务时指定 DCMD_SYS_AGENT_PID：当前ducter agent的进程IDDCMD_SYS_AGENT_PPID：当前ducter agent的父进程IDDCMD_TASK_xxxx：用户脚本定义的参数xxxx，值在创建任务时指定，任务模板可以设置缺省值值可由【字母】、【数字】、【_】组成的任何字符DCMD_TASK_POOL_yyyy：服务池的属性yyyy，值在服务池属性中指定值可由【字母】、【数字】、【_】组成的任何字符任务脚本的执行结果文件任务脚本是否执行成功，是通过任务脚本执行输出结果文件指定的。任务脚本的执行结果文件，是由任务脚本的环境变量$DCMD_SVR_RESULT_FILE指定。$DCMD_SVR_RESULT_FILE环境变量指定文件的内容如下：process=进度此为任意的字符串，必须在一行。可以多次输出，最后一次输出的值为真正的进度值。state=success/failure输出state表示执行状态；success：成功；failure：失败。必须在一行。err=错误信息若任务执行失败，则记录错误信息。错误信息可以多行。任务