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