Модуль ngine_io.cloudstack.lb_rule_member — управление участниками правил балансировщика нагрузки в облаках на базе Apache CloudStack.

Примечание

Этот модуль входит в коллекцию ngine_io.cloudstack (версия 3.0.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install ngine_io.cloudstack. Для использования этого модуля необходимы дополнительные требования. Подробнее см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: ngine_io.cloudstack.lb_rule_member.

Добавлено в ngine_io.cloudstack 0.1.0

Краткое описание
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Краткое описание

Добавляет и удаляет участников правил балансировщика нагрузки.

Псевдонимы: cs_loadbalancer_rule_member

Требования

На узле, на котором выполняется этот модуль, должны быть установлены следующие компоненты.

python >= 2.6
cs >= 0.9.0

Параметры

Параметр	Комментарии
account string	Учетная запись, к которой относится правило.
api_http_method string	Метод HTTP, используемый для запроса конечной точки API. Если не задан, используется переменная окружения `CLOUDSTACK_METHOD`. Варианты: `"get"` ← (по умолчанию) `"post"`
api_key string / обязательный	Ключ API CloudStack. Если не задан, используется переменная окружения `CLOUDSTACK_KEY`.
api_secret string / обязательный	Секретный ключ API CloudStack. Если не задан, используется переменная окружения `CLOUDSTACK_SECRET`.
api_timeout integer	Тайм-аут HTTP в секундах. Если не задан, используется переменная окружения `CLOUDSTACK_TIMEOUT`. По умолчанию: `10`
api_url string / обязательный	URL API CloudStack, например https://cloud.example.com/client/api. Если не задан, используется переменная окружения `CLOUDSTACK_ENDPOINT`.
api_verify_ssl_cert string	Проверять файл сертификата центра сертификации. Если не задан, используется переменная окружения `CLOUDSTACK_VERIFY`.
domain string	Домен, к которому относится правило.
ip_address псевдонимы: public_ip string	Публичный IP-адрес, с которого будет распределяться сетевой трафик. Нужен только для поиска правила, если значение name не уникально.
name string / обязательный	Имя правила балансировщика нагрузки.
poll_async boolean	Ожидать завершения асинхронных заданий. Варианты: `false` `true` ← (по умолчанию)
project string	Имя проекта, к которому относится правило брандмауэра.
state string	Должны ли виртуальные машины присутствовать в правиле или отсутствовать в нем. Варианты: `"present"` ← (по умолчанию) `"absent"`
validate_certs boolean добавлено в ngine_io.cloudstack 2.4.0	Если задано значение `false`, сертификаты SSL не проверяются. Если не задано, используется переменная окружения `CLOUDSTACK_DANGEROUS_NO_TLS_VERIFY`. Этот параметр следует использовать только на контролируемых вами сайтах с самоподписанными сертификатами. Варианты: `false` `true` ← (по умолчанию)
vms псевдонимы: vm list / элементы=string / обязательный	Список виртуальных машин, которые нужно назначить правилу или удалить из него.
zone string	Имя зоны, в которой должно находиться правило. Обязательно, если поставщик балансировки нагрузки — ElasticLoadBalancerVm

Примечания

Примечание

Подробное руководство по модулям CloudStack доступно в руководстве по облаку CloudStack.
Этот модуль поддерживает режим проверки.

Примеры

- name: Add VMs to an existing load balancer
  ngine_io.cloudstack.lb_rule_member:
    name: balance_http
    vms:
      - web01
      - web02

- name: Remove a VM from an existing load balancer
  ngine_io.cloudstack.lb_rule_member:
    name: balance_http
    vms:
      - web01
      - web02
    state: absent


# Rolling upgrade of hosts
- hosts: webservers
  serial: 1
  pre_tasks:
    - name: Remove from load balancer
      ngine_io.cloudstack.lb_rule_member:
        name: balance_http
        vm: "{{ ansible_hostname }}"
        state: absent
  tasks:
    # Perform update
  post_tasks:
    - name: Add to load balancer
      ngine_io.cloudstack.lb_rule_member:
        name: balance_http
        vm: "{{ ansible_hostname }}"
        state: present

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже приведены поля, уникальные для этого модуля:

Ключ	Описание
account string	Учетная запись, к которой относится правило. Возвращается: при успехе Пример: `"example account"`
algorithm string	Используемый алгоритм балансировщика нагрузки. Возвращается: при успехе Пример: `"source"`
cidr string	CIDR для перенаправления трафика. Возвращается: при успехе Пример: `"0.0.0.0/0"`
description string	Описание правила. Возвращается: при успехе Пример: `"http load balancer rule"`
domain string	Домен, к которому относится правило. Возвращается: при успехе Пример: `"example domain"`
id string	UUID правила. Возвращается: при успехе Пример: `"a6f7a5fc-43f8-11e5-a151-feff819cdc9f"`
name string	Имя правила. Возвращается: при успехе Пример: `"http-lb"`
private_port integer	Частный IP-адрес. Возвращается: при успехе Пример: `80`
project string	Имя проекта, к которому относится правило. Возвращается: при успехе Пример: `"Production"`
protocol string	Протокол правила. Возвращается: при успехе Пример: `"tcp"`
public_ip string	Публичный IP-адрес. Возвращается: при успехе Пример: `"1.2.3.4"`
public_port integer	Публичный порт. Возвращается: при успехе Пример: `80`
state string	Состояние правила. Возвращается: при успехе Пример: `"Add"`
tags list / элементы=string	Список тегов ресурса, связанных с правилом. Возвращается: при успехе Пример: `["[ { \"key\": \"foo\"", " \"value\": \"bar\" } ]"]`
vms list / элементы=string	Участники правила. Возвращается: при успехе Пример: `["[ \"web01\"", " \"web02\" ]"]`
zone string	Имя зоны, к которой относится правило. Возвращается: при успехе Пример: `"ch-gva-2"`

Авторы

Darren Worrall (@dazworrall)
René Moser (@resmo)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/ngine_io/cloudstack/lb_rule_member_module.html