junipernetworks.junos.junos_system 模块 – 管理 Juniper JUNOS 设备上的系统属性

注意

此模块是 junipernetworks.junos 集合 (版本 9.1.0) 的一部分。

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

要安装它,请使用:ansible-galaxy collection install junipernetworks.junos。您需要其他要求才能使用此模块,有关详细信息,请参阅 要求

要在剧本中使用它,请指定:junipernetworks.junos.junos_system

junipernetworks.junos 1.0.0 中的新增功能

概要

  • 此模块提供对 Juniper JUNOS 设备上节点系统属性的声明式管理。它提供了一个选项来配置主机系统参数或从设备活动配置中删除这些参数。

要求

在执行此模块的主机上需要以下要求。

  • ncclient (>=v0.5.2)

参数

参数

注释

active

布尔值

指定配置是激活还是停用

选项

  • false

  • true ← (默认)

domain_name

字符串

将远程设备上的 IP 域名配置为提供的值。值应采用点分名称形式,并将附加到 hostname 以创建完全限定域名。

列表 / 元素=字符串

提供要附加到主机名以进行名称解析的域名后缀列表。此参数接受名称列表,并将与运行节点上的当前活动配置进行协调。

hostname

字符串

配置设备主机名参数。此选项采用 ASCII 字符串值。

name_servers

列表 / 元素=字符串

要用于执行名称解析查找的 DNS 服务器 IP 地址列表。此参数接受 DNS 服务器列表,请参见示例。

state

字符串

设备当前活动配置中配置值的狀態。设置为 *present* 时,这些值应在设备活动配置中配置;设置为 *absent* 时,这些值不应在设备活动配置中。

选项

  • "present" ← (默认)

  • "absent"

备注

注意

  • 此模块要求在被管理的远程设备上启用 netconf 系统服务。

  • 针对 vSRX JUNOS 版本 15.1X49-D15.4、vqfx-10000 JUNOS 版本 15.1X53-D60.4 进行了测试。

  • 推荐连接方式为 netconf。请参见 Junos OS 平台选项

  • 此模块也适用于传统剧本的 local 连接。

  • 有关使用 CLI 和 netconf 的信息,请参见:ref:`Junos OS 平台选项指南 <junos_platform_options>`

  • 有关使用 Ansible 管理网络设备的更多信息,请参见:ref:`Ansible 网络指南 <network_guide>`

  • 有关使用 Ansible 管理 Juniper 网络设备的更多信息,请参见 https://ansible.org.cn/ansible-juniper

示例

- name: configure hostname and domain name
  junipernetworks.junos.junos_system:
    hostname: junos01
    domain_name: test.example.com
    domain-search:
      - ansible.com
      - redhat.com
      - juniper.net

- name: remove configuration
  junipernetworks.junos.junos_system:
    state: absent

- name: configure name servers
  junipernetworks.junos.junos_system:
    name_servers:
      - 8.8.8.8
      - 8.8.4.4

返回值

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

描述

diff.prepared

字符串

应用更改前后配置差异。

返回:当配置更改且启用 diff 选项时。

示例:"[edit system] +  host-name test; +  domain-name ansible.com; +  domain-search redhat.com; [edit system name-server]\n    172.26.1.1 { ... }\n+   8.8.8.8;\n"

作者

  • Ganesh Nalawade (@ganeshrn)