9.2. 自动化内容导航器常见问题

使用以下自动化内容导航器常见问题解答，以帮助您对环境中的问题进行故障排除。

在使用自动化执行环境时，ansible.cfg 文件应位于什么位置？
ansible.cfg 最简单的位置是位于 playbook 旁边的项目目录中。playbook 目录自动挂载到执行环境中，可以找到 ansible.cfg 文件。如果 ansible.cfg 文件位于另一个目录中，则需要设置 ANSIBLE_CONFIG 变量，并且设置为自定义卷挂载的目录。(请参阅 第 8.2 节 “自动化内容导航器常规设置” for execution-environment-volume-mounts)。
在没有使用自动化执行环境时，ansible.cfg 文件应位于什么位置？
在没有使用自动化执行环境时，Ansible 会在典型位置查找 ansible.cfg。详情请参阅 Ansible 配置设置。
在使用自动化执行环境时，Ansible 集合应放置在哪里？
使用 Ansible 集合的最简单位置是位于项目目录中，位于 playbook 相邻集合目录中（例如 ansible-galaxy collections install ansible.utils -p ./collections）。playbook 目录自动挂载到自动化执行环境中，Automation content navigator 会在此处找到集合。另一种选择是使用 Ansible Builder 将集合构建到自动化执行环境中。（如需使用 Ansible Builder 的更多信息，请参阅 Ansible Builder 指南）。这有助于内容创建者编写准备好生产的 playbook，因为自动化控制器支持 playbook 相邻集合目录。如果集合位于另一个目录中，请设置 ANSIBLE_COLLECTIONS_PATHS 变量，并为该目录配置自定义卷挂载。(请参阅 第 8.2 节 “自动化内容导航器常规设置” for execution-environment-volume-mounts)。
如果不使用自动化执行环境，应放置 ansible 集合的位置？
如果不使用自动化执行环境，Ansible 会查看集合的默认位置。请参阅 Ansible Collections 用户指南。
在使用 vars_prompt 或 pause/prompt 时，为什么 playbook 会出现挂起的情况？
默认情况下，Automation content navigator 以与自动化控制器运行 playbook 相同的方式运行 playbook。这样可以帮助内容创建者 playbook 为生产环境就绪。如果无法避免使用 vars_prompt 或 pause\prompt，则禁用 playbook-artifact 创建会导致自动化内容导航器以与 ansible-playbook 兼容并允许用户交互的方式运行 playbook。
为什么自动化内容导航器会更改终端颜色或外观？
自动化内容导航器查询终端以获取 OSC4 兼容性。OSC4、10、11、104、110、111 表示终端支持颜色更改和恢复。这可能是终端错误地代表了其能力。OSC4 检测可以通过设置 --osc4 false 来禁用。（请参阅 第 8.2 节 “自动化内容导航器常规设置” 了解如何使用环境变量或设置文件中处理它）。
如何更改自动化内容导航器使用的颜色？
使用 --osc4 false 来强制自动化内容导航器使用定义的终端颜色。（请参阅 第 8.2 节 “自动化内容导航器常规设置” 了解如何使用环境变量或设置文件中处理它）。
playbook 目录中所有这些 site-artifact-2021-06-02T16:02:33.911259+00:00.json 文件是什么？
自动化内容导航器为每个 playbook 运行创建一个 playbook 工件。这有助于在自动化完成后，审查自动化的结果，与同事共享并进行故障排除，或保持合规或满足更改控制的目的。Playbook 工件文件包含有关每个 play 和任务的详细信息，以及 playbook 运行中的 stdout。您可以在一个 Automation 内容浏览器的会话中，使用 ansible-navigator replay <filename> 或 :replay <filename> 查看 playbook 工件。所有 playbook 工件可以通过 --mode stdout 和 --mode 互动来查看，具体取决于所需的视图。您可以禁用 playbook 工件编写和默认的文件命名约定。（请参阅 第 8.2 节 “自动化内容导航器常规设置” 了解如何使用环境变量或设置文件中处理它）。
当使用 :open 时，为什么会打开 vi？

自动化内容浏览器会在默认编辑器的终端中打开任何显示内容。默认值为 vi +{line_number} {filename} 或 EDITOR 环境变量的当前值。与此相关的是 editor-console 设置，它指示编辑器是否基于 console/terminal。以下是可能有用的备用设置示例： 

# 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
配置设置应用的顺序是什么？

自动化内容导航器配置系统从各种来源拉取设置，并按以下顺序应用它们（其中，最新一次应用的更改优先级最高）：

  1. 默认内部值
  2. 来自设置文件中的值
  3. 来自环境变量中的值
  4. 命令行中指定的标志和参数
  5. 在基于文本的用户界面中输入 : 命令
我如何进行故障排除？
自动化内容导航器具有相关的日志记录消息。您可以使用 --log-level debug 来启用 debug 级别的日志。如果您认为可能发现了一个程序漏洞，请报告相关问题，并包含日志文件中的详细信息。