Spec-Zone.ru › Ansible

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

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

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

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

  • Создание, обновление и удаление хостов.

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

Требования

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

  • python >= 2.6
  • cs >= 0.9.0

Параметры

Параметр

Комментарии

allocation_state

string

Состояние выделения хоста.

Варианты:

  • "enabled"
  • "disabled"
  • "maintenance"

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.

cluster

string

Имя кластера.

host_tags

псевдонимы: host_tag

list / элементы=string

Теги хоста.

hypervisor

string

Имя кластера.

Обязателен, если state=present и хост ещё не существует.

Возможные значения: KVM, VMware, BareMetal, XenServer, LXC, HyperV, UCS, OVM, Simulator.

name

псевдонимы: ip_address

string / обязательный

Имя хоста.

password

string

Пароль для хоста.

Обязателен, если state=present и хост ещё не существует.

pod

string

Имя пода.

Обязателен, если state=present и хост ещё не существует.

state

string

Состояние хоста.

Варианты:

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

url

string

URL хоста, используемый для его создания.

Если не указан, http:// и параметр name используются в качестве URL.

Учитывается только если state=present и хост ещё не существует.

username

string

Имя пользователя для хоста.

Обязательно, если state=present и хост ещё не существует.

validate_certs

boolean

добавлено в ngine_io.cloudstack 2.4.0

Если false, сертификаты SSL не будут проверяться.

Если не задано, используется переменная окружения CLOUDSTACK_DANGEROUS_NO_TLS_VERIFY.

Используйте этот параметр только на сайтах под личным управлением, где применяются самоподписанные сертификаты.

Варианты:

  • false
  • true ← (по умолчанию)

zone

string / обязательный

Имя зоны, в которой следует развернуть хост.

Примечания

Примечание

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

Примеры

- name: Ensure a host is present but disabled
  ngine_io.cloudstack.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.host:
    name: pod01.zone01.example.com
    zone: zone01
    allocation_state: disabled

- name: Ensure an existing host is enabled
  ngine_io.cloudstack.host:
    name: pod01.zone01.example.com
    zone: zone01
    allocation_state: enabled

- name: Ensure a host is absent
  ngine_io.cloudstack.host:
    name: pod01.zone01.example.com
    zone: zone01
    state: absent

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

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

Ключ

Описание

allocation_state

string

Состояние выделения ресурсов хоста.

Возвращается: success

Пример: "enabled"

capabilities

string

Возможности хоста.

Возвращается: success

Пример: "hvm"

cluster

string

Кластер хоста.

Возвращается: success

Пример: "vcenter.example.com/zone/cluster01"

cluster_type

string

Тип кластера хоста.

Возвращается: success

Пример: "ExternalManaged"

cpu_allocated

string

Доля ЦП хоста, выделенная в данный момент, в процентах.

Возвращается: success

Пример: "166.25%"

cpu_number

string

Количество ЦП хоста.

Возвращается: success

Пример: "24"

cpu_sockets

integer

Количество процессорных разъёмов хоста.

Возвращается: success

Пример: 2

cpu_speed

integer

Тактовая частота ЦП в МГц

Возвращается: success

Пример: 1999

cpu_used

string

Объём ресурсов ЦП хоста, используемый в данный момент.

Возвращается: success

Пример: "33.6%"

cpu_with_overprovisioning

string

Объём ресурсов ЦП хоста с учётом применения cpu.overprovisioning.factor.

Возвращается: success

Пример: "959520.0"

created

string

Дата создания хоста.

Возвращается: success

Пример: "2015-05-03T15:05:51+0200"

disconnected

string

Дата отключения хоста.

Возвращается: success

Пример: "2015-05-03T15:05:51+0200"

disk_size_allocated

integer

Объём дискового пространства хоста, выделенный в данный момент.

Возвращается: success

Пример: 2593

disk_size_total

integer

Общий объём дискового пространства хоста

Возвращается: success

Пример: 259300

events

string

События, доступные для хоста

Возвращается: success

Пример: "Ping; HostDown; AgentConnected; AgentDisconnected; PingTimeout; ShutdownRequested; Remove; StartAgentRebalance; ManagementServerDown"

gpu_group

list / elements=string

Графические процессоры, установленные на хосте.

Возвращается: success

Пример: []

ha_host

boolean

Является ли хост хостом высокой доступности (HA).

Возвращается: success

Пример: false

has_enough_capacity

boolean

Достаточно ли на хосте ресурсов ЦП и ОЗУ для переноса на него виртуальной машины.

Возвращается: success

Пример: true

host_tags

string

Разделённый запятыми список тегов хоста.

Возвращается: success

Пример: "perf"

host_type

string

Тип хоста.

Возвращается: success

Пример: "Routing"

host_version

string

Версия хоста.

Возвращается: success

Пример: "4.5.2"

hypervisor

string

Гипервизор хоста.

Возвращается: success

Пример: "VMware"

hypervisor_version

string

Версия гипервизора.

Возвращается: success

Пример: "5.1"

ip_address

string

IP-адрес хоста

Возвращается: success

Пример: "10.10.10.1"

is_local_storage_active

boolean

Доступно ли локальное хранилище.

Возвращается: success

Пример: false

last_pinged

string

Дата и время последней проверки доступности хоста.

Возвращается: success

Пример: "1970-01-17T17:27:32+0100"

management_server_id

integer

Идентификатор управляющего сервера хоста.

Возвращается: success

Пример: 345050593418

memory_allocated

integer

Объём памяти хоста, выделенный в данный момент.

Возвращается: success

Пример: 69793218560

memory_total

integer

Общий объём памяти хоста.

Возвращается: success

Пример: 206085263360

memory_used

integer

Объём памяти хоста, используемый в данный момент.

Возвращается: success

Пример: 65504776192

name

string

Имя хоста.

Возвращается: success

Пример: "esx32.example.com"

network_kbs_read

integer

Входящий сетевой трафик на хосте.

Возвращается: success

Пример: 0

network_kbs_write

integer

Исходящий сетевой трафик на хосте.

Возвращается: success

Пример: 0

os_category

string

Название категории ОС хоста.

Возвращается: success

Пример: "..."

out_of_band_management

string

Сведения об автономном управлении хостом.

Возвращается: success

Пример: "..."

pod

string

Название пода хоста.

Возвращается: success

Пример: "Pod01"

removed

string

Дата и время удаления хоста.

Возвращается: success

Пример: "1970-01-17T17:27:32+0100"

resource_state

string

Состояние ресурсов хоста.

Возвращается: success

Пример: "Enabled"

state

string

Состояние хоста.

Возвращается: success

Пример: "Up"

suitable_for_migration

string

Подходит ли этот хост для переноса на него виртуальной машины (достаточно ли ресурсов и выполнены ли все условия, например, соответствие тегам хоста, ограничению на максимальное количество гостевых ВМ и т. д.).

Возвращается: success

Пример: "True"

zone

string

Зона хоста.

Возвращается: success

Пример: "zone01"

Авторы

  • 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/host_module.html

Spec-Zone.ru

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