community.general.profitbricks модуль – Создание, удаление, запуск, остановка и перезагрузка виртуальной машины ProfitBricks

Примечание

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

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

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

Для использования в книге задач укажите: community.general.profitbricks.

Обзор
Требования
Параметры
Атрибуты
Примеры

Обзор

Создание, удаление, обновление, запуск, остановка и перезагрузка виртуальной машины ProfitBricks. При создании виртуальной машины можно дополнительно дождаться состояния «работает» перед возвратом. Этот модуль зависит от profitbricks >= 1.0.0

Требования

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

profitbricks

Параметры

Параметр	Комментарии
assign_public_ip boolean	Это назначит машину в публичную LAN. Если LAN с публичным доступом в Интернет не существует, она будет создана. Варианты: `false` ← (default) `true`
auto_increment boolean	Увеличивать ли на единицу число в имени для создаваемых виртуальных машин. Варианты: `false` `true` ← (default)
bus string	Тип шины для тома. Варианты: `"IDE"` `"VIRTIO"` ← (default)
cores integer	Количество ядер ЦП, которые нужно выделить для виртуальной машины. По умолчанию: `2`
count integer	Количество виртуальных машин для создания. По умолчанию: `1`
cpu_family string	Тип семейства ЦП, который нужно выделить для виртуальной машины. Варианты: `"AMD_OPTERON"` ← (default) `"INTEL_XEON"`
datacenter string	Центр обработки данных для подготовки этой виртуальной машины.
disk_type string	тип диска, который будет выделен. Варианты: `"SSD"` `"HDD"` ← (default)
image string	Идентификатор системного образа для создания виртуальной машины, например, a3eae284-a2fe-11e4-b187-5f1f641608c8.
image_password string	Установленный пароль для административного пользователя.
instance_ids list / elements=string	Список идентификаторов экземпляров, в настоящее время используется только при state=’absent’ для удаления экземпляров. По умолчанию: `[]`
lan integer	Идентификатор LAN, к которой вы хотите добавить серверы. По умолчанию: `1`
location string	Местоположение центра обработки данных. Используйте только если вы хотите создать центр обработки данных, иначе это значение игнорируется. Варианты: `"us/las"` ← (default) `"de/fra"` `"de/fkb"`
name string	Имя виртуальной машины.
ram integer	Объём памяти, который нужно выделить для виртуальной машины. По умолчанию: `2048`
remove_boot_volume boolean	удалить загрузочный том виртуальной машины, которую вы уничтожаете. Варианты: `false` `true` ← (default)
ssh_keys list / elements=string	Открытые ключи SSH, разрешающие доступ к виртуальной машине. По умолчанию: `[]`
state string	создать или завершить работу экземпляров Доступные варианты: `running`, `stopped`, `absent`, `present`. По умолчанию: `"present"`
subscription_password string	Пароль ProfitBricks. Перезаписывает переменную среды PB_PASSWORD.
subscription_user string	Имя пользователя ProfitBricks. Перезаписывает переменную среды PB_SUBSCRIPTION_ID.

volume_size integer	Размер загрузочного тома в ГБ. По умолчанию: `10`
wait boolean	Дождаться состояния «running» у виртуальной машины перед возвратом. Доступные значения: `false` `true` ← (по умолчанию)
wait_timeout integer	Время ожидания в секундах, после которого будет прекращено ожидание. По умолчанию: `600`

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: отсутствует	Может работать в режиме `check_mode` и возвращать предсказание изменений без модификации целевого объекта.
diff_mode	Поддержка: отсутствует	Возвращает подробности о внесенных изменениях (или возможно необходимых изменениях в `check_mode`) в режиме сравнения.

Примеры

# Note: These examples do not set authentication details, see the AWS Guide for details.

# Provisioning example
- name: Create three servers and enumerate their names
  community.general.profitbricks:
    datacenter: Tardis One
    name: web%02d.stackpointcloud.com
    cores: 4
    ram: 2048
    volume_size: 50
    cpu_family: INTEL_XEON
    image: a3eae284-a2fe-11e4-b187-5f1f641608c8
    location: us/las
    count: 3
    assign_public_ip: true

- name: Remove virtual machines
  community.general.profitbricks:
    datacenter: Tardis One
    instance_ids:
      - 'web001.stackpointcloud.com'
      - 'web002.stackpointcloud.com'
      - 'web003.stackpointcloud.com'
    wait_timeout: 500
    state: absent

- name: Start virtual machines
  community.general.profitbricks:
    datacenter: Tardis One
    instance_ids:
      - 'web001.stackpointcloud.com'
      - 'web002.stackpointcloud.com'
      - 'web003.stackpointcloud.com'
    wait_timeout: 500
    state: running

- name: Stop virtual machines
  community.general.profitbricks:
    datacenter: Tardis One
    instance_ids:
      - 'web001.stackpointcloud.com'
      - 'web002.stackpointcloud.com'
      - 'web003.stackpointcloud.com'
    wait_timeout: 500
    state: stopped

Авторы

Matt Baldwin (@baldwinSPC)

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

© 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/profitbricks_module.html