dellemc.enterprise_sonic.sonic_command 模块 – 在运行 Enterprise SONiC 的设备上运行命令

注意

此模块是 dellemc.enterprise_sonic 集合（版本 2.5.1）的一部分。

如果您正在使用 ansible 包，您可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install dellemc.enterprise_sonic。

要在 Playbook 中使用它，请指定：dellemc.enterprise_sonic.sonic_command。

dellemc.enterprise_sonic 1.0.0 中的新增功能

概要 

在运行戴尔科技公司 Enterprise SONiC 发行版的远程设备上运行命令。将任意命令发送到 Enterprise SONiC 节点，并返回从设备读取的结果。此模块包含一个参数，该参数导致模块在返回之前等待特定条件，如果未满足条件则超时。
此模块不支持在配置模式下运行命令。要配置 SONiC 设备，请使用 dellemc.enterprise_sonic.sonic_config。

注意

此模块具有相应的操作插件。

参数 

参数	注释
commands 列表 / 元素=字符串 / 必需	通过配置的提供程序发送到远程 Enterprise SONiC 设备的命令列表。返回命令的输出结果。如果提供了 wait_for 参数，则模块不会返回，直到满足条件或重试次数已过期。如果发送到设备的命令需要回答提示，则可以传递包含 command、answer 和 prompt 的字典。常见的答案是“yes”或“\r”（回车符，必须使用双引号）。请参阅示例。
interval 整数	配置命令重试之间等待的间隔（以秒为单位）。如果命令未通过指定的条件，则间隔指示在再次尝试该命令之前等待多长时间。默认值： `1`
match 字符串	match 参数与 wait_for 参数结合使用，以指定匹配策略。有效值是 `all` 或 `any`。如果该值设置为 `all`，则必须满足 wait_for 中的所有条件。如果该值设置为 `any`，则只需满足其中一个值。选项 `"all"` ←（默认） `"any"`
retries 整数	指定在认为命令失败之前应运行的重试次数。每次重试时，该命令都会在目标设备上运行，并根据 wait_for 条件进行评估。默认值： `10`
wait_for 列表 / 元素=字符串	要针对命令输出评估的条件列表。该任务会等待每个条件都为真，然后再继续执行。如果在配置的重试次数内条件不为真，则该任务将失败。请参阅示例。

说明 

注意

已针对戴尔科技公司的 Enterprise SONiC 发行版进行测试。
支持 check_mode。

示例 

- name: Runs show version on remote devices
  dellemc.enterprise_sonic.sonic_command:
    commands: show version

- name: Runs show version and checks to see if output contains 'Dell'
  dellemc.enterprise_sonic.sonic_command:
    commands: show version
    wait_for: result[0] contains Dell

- name: Runs multiple commands on remote nodes
  dellemc.enterprise_sonic.sonic_command:
    commands:
      - show version
      - show interface

- name: Runs multiple commands and evaluate the output
  dellemc.enterprise_sonic.sonic_command:
    commands:
      - 'show version'
      - 'show system'
    wait_for:
      - result[0] contains Dell
      - result[1] contains Hostname

- name: Runs commands that require answering a prompt
  dellemc.enterprise_sonic.sonic_command:
    commands:
      - command: 'reload'
        prompt: '[confirm yes/no]: ?$'
        answer: 'no'

返回值 

常见返回值记录在此处，以下是此模块特有的字段

键	描述
failed_conditions 列表 / 元素=字符串	失败的条件列表。已返回：失败示例： `["...", "..."]`
stdout 列表 / 元素=字符串	来自命令的一组响应。已返回：始终，除了低级错误（例如操作插件）示例： `["...", "..."]`
stdout_lines 列表 / 元素=字符串	拆分为列表的 stdout 值。已返回：始终，除了低级错误（例如操作插件）示例： `[["...", "..."], ["..."], ["..."]]`
warnings 列表 / 元素=字符串	模块根据参数生成的警告列表（如果有）。已返回：始终示例： `["...", "..."]`

作者

Dhivya P (@dhivayp)