cloudscale_ch.cloud.load_balancer_pool_member 模块 – 管理 cloudscale.ch IaaS 服务上的负载均衡器池成员
注意
此模块是 cloudscale_ch.cloud 集合(版本 2.4.0)的一部分。
如果您使用的是 ansible
包,您可能已经安装了这个集合。它不包含在 ansible-core
中。要检查它是否已安装,请运行 ansible-galaxy collection list
。
要安装它,请使用:ansible-galaxy collection install cloudscale_ch.cloud
。
要在 playbook 中使用它,请指定:cloudscale_ch.cloud.load_balancer_pool_member
。
cloudscale_ch.cloud 2.3.0 中的新功能
概要
在 cloudscale.ch IaaS 服务上获取、创建、更新、删除池成员。
参数
参数 |
注释 |
---|---|
流量发送到的 IP 地址。 |
|
调用 cloudscale.ch API 的超时时间(秒)。 也可以在 默认值: |
|
cloudscale.ch API 令牌。 也可以在 |
|
cloudscale.ch API URL。 也可以在 默认值: |
|
如果为 false,池成员将不会接收流量。默认为 true。 选项
|
|
负载均衡器池的 UUID。 |
|
发送运行状况监控检查的端口。 如果未指定,将使用 protocol_port。默认为 null。 |
|
负载均衡器池成员的名称。 需要 name 或 uuid 中的一个。 |
|
实际流量发送到的端口。 |
|
负载均衡器池成员的状态。 选项
|
|
必须在此处指定地址的子网。 |
|
与负载均衡器关联的标签。将其设置为 |
|
负载均衡器的 UUID。 需要 name 或 uuid 中的一个。 |
注意
注意
如果提供了 uuid 选项,则在池成员选择方面,它优先于 name。这允许更新成员的名称。
如果未提供 uuid 选项,则使用 name 进行池成员选择。如果存在多个具有此名称的负载均衡器,则执行中止。
所有操作均使用 cloudscale.ch 公共 API v1 执行。
有关详细信息,请参阅完整的 API 文档:https://www.cloudscale.ch/en/api/v1。
所有操作都需要有效的 API 令牌。您可以使用 cloudscale.ch 控制面板在 https://control.cloudscale.ch 创建任意数量的令牌。
示例
# Create a pool member for a load balancer pool using registered variables
- name: Create a load balancer pool
cloudscale_ch.cloud.load_balancer_pool:
name: 'swimming-pool'
load_balancer: '514064c2-cfd4-4b0c-8a4b-c68c552ff84f'
algorithm: 'round_robin'
protocol: 'tcp'
tags:
project: ansible-test
stage: production
sla: 24-7
api_token: xxxxxx
register: load_balancer_pool
- name: Create a load balancer pool member
cloudscale_ch.cloud.load_balancer_pool_member:
name: 'my-shiny-swimming-pool-member'
load_balancer_pool: '{{ load_balancer_pool.uuid }}'
enabled: true
protocol_port: 8080
monitor_port: 8081
subnet: '70d282ab-2a01-4abb-ada5-34e56a5a7eee'
address: '172.16.0.100'
tags:
project: ansible-test
stage: production
sla: 24-7
api_token: xxxxxx
# Get load balancer pool member facts by name
- name: Get facts of a load balancer pool member by name
cloudscale_ch.cloud.load_balancer_pool_member:
name: 'my-shiny-swimming-pool-member'
api_token: xxxxxx
返回值
常见的返回值在此处记录,以下是此模块特有的字段
键 |
描述 |
---|---|
流量发送到的 IP 地址 已返回:成功 示例: |
|
负载均衡器池成员的创建日期和时间 已返回:当 state != absent 时成功 示例: |
|
负载均衡器池成员的状态 已返回:成功 示例: |
|
用于获取有关此负载均衡器详细信息的 API URL 已返回:当 state != absent 时成功 示例: |
|
发送运行状况监控检查的端口 已返回:成功 示例: |
|
此成员的池运行状况监控检查状态 已返回:成功 示例: |
|
负载均衡器池成员的显示名称 已返回:成功 示例: |
|
池成员的池 已返回:成功 示例: |
|
实际流量发送到的端口 已返回:成功 示例: |
|
地址所在的私有网络中的子网 已返回:成功 示例: |
|
与负载均衡器关联的标签 已返回:成功 示例: |
|
此负载均衡器池成员的唯一标识符 已返回:成功 示例: |