community.network.netscaler_gslb_service 模块 – 在 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_service。

注意

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

已弃用

在以下版本中移除：

版本 6.0.0

原因：

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

替代方案：

未知。

概要

  • 在 Netscaler 中管理 gslb 服务实体。

别名：network.netscaler.netscaler_gslb_service

要求

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

  • nitro python sdk

参数

参数

注释

appflowlog

字符串

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

选项

  • "enabled"

  • "disabled"

cip

字符串

在转发到 GSLB 服务的请求中，插入存储客户端 IP 地址的标头。客户端 IP 标头插入用于基于连接代理的站点持久性。

选项

  • "enabled"

  • "disabled"

cipheader

字符串

存储客户端 IP 地址的 HTTP 标头的名称。与客户端 IP 选项一起使用。如果在服务上启用了客户端 IP 标头插入并且未为标头指定名称，则 NetScaler 设备将使用 set ns param 命令中的 cipHeader 参数指定的名称，或者在 GUI 中，使用“配置 HTTP 参数”对话框中的“客户端 IP 标头”参数。

最小长度 = 1

clttimeout

字符串

空闲时间（以秒为单位），在此时间之后客户端连接将终止。如果使用基于连接代理的站点持久性，则适用。

最小值 = 0

最大值 = 31536000

cnameentry

字符串

GSLB 服务的规范名称。用于基于 CNAME 的 GSLB。

最小长度 = 1

comment

字符串

您可能希望与 GSLB 服务关联的任何注释。

downstateflush

字符串

当其状态从 UP 变为 DOWN 时，刷新与 GSLB 服务关联的所有活动事务。不要为必须完成其事务的服务启用此选项。如果使用基于连接代理的站点持久性，则适用。

选项

  • "enabled"

  • "disabled"

hashid

字符串

GSLB 服务的唯一哈希标识符，由基于哈希的负载均衡方法使用。

最小值 = 1

healthmonitor

布尔值

监控 GSLB 服务的运行状况。

选项

  • false

  • true

ipaddress

字符串

GSLB 服务的 IP 地址。应代表 NetScaler 设备上的负载均衡、内容切换或 VPN 虚拟服务器，或另一个负载均衡设备的 IP 地址。

maxaaausers

字符串

可以同时登录到此 GSLB 服务所代表的 VPN 虚拟服务器的最大 SSL VPN 用户数。当 GSLB 服务的用户数量达到最大值时，在数量下降到最大值以下之前，不会在进行 GSLB 决策时考虑该服务。

最小值 = 0

最大值 = 65535

maxbandwidth

字符串

指定服务允许的最大带宽的整数。当 GSLB 服务的带宽达到最大值时，在带宽消耗下降到最大值以下之前，不会在进行 GSLB 决策时考虑该服务。

maxclient

字符串

服务在任何给定时间能够支持的最大打开连接数。当GSLB服务的连接计数达到最大值时，在连接计数下降到最大值以下之前，不会考虑该服务进行GSLB决策。

最小值 = 0

最大值 = 4294967294

monitor_bindings

字符串

将监控器绑定到此gslb服务

monitor_name

字符串

监控器名称。

weight

字符串

分配给监控器-服务绑定的权重。

较大的数字指定更大的权重。

影响监控阈值，该阈值决定服务的运行状态。

最小值 = 1

最大值 = 100

monthreshold

字符串

GSLB服务的监控阈值。如果绑定到此GSLB服务且处于UP状态的监控器的权重之和不等于或大于此阈值，则该服务将标记为DOWN。

最小值 = 0

最大值 = 65535

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。

port

字符串

此GSLB服务代表的负载均衡实体侦听的端口。

最小值 = 1

范围 1 - 65535

* 在CLI中表示为NITRO API中的65535

publicip

字符串

NAT设备将GSLB服务的私有IP地址转换为的公共IP地址。可选。

publicport

字符串

与GSLB服务的公共IP地址关联的公共端口。该端口映射到服务的私有端口号。适用于本地GSLB服务。可选。

save_config

布尔值

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

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

选项

  • false

  • true ← (默认)

servername

字符串

托管GSLB服务的服务器名称。

最小长度 = 1

servicename

字符串

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

最小长度 = 1

servicetype

字符串

要创建的服务类型。

选项

  • "HTTP"

  • "FTP"

  • "TCP"

  • "UDP"

  • "SSL"

  • "SSL_BRIDGE"

  • "SSL_TCP"

  • "NNTP"

  • "ANY"

  • "SIP_UDP"

  • "SIP_TCP"

  • "SIP_SSL"

  • "RADIUS"

  • "RDP"

  • "RTSP"

  • "MYSQL"

  • "MSSQL"

  • "ORACLE"

sitename

字符串

服务所属的GSLB站点名称。

最小长度 = 1

sitepersistence

字符串

使用基于cookie的站点持久性。仅适用于HTTP和SSL GSLB服务。

选项

  • "ConnectionProxy"

  • "HTTPRedirect"

  • "NONE"

siteprefix

字符串

站点的前缀字符串。将服务绑定到GSLB虚拟服务器时，NetScaler设备会为每个绑定的服务-域对内部生成一个GSLB站点域，方法是连接服务的站点前缀和域的名称。如果指定特殊字符串NONE，则站点前缀字符串将被取消设置。在实现HTTP重定向站点持久性时，NetScaler设备会使用其站点域重定向GSLB请求到GSLB服务。

state

字符串

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

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

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

选项

  • "absent"

  • "present" ← (默认)

validate_certs

布尔值

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

选项

  • false

  • true ← (默认)

注释

注意

示例

- name: Setup gslb service 2

  delegate_to: localhost
  register: result
  check_mode: "{{ check_mode }}"

  community.network.netscaler_gslb_service:
    operation: present

    servicename: gslb-service-2
    cnameentry: example.com
    sitename: gslb-site-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)