community.network.netscaler_gslb_vserver 模块 – 在 Netscaler 中配置 GSLB 虚拟服务器实体。

注意

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

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

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

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

注意

community.network 集合已被弃用，并将从 Ansible 12 中移除。请参阅 讨论主题 获取更多信息。

已弃用

在以下版本中移除：

6.0.0 版本

原因：

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

替代方案：

未知。

概要

  • 在 Netscaler 中配置 GSLB 虚拟服务器实体。

别名：network.netscaler.netscaler_gslb_vserver

要求

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

  • nitro python sdk

参数

参数

注释

appflowlog

字符串

启用日志记录应用程序流信息。

选项

  • "已启用"

  • "已禁用"

backuplbmethod

字符串

备份负载均衡方法。如果主要负载均衡方法失败或无法使用，则变为可操作。仅当主要方法基于往返时间 (RTT) 或静态邻近性时才有效。

选项

  • "ROUNDROBIN"

  • "LEASTCONNECTION"

  • "LEASTRESPONSETIME"

  • "SOURCEIPHASH"

  • "LEASTBANDWIDTH"

  • "LEASTPACKETS"

  • "STATICPROXIMITY"

  • "RTT"

  • "CUSTOMLOAD"

comment

字符串

您可能想要与 GSLB 虚拟服务器关联的任何注释。

considereffectivestate

字符串

如果所有绑定 GSLB 服务的主要状态为 DOWN，则在确定 GSLB 虚拟服务器的状态时，请考虑通过度量交换协议 (MEP) 获得的所有 GSLB 服务的有效状态。要考虑有效状态，请将参数设置为 STATE_ONLY。要忽略有效状态，请将其设置为 NONE。

GSLB 服务的有效状态是相应虚拟服务器服务流量的能力。即使备份虚拟服务器链中只有一个虚拟服务器处于 UP 状态，负载均衡虚拟服务器（传输到 GSLB 服务）的有效状态也是 UP。

选项

  • "NONE"

  • "STATE_ONLY"

disabled

布尔值

设置为 yes 时，GSLB 虚拟服务器状态将设置为 disabled。

设置为 no 时，GSLB 虚拟服务器状态将设置为 enabled。

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

选项

  • false ← (默认)

  • true

disableprimaryondown

字符串

即使主要 GSLB 虚拟服务器返回到 UP 状态后，也要继续将流量定向到备份链。在为虚拟服务器配置溢出时使用。

选项

  • "已启用"

  • "已禁用"

dnsrecordtype

字符串

与 GSLB 虚拟服务器的域名关联的 DNS 记录类型。

默认值：A

可能的值 = A、AAAA、CNAME、NAPTR

选项

  • "A"

  • "AAAA"

  • "CNAME"

  • "NAPTR"

domain_bindings

字符串

此 glsb 虚拟服务器的域绑定的列表。

cookietimeout

字符串

GSLB 站点 Cookie 的超时时间（以分钟为单位）。

domainname

字符串

要更改生存时间 (TTL) 和/或备份服务 IP 地址的域名。

sitedomainttl

字符串

与该虚拟服务器关联的所有内部创建的站点域（在 GSLB 服务上配置站点前缀时创建）的 TTL（以秒为单位）。

最小值 = 1

ttl

字符串

域的生存时间 (TTL)。

dynamicweight

字符串

指定设备在使用基于权重的负载均衡方法时是否应考虑服务计数、服务权重或忽略两者。绑定到虚拟服务器的服务数量的状态有助于设备选择服务。

选项

  • "SERVICECOUNT"

  • "SERVICEWEIGHT"

  • "DISABLED"

lbmethod

字符串

GSLB 虚拟服务器的负载均衡方法。

默认值：LEASTCONNECTION

可能的值 = ROUNDROBIN、LEASTCONNECTION、LEASTRESPONSETIME、SOURCEIPHASH、LEASTBANDWIDTH、LEASTPACKETS、STATICPROXIMITY、RTT、CUSTOMLOAD

选项

  • "ROUNDROBIN"

  • "LEASTCONNECTION"

  • "LEASTRESPONSETIME"

  • "SOURCEIPHASH"

  • "LEASTBANDWIDTH"

  • "LEASTPACKETS"

  • "STATICPROXIMITY"

  • "RTT"

  • "CUSTOMLOAD"

mir

字符串

在发送给客户端的 DNS 响应中包含多个 IP 地址。

选项

  • "已启用"

  • "已禁用"

name

字符串

GSLB 虚拟服务器的名称。必须以 ASCII 字母数字或下划线 _ 字符开头，并且只能包含 ASCII 字母数字、下划线 _、井号 #、句点 .、空格、冒号 :、at @、等于号 = 和连字符 - 字符。创建虚拟服务器后可以更改。

最小长度 = 1

netmask

字符串

在 SOURCEIPHASH 负载均衡方法中使用的 IPv4 网络掩码。

最小长度 = 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。

persistenceid

字符串

GSLB虚拟服务器的持久性ID。此ID是一个正整数，使GSLB站点能够识别GSLB虚拟服务器，如果在虚拟服务器上启用了基于源IP地址或溢出基于的持久性，则需要此ID。

最小值 = 0

最大值 = 65535

persistencetype

字符串

对虚拟服务器使用基于源IP地址的持久性。

负载均衡方法为第一个数据包选择服务后，响应DNS查询收到的IP地址将用于来自同一客户端的后续请求。

选项

  • "SOURCEIP"

  • "NONE"

persistmask

字符串

应用于IPv4地址的可选IPv4网络掩码，用于建立基于源IP地址的持久性。

最小长度 = 1

save_config

布尔值

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

如果模块没有进行任何更改，则不会保存NetScaler节点上的配置。

选项

  • false

  • true ← (默认)

service_bindings

字符串

绑定到此GSLB虚拟服务器的GSLB服务的绑定列表。

servicename

字符串

要更改其权重的GSLB服务的名称。

weight

字符串

要分配给GSLB服务的权重。

servicetype

字符串

绑定到虚拟服务器的服务使用的协议。

选项

  • "HTTP"

  • "FTP"

  • "TCP"

  • "UDP"

  • "SSL"

  • "SSL_BRIDGE"

  • "SSL_TCP"

  • "NNTP"

  • "ANY"

  • "SIP_UDP"

  • "SIP_TCP"

  • "SIP_SSL"

  • "RADIUS"

  • "RDP"

  • "RTSP"

  • "MYSQL"

  • "MSSQL"

  • "ORACLE"

sobackupaction

字符串

如果溢出生效，但没有可用的或存在的溢出备份链，则要执行的操作。

选项

  • "DROP"

  • "ACCEPT"

  • "REDIRECT"

somethod

字符串

超过时触发溢出的阈值类型。可用设置的功能如下：

* CONNECTION - 当客户端连接数超过阈值时，发生溢出。

* DYNAMICCONNECTION - 当GSLB虚拟服务器上的客户端连接数超过绑定GSLB服务的最大客户端（最大客户端）设置之和时，发生溢出。不要为此设置指定溢出阈值，因为阈值由绑定GSLB服务的“最大客户端”设置隐含。

* BANDWIDTH - 当GSLB虚拟服务器的传入和传出流量消耗的带宽超过阈值时，发生溢出。

* HEALTH - 当处于“UP”状态的GSLB服务权重百分比低于阈值时，发生溢出。例如，如果服务gslbSvc1、gslbSvc2和gslbSvc3绑定到虚拟服务器，权重分别为1、2和3，溢出阈值为50%，则如果gslbSvc1和gslbSvc3或gslbSvc2和gslbSvc3转换为“DOWN”状态，则会发生溢出。

* NONE - 不会发生溢出。

选项

  • "CONNECTION"

  • "DYNAMICCONNECTION"

  • "BANDWIDTH"

  • "HEALTH"

  • "NONE"

sopersistence

字符串

如果发生溢出，则为主要和备份GSLB虚拟服务器都保持基于源IP地址的持久性。

选项

  • "已启用"

  • "已禁用"

sopersistencetimeout

字符串

溢出持久性的超时时间（分钟）。

默认值：2

最小值 = 2

最大值 = 1440

sothreshold

字符串

发生溢出的阈值。为CONNECTION溢出方法指定整数，为BANDWIDTH方法指定千比特每秒的带宽值（不输入单位），或为HEALTH方法指定百分比（不输入百分号）。

最小值 = 1

最大值 = 4294967287

state

字符串

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

如果存在，则根据模块的参数创建所需的资源并进行配置。

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

选项

  • "absent"

  • "present" ← (默认)

timeout

字符串

空闲时间（分钟），超过此时间后将清除持久性条目。

默认值：2

最小值 = 2

最大值 = 1440

tolerance

字符串

实施RTT负载均衡方法的站点选择容差（毫秒）。如果站点的RTT与最低RTT的偏差超过指定的容差，则NetScaler设备进行GSLB决策时，不会考虑该站点。该设备将在RTT值在指定容差范围内的站点之间实施全局服务器负载均衡的轮询方法。如果容差为0（零），则设备始终向客户端发送具有最低RTT的站点的IP地址。

最小值 = 0

最大值 = 100

v6netmasklen

字符串

在IPv6源IP地址中要考虑的位数，用于创建SOURCEIPHASH负载均衡方法所需的哈希值。

默认值：128

最小值 = 1

最大值 = 128

v6persistmasklen

字符串

创建基于源IP地址的持久性会话时，在IPv6源IP地址中要考虑的位数。

默认值：128

最小值 = 1

最大值 = 128

validate_certs

布尔值

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

选项

  • false

  • true ← (默认)

注释

注意

示例

# FIXME: Add examples

状态

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

  • 更多信息请参见 已弃用。

作者

  • George Nikolopoulos (@giorgos-nikolopoulos)