community.network.netscaler_server 模块 – 管理服务器配置

注意

此模块是 community.network 集合（版本 5.1.0）的一部分。

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

要安装它，请使用：ansible-galaxy collection install community.network。您需要进一步的要求才能使用此模块，请参阅 要求 以获取详细信息。

要在 playbook 中使用它，请指定：community.network.netscaler_server。

注意

community.network 集合已弃用，将从 Ansible 12 中删除。有关更多信息，请参阅讨论主题。

已弃用

在以下版本中移除:

版本 6.0.0

原因:

此集合及其中的所有内容均未维护且已弃用。

替代方案:

未知。

概要

  • 管理服务器实体配置。

  • 此模块旨在在 Ansible 控制节点或可以访问实际 NetScaler 实例的堡垒机（跳转服务器）上运行。

别名：network.netscaler.netscaler_server

要求

执行此模块的主机需要满足以下要求。

  • nitro python sdk

参数

参数

注释

comment

字符串

有关服务器的任何信息。

delay

字符串

禁用服务器上配置的所有服务后等待的时间，以秒为单位。

仅当将 *disabled* 选项设置为 true 时，此选项才有意义

disabled

布尔值

设置为 true 时，服务器状态将设置为 disabled。

设置为 false 时，服务器状态将设置为 enabled。

请注意，由于底层 NITRO API 的限制，仅 disabled 状态更改不会导致模块结果报告已更改的状态。

选项

  • false ← (默认)

  • true

domain

字符串

服务器的域名。对于基于域的配置，您必须先创建服务器。

最小长度 = 1

domainresolveretry

字符串

NetScaler 设备在 DNS 解析失败后，必须等待多少秒才能发送下一个 DNS 查询以解析域名。

最小值 = 5

最大值 = 20939

默认值: 5

graceful

布尔值

平稳关闭，不接受任何新连接，并在所有连接关闭时禁用每个服务。

仅当将 *disabled* 选项设置为 true 时，此选项才有意义

选项

  • false

  • true

ipaddress

字符串

服务器的 IPv4 或 IPv6 地址。如果创建基于 IP 地址的服务器，则在创建服务时，可以指定服务器的名称，而不是其 IP 地址。注意：如果您未创建服务器条目，则在创建服务时输入的服务器 IP 地址将成为服务器的名称。

ipv6address

布尔值

支持 IPv6 寻址模式。如果配置具有 IPv6 寻址模式的服务器，则不能在 IPv4 寻址模式中使用该服务器。

选项

  • false ← (默认)

  • true

name

字符串

服务器的名称。

必须以 ASCII 字母或下划线 _ 字符开头，并且必须仅包含 ASCII 字母数字、下划线 _、井号 #、句点 .、空格 、冒号 :、at 符号 @、等号 = 和连字符 - 字符。

可以在创建名称后更改。

最小长度 = 1

nitro_pass

字符串 / 必需

用于对 NetScaler 节点进行身份验证的密码。

nitro_protocol

字符串

访问 NITRO API 对象时使用的协议。

选项

  • "http" ← (默认)

  • "https"

nitro_timeout

浮点数

与 NetScaler 建立新会话时，抛出超时错误之前等待的时间（以秒为单位）

默认值: 310.0

nitro_user

字符串 / 必需

用于对 NetScaler 节点进行身份验证的用户名。

nsip

字符串 / 必需

将进行 NITRO API 调用的 NetScaler 设备的 IP 地址。

可以使用冒号 (:) 指定端口。例如：192.168.1.1:555。

save_config

布尔值

如果为 yes，则模块在进行任何更改时都会将配置保存在 NetScaler 节点上。

如果模块未做任何更改，则不会将配置保存在 NetScaler 节点上。

选项

  • false

  • true ← (默认)

state

字符串

模块在 NetScaler 节点上配置的资源的状态。

如果存在，将根据模块的参数创建并配置资源。

如果不存在，将从 NetScaler 节点删除该资源。

选项

  • "absent"

  • "present" ← (默认)

td

字符串

一个整数值，唯一标识要配置实体的流量域。如果不指定 ID，则该实体将成为默认流量域的一部分，其 ID 为 0。

最小值 = 0

最大值 = 4094

translationip

字符串

用于转换服务器 DNS 解析的 IP 地址的 IP 地址。

translationmask

字符串

转换 IP 的子网掩码。

validate_certs

布尔值

如果为 no，则不会验证 SSL 证书。这应该只在个人控制的使用自签名证书的站点上使用。

选项

  • false

  • true ← (默认)

说明

注意

示例

- name: Setup server
  delegate_to: localhost
  community.network.netscaler_server:
      nsip: 172.18.0.2
      nitro_user: nsroot
      nitro_pass: nsroot

      state: present

      name: server-1
      ipaddress: 192.168.1.1

返回值

通用返回值已记录在此处，以下是此模块特有的字段

键

描述

diff

字典

实际配置的对象与模块中指定的配置之间的差异列表

已返回: 失败

示例: {"targetlbvserver": "difference. ours: (str) server1 other: (str) server2"}

loglines

列表 / 元素=字符串

模块记录的消息列表

已返回: 总是

示例: ["message 1", "message 2"]

msg

字符串

详细说明失败原因的消息

已返回: 失败

示例: "Action does not exist"

状态

  • 此模块将在 6.0.0 版本中删除。[已弃用]

  • 有关更多信息，请参阅已弃用。

作者

  • George Nikolopoulos (@giorgos-nikolopoulos)