Модуль vultr.cloud.bare_metal — управление серверами Bare Metal в Vultr.

Примечание

Этот модуль входит в коллекцию vultr.cloud (версия 1.14.0).

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

Для установки используйте: ansible-galaxy collection install vultr.cloud.

Чтобы использовать коллекцию в плейбуке, укажите: vultr.cloud.bare_metal.

Добавлено в vultr.cloud 1.9.0

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

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

Управление серверами Bare Metal в Vultr.

Параметры

Параметр	Комментарии
activation_email boolean	Отправлять ли письмо активации после подготовки сервера Bare Metal. Учитывается только при создании. Варианты: `false` ← (по умолчанию) `true`
api_endpoint string	URL конечной точки API (без завершающей косой черты). Резервная переменная окружения `VULTR_API_ENDPOINT`. По умолчанию: `"https://api.vultr.com/v2"`
api_key string / обязательный	Ключ API Vultr. Резервная переменная окружения `VULTR_API_KEY`.
api_results_per_page integer добавлено в vultr.cloud 1.14.0	При получении большого количества ресурсов укажите, сколько результатов должно возвращаться за один вызов API. Это значение не определяет общее количество возвращаемых результатов: все ресурсы возвращаются с учетом других фильтров. Максимальное значение для API Vultr — 500. Резервная переменная окружения `VULTR_API_RESULTS_PER_PAGE`. По умолчанию: `100`
api_retries integer	Количество повторных попыток в случае, если API Vultr возвращает код ошибки HTTP, например: 429 Too Many Requests, 500 Internal Server Error или 504 Gateway Time-out. Резервная переменная окружения `VULTR_API_RETRIES`. По умолчанию: `5`
api_retry_max_delay integer	Задержка между повторными попытками увеличивается экспоненциально до этого максимального значения (в секундах). Резервная переменная окружения `VULTR_API_RETRY_MAX_DELAY`. По умолчанию: `12`
api_timeout integer	Тайм-аут HTTP-запросов к API Vultr. Резервная переменная окружения `VULTR_API_TIMEOUT`. По умолчанию: `180`
app string	Имя развертываемого приложения Vultr OneClick. Взаимоисключающий параметр с image и os.
enable_ipv6 boolean	Включить ли IPv6. Варианты: `false` `true`
hostname string	Имя хоста, назначаемое этому серверу Bare Metal.
image string	Имя образа приложения, развертываемого из маркетплейса Vultr. Взаимоисключающий параметр с os и app.
label псевдонимы: name string / обязательный	Имя сервера Bare Metal.
mdisk_mode string добавлено в vultr.cloud 1.14.0	Режим работы с несколькими дисками на сервере Bare Metal. Если указано `none`, все диски, кроме диска с ОС, остаются неотформатированными. Если указано `jbod` (Just a Bunch Of Disks), все диски, кроме диска с ОС, форматируются и монтируются. Если указано `raid1`, экземпляр создается с диском ОС, настроенным в программном RAID1. Вариант `raid1` не применим для ОС Windows. Варианты: `"none"` ← (по умолчанию) `"jbod"` `"raid1"`
os string	Название операционной системы. Взаимоисключающий параметр с image и app.
persistent_pxe boolean	Включить ли постоянную загрузку PXE. Варианты: `false` `true`
plan string	Название плана для сервера Bare Metal. Обязателен, если сервер Bare Metal еще не существует.
region string / обязательный	Регион, в котором развертывается сервер Bare Metal.
reserved_ipv4 string	IP-адрес плавающего IP-адреса, который будет использоваться в качестве основного IP-адреса этого сервера Bare Metal. Учитывается только при создании.
skip_wait boolean добавлено в vultr.cloud 1.13.0	Пропустить ли ожидание полной готовности экземпляра к доступу. Варианты: `false` ← (по умолчанию) `true`
snapshot string	Описание или идентификатор снимка. Учитывается только при создании сервера Bare Metal.
ssh_keys list / элементы=string	Список имен SSH-ключей, передаваемых серверу Bare Metal при создании.
startup_script string	Имя или идентификатор скрипта запуска, выполняемого при загрузке. Учитывается только при создании сервера Bare Metal.
state string	Состояние сервера Bare Metal. Варианты: `"present"` ← (по умолчанию) `"absent"`
tags list / элементы=string	Теги сервера Bare Metal.
user_data string	Пользовательские данные, передаваемые серверу Bare Metal.
validate_certs boolean	Проверять SSL-сертификаты API Vultr. Варианты: `false` `true` ← (по умолчанию)
vpc2s list / элементы=string	Список VPC (VPC 2.0), определяемых по описанию и назначаемых серверу Bare Metal.

Примечания

Примечание

См. также документацию API: https://www.vultr.com/api/.

Примеры

---
- name: Create an bare metal machine using OS
  vultr.cloud.bare_metal:
    label: my web server
    hostname: my-hostname
    user_data: |
      #cloud-config
      packages:
        - nginx
    plan: vbm-4c-32gb
    enable_ipv6: true
    ssh_keys:
      - my ssh key
    vpc2s:
      - my vpc description
    tags:
      - web
      - project-genesis
    region: ams
    os: Debian 12 x64 (bookworm)

- name: Deploy an bare metal machine of a marketplace app
  vultr.cloud.bare_metal:
    label: git-server
    hostname: git
    plan: vbm-4c-32gb
    enable_ipv6: true
    region: ams
    image: Gitea on Ubuntu 20.04

- name: Delete an bare metal machine
  vultr.cloud.bare_metal:
    label: my web server
    region: ams
    state: absent

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

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

Ключ	Описание
vultr_api dictionary	Ответ от API Vultr с некоторыми дополнениями и изменениями. Возвращается: success
api_endpoint string	Конечная точка, используемая для запросов к API. Возвращается: success Пример: `"https://api.vultr.com/v2"`
api_results_per_page integer	Количество результатов, возвращаемых одним вызовом API. Возвращается: success Пример: `100`
api_retries integer	Максимальное количество повторных попыток для запросов к API. Возвращается: success Пример: `5`
api_retry_max_delay integer	Задержка экспоненциального отката в секундах между повторными попытками, не превышающая это максимальное значение. Возвращается: success Пример: `12`
api_timeout integer	Тайм-аут, используемый для запросов к API. Возвращается: success Пример: `60`
vultr_bare_metal dictionary	Ответ от API Vultr. Возвращается: success
app_id integer	Идентификатор приложения для bare metal-машины. Возвращается: success Пример: `37`
cpu_count integer	Количество ЦП bare metal-машины. Возвращается: success Пример: `1`
date_created string	Дата создания bare metal-машины. Возвращается: success Пример: `"2020-10-10T01:56:20+00:00"`
default_password string	Пароль по умолчанию, назначенный при развертывании. Доступен только в течение десяти минут после развертывания. Возвращается: success Пример: `"examplePassword"`
disk string	Информация о диске bare metal-машины. Возвращается: success Пример: `"2x 240GB SSD"`
enable_ipv6 boolean	Включен ли IPv6. Возвращается: success Пример: `true`
features list / elements=string	Функции bare metal-машины. Возвращается: success Пример: `["ddos_protection", "ipv6", "auto_backups"]`
gateway_v4 string	Шлюз IPv4. Возвращается: success Пример: `"95.179.188.1"`
id string	Идентификатор bare metal-машины. Возвращается: success Пример: `"cb676a46-66fd-4dfb-b839-443f2e6c0b60"`
image_id string	Идентификатор образа bare metal-машины. Возвращается: success Пример: `""`
label string	Метка bare metal-машины. Возвращается: success Пример: `"my bare metal machine"`
mac_address integer	MAC-адрес bare metal-машины. Возвращается: success Пример: `2199756823533`
main_ip string	IPv4-адрес bare metal-машины. Возвращается: success Пример: `"95.179.189.95"`
netmask_v4 string	Маска подсети IPv4 bare metal-машины. Возвращается: success Пример: `"255.255.254.0"`
os string	Операционная система bare metal-машины. Возвращается: success Пример: `"Application"`
os_id integer	Идентификатор операционной системы bare metal-машины. Возвращается: success Пример: `186`
plan string	Тарифный план bare metal-машины. Возвращается: success Пример: `"vbm-4c-32gb"`
power_status string	Состояние питания bare metal-машины. Возвращается: success Пример: `"running"`
ram string	Информация об оперативной памяти bare metal-машины. Возвращается: success Пример: `"32768 MB"`
region string	Регион, в котором развернута bare metal-машина. Возвращается: success Пример: `"ews"`
status string	Состояние развертывания bare metal-машины. Возвращается: success Пример: `"active"`
tags list / elements=string	Теги bare metal-машины. Возвращается: success Пример: `["my-tag"]`
user_data string	Данные пользователя bare metal-машины в кодировке Base64 (cloud-init). Возвращается: success Пример: `"I2Nsb3VkLWNvbmZpZwpwYWNrYWdlczoKICAtIGh0b3AK"`
v6_main_ip string	IPv6-адрес bare metal-машины. Возвращается: success Пример: `""`
v6_network string	Сеть IPv6 bare metal-машины. Возвращается: success Пример: `""`
v6_network_size integer	Размер сети IPv6 bare metal-машины. Возвращается: success Пример: `0`
vpc2s list / elements=string	Список подключенных VPC (VPC 2.0). Возвращается: success
date_created string	Дата создания VPC. Возвращается: success Пример: `"2020-10-10T01:56:20+00:00"`
description string	Описание VPC. Возвращается: success Пример: `"my vpc"`
id string	Идентификатор VPC. Возвращается: success Пример: `"5536d2a4-66fd-4dfb-b839-7672fd5bc116"`
ip_block string	Блок IP-адресов, назначенный VPC. Возвращается: success Пример: `"10.99.0.0"`
prefix_length integer	Количество бит маски подсети в нотации CIDR. Возвращается: success Пример: `24`
region string	Регион, к которому привязана VPC. Возвращается: success Пример: `"ews"`

Авторы

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/vultr/cloud/bare_metal_module.html