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_promptpause/prompt 时,为什么 playbook 会出现挂起的情况?
默认情况下,Automation content navigator 以与自动化控制器运行 playbook 相同的方式运行 playbook。这样可以帮助内容创建者 playbook 为生产环境就绪。如果无法避免使用 vars_promptpause\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 级别的日志。如果您认为可能发现了一个程序漏洞,请报告相关问题,并包含日志文件中的详细信息。