6.7. 任务模板中的问卷调查
运行或检查 的作业类型 提供了一种在 作业模板 创建或编辑屏幕中设置问卷调查的方法。问卷调查为 playbook 设置额外变量,类似于 Prompt for Extra Variables,但采用用户友好的问题和答案方式。调查还允许验证用户输入。选择 Survey 选项卡来创建问卷调查。
Example
您可以在几个情况下使用问卷调查。例如,操作希望为开发人员提供一个 "push to stage" 按钮,无需提高 Ansible 知识即可运行。启动后,此任务可以提示输入问题的回答,如"应该如何发布标签?"。
您可以询问许多类型的问题,包括多选问题。
6.7.1. 创建问卷调查
流程
-
在导航面板中,选择
。 - 选择您要为其创建调查的作业模板。
- 在 Survey 选项卡中,单击 。
问卷调查可由任意数量的问题组成。对于每个问题,输入以下信息:
- 问题 :询问用户的问题。
- 可选: 描述: 描述用户被要求的内容。
- 回答变量名称 :用于存储用户响应的 Ansible 变量名称。这是 playbook 要使用的变量。变量名称不能包含空格。
回答类型 :从以下问题类型中选择:
- 文本: 单行文本。您可以为此回答设置最小和最大长度(字符数)。
- 文本域:多行文本字段。 您可以为此回答设置最小和最大长度(字符数)。
- 密码 :响应被视为敏感信息,就像实际密码一样被处理。您可以为此回答设置最小和最大长度(字符数)。
- 多项选择(单选 ):选项列表,一次只能选择一个。在 Multiple Choice Options 字段中输入选项(每行一个)。
- 多项选择(多选) :选项列表,一次可以选择任意数量。在 Multiple Choice Options 字段中输入选项(每行一个)。
- 整数 :整数。您可以为此回答设置最小和最大长度(字符数)。
- 浮点 数:十进制数。您可以为此回答设置最小和最大长度(字符数)。
- 必需 :用户是否需要回答这个问题。
- 最小长度 和 最大长度 :指定是否需要回答中的某个长度。
- 默认回答 :问题的默认回答。这个值在界面中预先填充,并在用户未提供回答时使用。
输入问题信息后,点
添加问题。调查问题显示在 Survey 列表中。对于任何问题,您可以点 来编辑它。
选中每个问题旁边的框,然后单击
以删除问题,或者使用菜单栏中的切换选项启用或禁用调查提示。如果您有多个调查问题,点
来通过单击并拖动网格图标来重新安排问题的顺序。- 要添加更多问题,请点 。
6.7.2. 可选的问卷调查问题
问卷调查问题中的 Required 设置决定了对于与之交互的用户是否是可选的。
可选的问卷调查变量也可以传递给 extra_vars
中的 playbook。
-
如果非文本变量(输入类型)标记为可选,且没有填写,则不会将任何问卷调查
extra_var
传递给 playbook。 -
如果文本输入或文本区域输入标记为可选,未填写,且
最小长度 > 0,
则不会将问卷调查extra_var
传递给 playbook。 -
如果文本输入或文本区域输入标记为可选,未填写,并且具有
最小长度 === 0,
则调查extra_var
将传递给 playbook,并将值设为空字符串("")。