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

字符串

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

选项

  • "已启用"

  • "已禁用"

cip

字符串

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

选项

  • "已启用"

  • "已禁用"

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

字符串

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

选项

  • "已启用"

  • "已禁用"

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虚拟服务器时，系统会为每个绑定的服务-域对内部生成一个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)