community.network.a10_server 模块 – 管理 A10 Networks AX/SoftAX/Thunder/vThunder 设备的服务器对象。

注意

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

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

要安装它，请使用： ansible-galaxy collection install community.network。

要在 playbook 中使用它，请指定： community.network.a10_server。

注意

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

已弃用

在以下版本中移除：

6.0.0 版本

原因：

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

替代方案：

未知。

概要

  • 通过 aXAPIv2 管理 A10 Networks 设备上的 SLB（服务器负载均衡器）服务器对象。

别名：network.a10.a10_server

参数

参数

注释

client_cert

路径

用于 SSL 客户端身份验证的 PEM 格式证书链文件。

此文件还可以包含密钥，如果包含密钥，则不需要 client_key。

client_key

路径

包含用于 SSL 客户端身份验证的私钥的 PEM 格式文件。

如果 client_cert 包含证书和密钥，则不需要此选项。

force

布尔值

如果为 yes，则不获取缓存的副本。

选项

  • false ← (默认)

  • true

force_basic_auth

布尔值

使用 url_username 和 url_password 指定的凭据应通过 HTTP 标头传递。

选项

  • false ← (默认)

  • true

host

字符串 / 必需

A10 Networks 设备的主机名或 IP。

http_agent

字符串

用于标识的标头，通常出现在 Web 服务器日志中。

默认值： "ansible-httpget"

partition

字符串

设置活动分区

默认值： []

password

别名：pass、pwd

字符串 / 必需

username 帐户的密码。

server_ip

别名：ip、address

字符串

SLB 服务器 IPv4 地址。

server_name

别名：server

字符串 / 必需

SLB（服务器负载均衡器）服务器名称。

server_ports

别名：port

字符串

要为服务器创建的端口列表。每个列表项都应该是一个字典，该字典指定 port: 和 protocol:，但也可以选择指定 status:。有关详细信息，请参见下面的示例。当 state 为 present 时，此参数是必需的。

默认值： []

server_status

别名：status

字符串

SLB 虚拟服务器状态。

选项

  • "enabled" ← (默认)

  • "disabled"

state

字符串

用于指定创建、更新或删除 SLB 服务器的操作。

选项

  • "present" ← (默认)

  • "absent"

url

字符串

形式为 (http|https|ftp)://[user[:pass]]@host.domain[:port]/path 的 HTTP、HTTPS 或 FTP URL

url_password

字符串

用于 HTTP 基本身份验证的密码。

如果没有指定 url_username 参数，则不会使用 url_password 参数。

url_username

字符串

用于 HTTP 基本身份验证的用户名。

对于允许空密码的站点，此参数可以不使用url_password。

use_gssapi

布尔值

ansible-core 2.11版本中新增

使用GSSAPI进行身份验证，通常用于Kerberos或通过Negotiate身份验证的Kerberos。

需要安装Python库gssapi。

GSSAPI的凭据可以通过url_username/url_password或通过指定自定义Kerberos凭据缓存的GSSAPI环境变量KRB5CCNAME来指定。

即使安装了用于NTLM的GSSAPI机制，也不支持NTLM身份验证。

选项

  • false ← (默认)

  • true

use_proxy

布尔值

如果为no，即使目标主机上的环境变量中定义了代理，也不会使用代理。

选项

  • false

  • true ← (默认)

用户名

别名：admin, user

字符串 / 必需

具有管理员权限的帐户。

validate_certs

布尔值

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

选项

  • false

  • true ← (默认)

write_config

布尔值

如果为yes，任何更改都将导致将运行配置写入非易失性存储器。这将保存所有配置更改，包括可能手动或通过其他模块进行的更改，因此在指定yes时应谨慎。

选项

  • false ← (默认)

  • true

注释

注意

  • 需要A10 Networks aXAPI 2.1。

  • 需要A10 Networks aXAPI 2.1。

示例

- name: Create a new server
  community.network.a10_server:
    host: a10.mydomain.com
    username: myadmin
    password: mypassword
    partition: mypartition
    server: test
    server_ip: 1.1.1.100
    server_ports:
      - port_num: 8080
        protocol: tcp
      - port_num: 8443
        protocol: TCP

返回值

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

键

描述

内容

字符串

有关slb_server的完整信息

返回：成功

示例："mynewserver"

状态

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

  • 更多信息请参见已弃用。

作者

  • Eric Chou (@ericchou1)

  • Mischa Peters (@mischapeters)