Spec-Zone.ru › Ansible

Модуль community.general.clc_loadbalancer – Создание и удаление общих балансировщиков нагрузки в CenturyLink Cloud

Примечание

Этот модуль является частью коллекции community.general (версия 9.5.0).

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

Для установки используйте: ansible-galaxy collection install community.general. Для использования этого модуля требуются дополнительные компоненты, см. Требования для получения подробной информации.

Для использования в playbook укажите: community.general.clc_loadbalancer.

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

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

  • Модуль Ansible для создания и удаления общих балансировщиков нагрузки в CenturyLink Cloud.

Требования

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

  • python = 2.7
  • requests >= 2.5.0
  • clc-sdk

Параметры

Параметр

Комментарии

alias

строка / обязательный

Псевдоним вашей учетной записи CLC

description

строка

Описание балансировщика нагрузки

location

строка / обязательный

Расположение ЦОД, в котором находится балансировщик нагрузки

method

строка

-Метод балансировки для пула балансировщиков нагрузки

Варианты:

  • "leastConnection"
  • "roundRobin"

name

строка / обязательный

Имя балансировщика нагрузки

nodes

список / элементы=словарь

Список узлов, которые необходимо добавить в пул балансировщиков нагрузки

Значение по умолчанию: []

persistence

строка

Метод сохранения состояния для балансировщика нагрузки

Варианты:

  • "standard"
  • "sticky"

port

строка

Порт для настройки на внешней стороне пула балансировщиков нагрузки

Варианты:

  • "80"
  • "443"

state

строка

Создать или удалить пул балансировщиков нагрузки

Варианты:

  • "present" ← (по умолчанию)
  • "absent"
  • "port_absent"
  • "nodes_present"
  • "nodes_absent"

status

строка

Статус балансировщика нагрузки

Варианты:

  • "enabled" ← (по умолчанию)
  • "disabled"

Атрибуты

Атрибут

Поддержка

Описание

check_mode

Поддержка: полная

Может работать в режиме check_mode и возвращать прогноз статуса изменения без модификации цели.

diff_mode

Поддержка: отсутствует

Возвращает подробную информацию о том, что изменилось (или что может потребовать изменения в режиме check_mode), когда находится в diff-режиме.

Примечания

Примечание

  • Для использования этого модуля необходимо установить следующие переменные среды, которые обеспечивают доступ к Centurylink Cloud - CLC_V2_API_USERNAME, идентификатор входа в учетную запись для Centurylink Cloud - CLC_V2_API_PASSWORD, пароль учетной записи для Centurylink Cloud
  • В качестве альтернативы модуль принимает токен API и псевдоним учетной записи. Токен API можно сгенерировать с помощью логина и пароля учетной записи CLC через вызов HTTP-API по адресу https://api.ctl.io/v2/authentication/login - CLC_V2_API_TOKEN, токен API, сгенерированный с помощью https://api.ctl.io/v2/authentication/login - CLC_ACCT_ALIAS, псевдоним учетной записи, связанный с Centurylink Cloud
  • Пользователи могут установить CLC_V2_API_URL для указания конечной точки для указания на другую среду CLC.

Примеры

# Note - You must set the CLC_V2_API_USERNAME And CLC_V2_API_PASSWD Environment variables before running these examples
- name: Create Loadbalancer
  hosts: localhost
  connection: local
  tasks:
    - name: Actually Create things
      community.general.clc_loadbalancer:
        name: test
        description: test
        alias: TEST
        location: WA1
        port: 443
        nodes:
          - ipAddress: 10.11.22.123
            privatePort: 80
        state: present

- name: Add node to an existing loadbalancer pool
  hosts: localhost
  connection: local
  tasks:
    - name: Actually Create things
      community.general.clc_loadbalancer:
        name: test
        description: test
        alias: TEST
        location: WA1
        port: 443
        nodes:
          - ipAddress: 10.11.22.234
            privatePort: 80
        state: nodes_present

- name: Remove node from an existing loadbalancer pool
  hosts: localhost
  connection: local
  tasks:
    - name: Actually Create things
      community.general.clc_loadbalancer:
        name: test
        description: test
        alias: TEST
        location: WA1
        port: 443
        nodes:
          - ipAddress: 10.11.22.234
            privatePort: 80
        state: nodes_absent

- name: Delete LoadbalancerPool
  hosts: localhost
  connection: local
  tasks:
    - name: Actually Delete things
      community.general.clc_loadbalancer:
        name: test
        description: test
        alias: TEST
        location: WA1
        port: 443
        nodes:
          - ipAddress: 10.11.22.123
            privatePort: 80
        state: port_absent

- name: Delete Loadbalancer
  hosts: localhost
  connection: local
  tasks:
    - name: Actually Delete things
      community.general.clc_loadbalancer:
        name: test
        description: test
        alias: TEST
        location: WA1
        port: 443
        nodes:
          - ipAddress: 10.11.22.123
            privatePort: 80
        state: absent

Значения возврата

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

Ключ

Описание

loadbalancer

словарь

Объект результата балансировщика нагрузки из CLC

Возвращено: успех

Пример: {"description": "test-lb", "id": "ab5b18cb81e94ab9925b61d1ca043fb5", "ipAddress": "66.150.174.197", "links": [{"href": "/v2/sharedLoadBalancers/wfad/wa1/ab5b18cb81e94ab9925b61d1ca043fb5", "rel": "self", "verbs": ["GET", "PUT", "DELETE"]}, {"href": "/v2/sharedLoadBalancers/wfad/wa1/ab5b18cb81e94ab9925b61d1ca043fb5/pools", "rel": "pools", "verbs": ["GET", "POST"]}], "name": "test-lb", "pools": [], "status": "enabled"}

Авторы

  • CLC Runner (@clc-runner)

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

  • Отслеживание проблем
  • Репозиторий (источники)
  • Задать вопрос о помощи
  • Отправить отчет об ошибке
  • Запросить новую функцию
  • Связь

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/clc_loadbalancer_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API