community.network.netscaler_gslb_site 模块 – 在 Netscaler 中管理 gslb 站点实体。

注意

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

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

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

要在剧本中使用它，请指定： community.network.netscaler_gslb_site。

注意

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

已弃用

在以下版本中移除：

版本 6.0.0

原因：

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

替代方案：

未知。

概要

  • 在 Netscaler 中管理 gslb 站点实体。

别名：network.netscaler.netscaler_gslb_site

要求

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

  • nitro python sdk

参数

参数

注释

clip

字符串

集群 IP 地址。指定此参数以连接到用于 GSLB 自动同步的远程集群站点。注意：集群 IP 地址在创建集群时定义。

metricexchange

字符串

与其他站点交换指标。指标通过使用指标交换协议 (MEP) 进行交换。GSLB 设置中的设备每秒交换一次健康信息。

如果您禁用指标交换，则只能使用静态负载平衡方法（例如轮询、静态邻近性或基于哈希的方法），并且如果您在动态负载平衡方法（例如最少连接）运行时禁用指标交换，则设备将回退到轮询。此外，如果您禁用指标交换，则必须使用监视器来确定 GSLB 服务的状态。否则，服务将标记为 DOWN。

选项

  • "enabled"

  • "disabled"

naptrreplacementsuffix

字符串

此处配置的 naptr 替换后缀将用于构造 NAPTR 记录中的 naptr 替换字段。

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

nwmetricexchange

字符串

与其他 GSLB 站点交换网络指标，例如往返时间 (RTT)，这些指标是从与客户端使用的各种本地 DNS (LDNS) 服务器的通信中学习到的。RTT 信息用于动态 RTT 负载平衡方法，并且每 5 秒交换一次。

选项

  • "enabled"

  • "disabled"

parentsite

字符串

在父子拓扑中，GSLB 站点的父站点。

publicclip

字符串

在部署到 NAT 后端时用于全局访问远程集群的 IP 地址。它可以与正常的集群 IP 地址相同。

publicip

字符串

本地站点的公共 IP 地址。仅当设备部署在私有地址空间并且站点在外部防火墙或 NAT 设备上托管公共 IP 地址时才需要。

最小长度 = 1

save_config

布尔值

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

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

选项

  • false

  • true ← (默认)

sessionexchange

字符串

每五秒钟与其他 GSLB 站点交换持久会话条目。

选项

  • "enabled"

  • "disabled"

siteipaddress

字符串

GSLB 站点的 IP 地址。GSLB 站点使用此 IP 地址与其他 GSLB 站点通信。对于本地站点，请使用设备拥有的任何 IP 地址（例如 SNIP 或 MIP 地址，或 ADNS 服务的 IP 地址）。

最小长度 = 1

sitename

字符串

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

最小长度 = 1

sitetype

字符串

要创建的站点类型。如果未指定类型，设备会根据分配给站点的IP地址自动检测和设置类型。如果指定的站点IP地址属于设备（例如，MIP地址或SNIP地址），则该站点为本地站点。否则，它是一个远程站点。

选项

  • “远程”

  • “本地”

状态

字符串

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

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

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

选项

  • “不存在”

  • "present" ← (默认)

triggermonitor

字符串

指定在绑定监控程序的情况下，GSLB服务必须由监控程序监控的条件。可用设置的功能如下

* ALWAYS - 始终监控GSLB服务。

* MEPDOWN - 仅当通过度量交换协议 (MEP) 交换度量标准被禁用时，才监控 GSLB 服务。

MEPDOWN_SVCDOWN - 在以下任一情况下监控服务

* 通过 MEP 交换度量标准被禁用。

* 通过 MEP 交换度量标准已启用，但通过度量标准交换了解到的服务状态为 DOWN。

选项

  • “ALWAYS”

  • “MEPDOWN”

  • “MEPDOWN_SVCDOWN”

validate_certs

布尔值

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

选项

  • false

  • true ← (默认)

备注

注意

示例

- name: Setup gslb site
  delegate_to: localhost
  community.network.netscaler_gslb_site:
    nsip: 172.18.0.2
    nitro_user: nsroot
    nitro_pass: nsroot

    sitename: gslb-site-1
    siteipaddress: 192.168.1.1
    sitetype: LOCAL
    publicip: 192.168.1.1
    metricexchange: enabled
    nwmetricexchange: enabled
    sessionexchange: enabled
    triggermonitor: ALWAYS

返回值

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

键

描述

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)