9.2. 有关自动化内容导航器的常见问题
使用以下自动化内容导航器常见问题解答,以帮助您对环境中的问题进行故障排除。
- 在使用自动化执行环境时,
ansible.cfg
文件应位于什么位置? -
最简单的方法是将
ansible.cfg
文件放置在直接位于 playbook 旁边的项目目录中。playbook 目录自动挂载到自动化执行环境中,自动化内容导航器会在其中找到ansible.cfg
文件。如果ansible.cfg
文件位于其他目录中,设置ANSIBLE_CONFIG
变量,并将该目录指定为一个自定义卷挂载。(请参阅execution-environment-volume-mounts
的自动化内容导航器设置。) - 在没有使用自动化执行环境时,
ansible.cfg
文件应位于什么位置? -
在没有使用自动化执行环境时,Ansible 会在典型位置查找
ansible.cfg
。详情请参阅 Ansible 配置设置。 - 在使用自动化执行环境时,Ansible 集合应放置在哪里?
-
使用 Ansible 集合的最简单位置是位于项目目录中,位于 playbook 相邻集合目录中(例如
ansible-galaxy collections install ansible.utils -p ./collections
)。playbook 目录自动挂载到自动化执行环境中,自动化内容导航器会在其中找到集合。另一种选择是使用 Ansible Builder 将集合构建到自动化执行环境中。这有助于内容创建者编写准备好生产的 playbook,因为自动化控制器支持 playbook 相邻集合目录。如果集合位于另一个目录中,请设置ANSIBLE_COLLECTIONS_PATHS
变量,并为该目录配置自定义卷挂载。(请参阅execution-environment-volume-mounts
的自动化内容导航器常规设置。 - 如果不使用自动化执行环境,应放置 Ansible 集合的位置?
- 如果不使用自动化执行环境,Ansible 会查看集合的默认位置。请参阅使用 Ansible 集合指南。
- 在使用
vars_prompt
或pause/prompt
时,为什么 playbook 会出现挂起的情况? -
默认情况下,自动化内容导航器以与自动化控制器运行 playbook 相同的方式运行 playbook。这有助于内容创建者编写生产就绪的 playbook。如果无法使用
vars_prompt
或pause\prompt
,则禁用playbook-artifact
创建会导致自动化内容导航器以与ansible-playbook
兼容并允许用户交互的方式运行 playbook。 - 为什么自动化内容导航器会更改终端颜色或外观?
-
自动化内容导航器查询终端以获取 OSC4 兼容性。OSC4、10、11、104、110、111 表示终端支持颜色更改和恢复。这可能是终端错误地代表了其能力。您可以通过设置
--osc4 false
来禁用 OSC4 检测。(请参阅 自动化内容导航器常规设置,以了解如何使用环境变量或设置文件中处理此设置)。 - 如何更改自动化内容导航器使用的颜色?
-
use--
osc4 false
,以强制自动化内容导航器使用定义的终端颜色。(请参阅 自动化内容导航器常规设置,以了解如何使用环境变量或设置文件中处理此设置)。 - playbook 目录中所有这些
site-artifact-2021-06-02T16:02:33.911259+00:00.json
文件是什么? -
自动化内容导航器为每个 playbook 运行创建一个 playbook 工件。这有助于在自动化完成后,审查自动化的结果,与同事共享并进行故障排除,或保持合规或满足更改控制的目的。playbook 工件文件包含有关每个 play 和任务的详细信息,以及 playbook 运行的
stdout
。您可以在自动化内容导航器会话中查看ansible-navigator replay <filename>
或:replay <filename
> 的 playbook 工件。您可以根据所需的视图,使用模式stdout
和--mode 互动
查看所有 playbook 工件。您可以禁用 playbook 工件编写和默认的文件命名约定。(请参阅 自动化内容导航器常规设置,以了解如何使用环境变量或设置文件中处理此设置)。 - 当使用
:open
时,为什么会打开vi
? 自动化内容浏览器会在默认编辑器的终端中打开任何显示内容。默认值为
vi +{line_number} {filename}
或EDITOR
环境变量的当前值。与此相关的是editor-console
设置,它指示编辑器基于控制台还是终端。以下是可能有用的备用设置示例:# emacs ansible-navigator: editor: command: emacs -nw +{line_number} {filename} console: true
# vscode ansible-navigator: editor: command: code -g {filename}:{line_number} console: false
#pycharm ansible-navigator: editor: command: charm --line {line_number} {filename} console: false
- 配置设置应用的顺序是什么?
自动化内容导航器配置系统从各种来源拉取设置,并根据以下顺序应用它们(其中,上次应用的更改是最流行的):
- 默认内部值
- 来自设置文件中的值
- 来自环境变量中的值
- 命令行中指定的标志和参数
-
在基于文本的用户界面中输入
:
命令
- 我如何进行故障排除?
-
自动化内容导航器具有相关的日志记录消息。您可以使用
--log-level debug
来启用debug
级别的日志。如果您认为可能发现了一个程序漏洞,请报告相关问题,并包含日志文件中的详细信息。