2. 工单系统¶

请先参考快速入门手册，后续补充该章节内容

2.1. 原理¶

详见快速入门手册概述部分

2.2. 管理员配置手册¶

详见快速入门手册demo章节

2.2.1. 基础配置¶

环境分类：如PROD表示生产环境，STAGE表示准生产环境，激活的工单应该归属其中一个环境分类，用户提单的时候可以在提单页面该环境标签下找到相应的工单

用途分类：为每个类型的项目单独创建一个分类，比如docker项目创建创建DeployDocker分类；git静态文件项目创建DeployGit分类

2.2.2. 配置中心¶

官方插件配置中心使用ansible服务器做配置任务管理

原则上只要配置中心支持skstack web通过 ssh登录，并执行上面的命令或脚本，就可以注册到skstack

参考示例快速入门配置中心.

2.2.3. 变量配置¶

每定义一个任务工单，可以传递外部可选变量（用户可选）、内部自定义变量（对用户不可见）、系统内置变量（用户不可见）给工单

2.2.3.1. 可选变量¶

通过变量注册的方式定义，通过外部脚本或者管理员定义。格式为list ，如 [“host1”,”host2”,”host3”]

脚本获取，通过变量获取脚本动态获取可选变量。示例docker发布插件项目变量.

管理员定义，管理员可以定义一个变量并提供一组参数给用户选择。实例docker发布插件执行模式变量.

2.2.3.2. 内置变量¶

新增工单时编辑内部自定义变量

格式为dict 如{“GitProjName”:”app01”} key为变量名，value为值

内部变量主要用于静态变量，不会动态更新，默认可为空，工单配置管理员可以根据需求进行设置。

2.2.3.3. 系统变量¶

目前skstack只有如下系统变量可使用：

sk__name 本工单名称

sk__env 本工单管理环境名称

注解

内置变量以”sk__”开头（这里有两个下划线），是skstack系统内置变量，便于不同项目相同类型的工单进行快速配置。

2.2.3.4. 变量传递¶

内部变量和外部变量都通过”{变量名}” 传递给任务脚本；

如 python main_deploy_git.py -e prod -g “{GitProjName}” -i “{AnsibleHosts}”

2.2.4. 工单配置¶

::: 工单名字：工单名可以通过内置变量{sk__name}变量传递给前置任务、主任务、后置任务脚本

项目描述：改工单所发布的项目进行简要描述，方便提单用户通过帮助按钮阅读提单权限用户：选择具有提单权限的用户组，需要先到用户管理界面添加相关用户组项目环境：关联的项目环境可以通过{sk__env}变量传递给前置任务、主任务、后置任务脚本，不同环境下的工单，会显示在对应的环境分类标签下项目分类：可以根据不同项目类型自定义分类是否激活工单：激活 #未激活工单，提单用户无法看到内置变量：管理员可以自定义内置变量传递给脚本使用，参考变量配置章节可选参数组：一个工单可以关联一个参数组，一个参数组可以关联多个可配置变量，在用户提单的时候，用户可以选择关联参数组中关联的变量参数前置任务：提单的时候会执行的任务，一般用在审核之前或主任务执行之前做提前检查任务和预配置任务，可以留空主任务：一般配置本工单主要执行的任务脚本后置任务：主任务执行完成后，执行的脚本，比如通知任务，可以留空是否开启审核：开启审核，后需要关联审核流程审核流程：关联审核流程，配置可参考用户系统，审核流程配置环节是否开启任务锁：开启后，同一个环境下的同一个命名的工单，只能提交一次，必须在工单完成后（工单任务状态显示为成功、失败、撤销、拒绝时），才能创建新的同名工单配置中心：默认配置中心和skstack web系统在同一台服务器，若使用其他配置中心，请在此处管理。一般一个环境或者一个数据中心单独一个配置中心其余选项：暂未上线，不勾选