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

列表 / 元素=字符串

按 IP 地址列出的 DNS 名称服务器列表,用于执行名称解析查找。此参数接受 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)