Модуль ngine_io.cloudstack.router — управление маршрутизаторами в облаках на базе 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.router.

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

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

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

Запуск, перезапуск, остановка и удаление маршрутизаторов.
state=present не позволяет создавать маршрутизаторы; вместо этого используйте ngine_io.cloudstack.cs_network.

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

Требования

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

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	Домен, к которому относится маршрутизатор.
name string / обязательный	Имя маршрутизатора.
poll_async boolean	Ожидать завершения асинхронных заданий. Варианты: `false` `true` ← (по умолчанию)
project string	Имя проекта, к которому относится маршрутизатор.
service_offering string	Имя или идентификатор предложения службы для маршрутизатора.
state string	Состояние маршрутизатора. Варианты: `"present"` ← (по умолчанию) `"absent"` `"started"` `"stopped"` `"restarted"`
validate_certs boolean добавлено в ngine_io.cloudstack 2.4.0	Если `false`, SSL-сертификаты не будут проверяться. Если значение не задано, используется переменная окружения `CLOUDSTACK_DANGEROUS_NO_TLS_VERIFY`. Используйте этот параметр только на сайтах под вашим контролем, где применяются самоподписанные сертификаты. Варианты: `false` `true` ← (по умолчанию)
zone string	Имя зоны, в которой развернут маршрутизатор. Если значение не задано, используются все зоны.

Примечания

Примечание

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

Примеры

# Ensure the router has the desired service offering, no matter if
# the router is running or not.
- name: Present router
  ngine_io.cloudstack.router:
    name: r-40-VM
    service_offering: System Offering for Software Router

- name: Ensure started
  ngine_io.cloudstack.router:
    name: r-40-VM
    state: started

# Ensure started with desired service offering.
# If the service offerings changes, router will be rebooted.
- name: Ensure started with desired service offering
  ngine_io.cloudstack.router:
    name: r-40-VM
    service_offering: System Offering for Software Router
    state: started

- name: Ensure stopped
  ngine_io.cloudstack.router:
    name: r-40-VM
    state: stopped

- name: Remove a router
  ngine_io.cloudstack.router:
    name: r-40-VM
    state: absent

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

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

Ключ	Описание
account string	Учетная запись, к которой относится маршрутизатор. Возвращается: при успешном выполнении Пример: `"admin"`
created string	Дата создания маршрутизатора. Возвращается: при успешном выполнении Пример: `"2014-12-01T14:57:57+0100"`
domain string	Домен, к которому относится маршрутизатор. Возвращается: при успешном выполнении Пример: `"ROOT"`
id string	UUID маршрутизатора. Возвращается: при успешном выполнении Пример: `"04589590-ac63-4ffc-93f5-b698b8ac38b6"`
name string	Имя маршрутизатора. Возвращается: при успешном выполнении Пример: `"r-40-VM"`
redundant_state string	Состояние резервирования маршрутизатора. Возвращается: при успешном выполнении Пример: `"UNKNOWN"`
requires_upgrade boolean	Требуется ли обновить маршрутизатор до нового шаблона. Возвращается: при успешном выполнении Пример: `false`
role string	Роль маршрутизатора. Возвращается: при успешном выполнении Пример: `"VIRTUAL_ROUTER"`
service_offering string	Название предложения службы, назначенного маршрутизатору. Возвращается: при успешном выполнении Пример: `"System Offering For Software Router"`
state string	Состояние маршрутизатора. Возвращается: при успешном выполнении Пример: `"Active"`
template_version string	Версия шаблона системной виртуальной машины. Возвращается: при успешном выполнении Пример: `"4.5.1"`
zone string	Имя зоны, в которой находится маршрутизатор. Возвращается: при успешном выполнении Пример: `"ch-gva-2"`

Авторы

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/router_module.html