8.2. 自动化内容导航器常规设置

下表描述了自动化内容导航器的每个常规参数和设置选项。

表 8.1. 自动化内容导航器常规参数设置

参数描述设置选项

ansible-runner-artifact-dir

存储由 ansible-runner 生成工件的目录路径。

默认：没有设置默认值

CLI: --rad 或 --ansible-runner-artifact-dir

ENV:ANSIBLE_NAVIGATOR_ANSIBLE_RUNNER_ARTIFACT_DIR

Settings file: 

ansible-navigator:
  ansible-runner:
    artifact-dir:

ansible-runner-rotate-artifacts-count

为最后 n 个运行保留 ansible-runner 构件目录。如果设置为 0，则工件目录不会被删除。

默认：没有设置默认值

CLI: --rac 或 --ansible-runner-rotate-artifacts-count

ENV:ANSIBLE_NAVIGATOR_ANSIBLE_RUNNER_ROTATE_ARTIFACTS_COUNT

Settings file: 

ansible-navigator:
  ansible-runner:
    rotate-artifacts-count:

ansible-runner-timeout

超时值，在超过这个值后 ansible-runner 强制停止执行。

默认：没有设置默认值

CLI: --rt 或 --ansible-runner-timeout

ENV:ANSIBLE_NAVIGATOR_ANSIBLE_RUNNER_TIMEOUT

Settings file: 

ansible-navigator:
  ansible-runner:
    timeout:

app

自动化内容导航器的入口点.

Choices: collections, config, doc, images, inventory, replay, run or welcome

Default: welcome

CLI example: ansible-navigator collections

ENV ：ANSIBLE_NAVIGATOR_APP

Settings file: 

ansible-navigator:
  app:

cmdline

传递给相应命令的额外参数。

默认 ：没有默认值

CLI ：位置

ENV ：ANSIBLE_NAVIGATOR_CMDLINE

Settings file: 

ansible-navigator:
  ansible:
    cmdline:

collection-doc-cache-path

集合 doc 缓存的路径。

Default: $HOME/.cache/ansible-navigator/collection_doc_cache.db

CLI: --cdcp 或 --collection-doc-cache-path

ENV ：ANSIBLE_NAVIGATOR_COLLECTION_DOC_CACHE_PATH

Settings file: 

ansible-navigator:
  collection-doc-cache-path:

container-engine

指定容器引擎（auto=podman then docker）。

Choices: auto, podman 或 docker

Default: auto

CLI: --ce 或 --container-engine

ENV:ANSIBLE_NAVIGATOR_CONTAINER_ENGINE

Settings file: 

ansible-navigator:
  execution-environment:
    container-engine:

display-color

在显示中使用颜色。

Choices:True 或 False

默认：True

CLI: --dc 或 --display-color

ENV:NO_COLOR

Settings file: 

ansible-navigator:
  color:
    enable:

editor-command

指定自动化内容导航器使用的编辑器

默认值：* vi +{line_number} {filename}

CLI: --ecmd 或 --editor-command

ENV:ANSIBLE_NAVIGATOR_EDITOR_COMMAND

Settings file: 

ansible-navigator:
  editor:
    command:

editor-console

指定编辑器是否基于控制台.

Choices:True 或 False

默认：True

CLI: --econ 或 --editor-console

ENV:ANSIBLE_NAVIGATOR_EDITOR_CONSOLE

Settings file: 

ansible-navigator:
  editor:
    console:

execute-environment

启用或禁用自动化执行环境的使用。

Choices:True 或 False

默认：True

CLI: --ee 或 --execution-environment

ENV:* ANSIBLE_NAVIGATOR_EXECUTION_ENVIRONMENT

Settings file: 

ansible-navigator:
  execution-environment:
    enabled:

execution-environment-image

指定自动化执行环境镜像的名称。

Default: quay.io/ansible/ansible-runner:devel

CLI: --eei 或 --execution-environment-image

ENV:ANSIBLE_NAVIGATOR_EXECUTION_ENVIRONMENT_IMAGE

Settings file: 

ansible-navigator:
  execution-environment:
    image:

execution-environment-volume-mounts

指定要在自动化执行环境中绑定的卷（--eev /home/user/test:/home/user/test:Z）

默认：没有设置默认值

CLI: --eev 或 --execution-environment-volume-mounts

ENV:ANSIBLE_NAVIGATOR_EXECUTION_ENVIRONMENT_VOLUME_MOUNTS

Settings file: 

ansible-navigator:
  execution-environment:
    volume-mounts:

log-append

指定是否应将日志消息附加到现有日志文件中，否则每个会话都会创建新的日志文件。

Choices:True 或 False

默认：True

CLI: --la 或 --log-append

ENV:ANSIBLE_NAVIGATOR_LOG_APPEND

Settings file: 

ansible-navigator:
  logging:
    append:

log-file

指定 Automation 内容导航器日志文件的完整路径。

Default: $PWD/ansible-navigator.log

CLI: --lf 或 --log-file

ENV:ANSIBLE_NAVIGATOR_LOG_FILE

Settings file: 

ansible-navigator:
  logging:
    file:

log-level

指定 Automation content navigator 日志级别。

Choices: debug, info, warning, error 或 critical

Default: warning

CLI: --ll 或 --log-level

ENV:ANSIBLE_NAVIGATOR_LOG_LEVEL

Settings file: 

ansible-navigator:
  logging:
    level:

模式

指定 user-interface 模式。

Choices: stdout 或 interactive

Default: interactive

CLI: -m 或 --mode

ENV:ANSIBLE_NAVIGATOR_MODE

Settings file: 

ansible-navigator:
  mode:

osc4

启用或禁用 OSC 4 支持的终端颜色。

Choices:True 或 False

默认：True

CLI: --osc4 或 --osc4

ENV:ANSIBLE_NAVIGATOR_OSC4

Settings file: 

ansible-navigator:
  color:
    osc4:

pass-environment-variable

指定要传递给的退出环境变量，并在自动化执行环境 (--penv MY_VAR) 内设置.

默认：没有设置默认值

CLI: --penv 或 --pass-environment-variable

ENV:ANSIBLE_NAVIGATOR_PASS_ENVIRONMENT_VARIABLES

Settings file: 

ansible-navigator:
  execution-environment:
    environment-variables:
      pass:

pull-policy

指定镜像拉取策略。

always - 总拉取 (pull) 镜像

missing - 在本地没有时拉取

never - 永不拉取 (pull) 镜像。

tag - 如果镜像标签为 latest 则总拉取镜像，否则在本地没有时进行拉取

Choices: always, missing, never, 或 tag

Default: tag

CLI: --pp 或 --pull-policy

ENV:ANSIBLE_NAVIGATOR_PULL_POLICY

Settings file: 

ansible-navigator:
  execution-environment:
    pull-policy:

set-environment-variable

指定要在自动化执行环境内设置的环境变量和值 (--senv MY_VAR=42)

默认：没有设置默认值

CLI: --senv 或 --set-environment-variable

ENV:ANSIBLE_NAVIGATOR_SET_ENVIRONMENT_VARIABLES

Settings file: 

ansible-navigator:
  execution-environment:
    environment-variables:
      set: