ngine_io.cloudstack.cs_host – Управляет хостами в облаках на основе Apache CloudStack.
Примечание
Этот плагин является частью коллекции ngine_io.cloudstack (версия 2.0.0).
Для его установки используйте: ansible-galaxy collection install ngine_io.cloudstack
Для использования в плейбуке укажите: ngine_io.cloudstack.cs_host
Новое в версии 0.1.0: из ngine_io.cloudstack
Обзор
- Создание, обновление и удаление хостов.
Требования
Ниже приведены требования, необходимые на хосте, на котором выполняется этот модуль.
- python >= 2.6
- cs >= 0.9.0
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| allocation_state строка |
| Состояние выделения хоста. |
| api_http_method строка |
| HTTP-метод, используемый для запроса API-точки входа. Если не указано, используется переменная среды CLOUDSTACK_METHOD |
| api_key строка / обязательно | API-ключ API CloudStack. Если не указано, используется переменная среды CLOUDSTACK_KEY | |
| api_secret строка / обязательно | Секретный ключ API CloudStack. Если не указано, используется переменная среды CLOUDSTACK_SECRET | |
| api_timeout целое число | По умолчанию: 10 | Таймаут HTTP в секундах. Если не указано, используется переменная среды CLOUDSTACK_TIMEOUT |
| api_url строка / обязательно | URL API CloudStack, например, https://cloud.example.com/client/api. Если не указано, используется переменная среды CLOUDSTACK_ENDPOINT | |
| api_verify_ssl_cert строка | Проверка сертификата авторитета CA. Если не указано, используется переменная среды CLOUDSTACK_VERIFY | |
| cluster строка | Имя кластера. | |
| host_tags список / элементы=строка | Теги хоста. псевдонимы: host_tag | |
| hypervisor строка | Имя кластера. Требуется, если state=present и хост еще не существует. Возможные значения: KVM, VMware, BareMetal, XenServer, LXC, HyperV, UCS, OVM, Simulator | |
| name строка / обязательно | Имя хоста. псевдонимы: ip_address | |
| password строка | Пароль для хоста. Требуется, если state=present и хост еще не существует. | |
| pod строка | Имя подсети. Требуется, если state=present и хост еще не существует. | |
| state строка |
| Состояние хоста. |
| url строка | URL хоста, используемого для создания хоста. Если не указано, используется http:// и параметр name в качестве URL.Учитывается только, если state=present и хост еще не существует. | |
| username строка | Имя пользователя для хоста. Требуется, если state=present и хост еще не существует. | |
| zone строка / обязательно | Имя зоны, в которой должен быть развернут хост. |
Примечания
Примечание
- Подробное руководство по модулям cloudstack можно найти в Руководстве по облаку CloudStack.
- Этот модуль поддерживает режим проверки.
Примеры
- name: Ensure a host is present but disabled
ngine_io.cloudstack.cs_host:
name: pod01.zone01.example.com
cluster: vcenter.example.com/zone01/cluster01
pod: pod01
zone: zone01
hypervisor: VMware
allocation_state: disabled
host_tags:
- perf
- gpu
- name: Ensure an existing host is disabled
ngine_io.cloudstack.cs_host:
name: pod01.zone01.example.com
zone: zone01
allocation_state: disabled
- name: Ensure an existing host is enabled
ngine_io.cloudstack.cs_host:
name: pod01.zone01.example.com
zone: zone01
allocation_state: enabled
- name: Ensure a host is absent
ngine_io.cloudstack.cs_host:
name: pod01.zone01.example.com
zone: zone01
state: absent
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| allocation_state: строка | success | Состояние выделения ресурсов хоста. Пример: enabled |
| capabilities строка | success | Возможности хоста. Пример: hvm |
| cluster строка | success | Кластер хоста. Пример: vcenter.example.com/zone/cluster01 |
| cluster_type строка | success | Тип кластера хоста. Пример: ExternalManaged |
| cpu_allocated строка | success | Процент процессорного времени хоста, выделенного в данный момент. Пример: 166.25% |
| cpu_number строка | success | Количество процессоров хоста. Пример: 24 |
| cpu_sockets целое число | success | Количество сокетов процессора хоста. Пример: 2 |
| cpu_speed целое число | success | Частота процессора в МГц Пример: 1999 |
| cpu_used строка | success | Используемое процессорное время хоста. Пример: 33.6% |
| cpu_with_overprovisioning строка | success | Количество процессорных ресурсов хоста после применения cpu.overprovisioning.factor. Пример: 959520.0 |
| created строка | success | Дата создания хоста. Пример: 2015-05-03T15:05:51+0200 |
| disconnected строка | success | Дата отключения хоста. Пример: 2015-05-03T15:05:51+0200 |
| disk_size_allocated целое число | success | Выделенный размер диска хоста. Пример: 2593 |
| disk_size_total целое число | success | Общий размер диска хоста. Пример: 259300 |
| events строка | success | Доступные события для хоста. Пример: Ping; HostDown; AgentConnected; AgentDisconnected; PingTimeout; ShutdownRequested; Remove; StartAgentRebalance; ManagementServerDown |
| gpu_group список / элементы=строка | success | Наличие видеокарт на хосте. |
| ha_host логическое значение | success | Является ли хост хостом HA. |
| has_enough_capacity логическое значение | success | Достаточно ли на хосте ресурсов (CPU и ОЗУ) для миграции виртуальной машины? Пример: True |
| host_tags строка | success | Список меток хоста, разделенных запятыми. Пример: perf |
| host_type строка | success | Тип хоста. Пример: Routing |
| host_version строка | success | Версия хоста. Пример: 4.5.2 |
| hypervisor строка | success | Гипервизор хоста. Пример: VMware |
| hypervisor_version строка | success | Версия гипервизора. Пример: 5.1 |
| ip_address строка | success | IP-адрес хоста. Пример: 10.10.10.1 |
| is_local_storage_active логическое значение | success | Доступно ли локальное хранилище. |
| last_pinged строка | success | Дата и время последнего пинга хоста. Пример: 1970-01-17T17:27:32+0100 |
| management_server_id целое число | success | ID сервера управления хостом. Пример: 345050593418 |
| memory_allocated целое число | success | Выделенный объем памяти хоста. Пример: 69793218560 |
| memory_total целое число | success | Общий объем памяти хоста. Пример: 206085263360 |
| memory_used целое число | success | Используемый объем памяти хоста. Пример: 65504776192 |
| name строка | success | Имя хоста. Пример: esx32.example.com |
| network_kbs_read целое число | success | Входящий сетевой трафик на хосте. |
| network_kbs_write целое число | success | Исходящий сетевой трафик на хосте. |
| os_category строка | success | Категория операционной системы хоста. Пример: ... |
| out_of_band_management строка | success | Информация о внеполосном управлении хостом. Пример: ... |
| pod строка | success | Имя подсети хоста. Пример: Pod01 |
| removed строка | success | Дата и время удаления хоста. Пример: 1970-01-17T17:27:32+0100 |
| resource_state строка | success | Состояние ресурса хоста. Пример: Enabled |
| state строка | success | Состояние хоста. Пример: Up |
| suitable_for_migration строка | success | Подходит ли этот хост для миграции виртуальной машины (имеет достаточную мощность и соответствует всем условиям, таким как hosttags, максимальное количество виртуальных машин и т. д.)? Пример: True |
| zone строка | success | Зона хоста. Пример: zone01 |
Авторы
- René Moser (@resmo)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/ngine_io/cloudstack/cs_host_module.html
