community.network.netscaler_gslb_vserver 模块 – 在 Netscaler 中配置 gslb vserver 实体。

注意

此模块是 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 vserver 实体。

别名：network.netscaler.netscaler_gslb_vserver

要求

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

  • nitro python sdk

参数

参数

注释

appflowlog

字符串

启用记录 appflow 流信息。

选择

  • "enabled"

  • "disabled"

backuplbmethod

字符串

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

选择

  • "ROUNDROBIN"

  • "LEASTCONNECTION"

  • "LEASTRESPONSETIME"

  • "SOURCEIPHASH"

  • "LEASTBANDWIDTH"

  • "LEASTPACKETS"

  • "STATICPROXIMITY"

  • "RTT"

  • "CUSTOMLOAD"

comment

字符串

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

considereffectivestate

字符串

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

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

选择

  • "NONE"

  • "STATE_ONLY"

disabled

布尔值

当设置为 yes 时，GSLB Vserver 状态将设置为 disabled。

当设置为 no 时，GSLB Vserver 状态将设置为 enabled。

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

选择

  • false ← (默认)

  • true

disableprimaryondown

字符串

即使主 GSLB 虚拟服务器恢复到 UP 状态后，仍继续将流量定向到备份链。当为虚拟服务器配置溢出时使用。

选择

  • "enabled"

  • "disabled"

dnsrecordtype

字符串

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

默认值：A

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

选择

  • "A"

  • "AAAA"

  • "CNAME"

  • "NAPTR"

domain_bindings

字符串

此 glsb vserver 的域绑定列表。

cookietimeout

字符串

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

domainname

字符串

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

sitedomainttl

字符串

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

最小值 = 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 地址。

选择

  • "enabled"

  • "disabled"

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 地址以建立基于源 IP 地址的持久性的可选 IPv4 网络掩码。

最小长度 = 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 服务的最大客户端 (Max Clients) 设置之和时，发生溢出。不要为此设置指定溢出阈值，因为阈值由绑定的 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 地址的持久性。

选择

  • "enabled"

  • "disabled"

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

字符串

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

默认值：128

最小值 = 1

最大值 = 128

v6persistmasklen

字符串

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

默认值：128

最小值 = 1

最大值 = 128

validate_certs

布尔值

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

选择

  • false

  • true ←（默认）

注释

注意

示例

# FIXME: Add examples

状态

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

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

作者

  • George Nikolopoulos (@giorgos-nikolopoulos)