lowlydba.sqlserver.ag_listener 模块 – 配置可用性组侦听器

注意

此模块是 lowlydba.sqlserver 集合（版本 2.3.4）的一部分。

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

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

要在 playbook 中使用它，请指定：lowlydba.sqlserver.ag_listener。

lowlydba.sqlserver 0.5.0 中的新功能

概要

  • 为现有可用性组创建可用性组侦听器。

要求

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

参数

参数

注释

ag_name

字符串 / 必需

目标可用性组的名称。

dhcp

布尔值

指示侦听器是否使用 DHCP。

选择

  • false ← (默认)

  • true

ip_address

列表 / 元素=字符串

侦听器的 IP 地址。如果有多个，则用逗号分隔。

listener_name

字符串 / 必需

要配置的侦听器的名称。

port

整数

设置用于与可用性组通信的端口号。

默认值： 1433

sql_instance

字符串 / 必需

要修改的 SQL Server 实例。

sql_password

字符串

用于 SQL 身份验证的密码。

sql_username

字符串

用于 SQL 身份验证的用户名。

state

字符串

对象应该是 present 还是 absent。

选择

  • "present" ← (默认)

  • "absent"

subnet_ip

列表 / 元素=字符串

侦听器的子网 IP 地址。如果有多个，则用逗号分隔。

subnet_mask

列表 / 元素=字符串

设置可用性组侦听器的子网 IP 掩码。如果有多个，则用逗号分隔。

默认值： ["255.255.255.0"]

属性

属性

支持

描述

check_mode

支持： 完全

可以在 check_mode 中运行，并返回更改状态预测，而无需修改目标。

platform

平台： 全部

可以针对操作的目标操作系统/系列。

示例

- name: Create Availability Group
  lowlydba.sqlserver.availability_group:
    sql_instance: sql-01.myco.io
    ag_name: AG_MyDatabase

- name: Create AG Listener
  lowlydba.sqlserver.ag_listener:
    sql_instance_primary: sql-01.myco.io
    ag_name: AG_MyDatabase
    listener_name: aglMyDatabase
    ip_address:
      - 10.0.20.20
      - 10.1.77.77
    subnet_ip:
      - 255.255.252.0
    subnet_mask:
      - 255.255.255.0

返回值

常见返回值记录在这里，以下是此模块独有的字段

键

描述

数据

字典

来自 Add-DbaAgListener 或 Set-DbaAgListener 函数的输出。

返回： 成功，但不在 check_mode 中。

作者

  • John McCall (@lowlydba)