Модуль community.general.packet_volume_attachment – Подключение/отключение тома к устройству в хосте Packet

Примечание

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

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

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

Для использования в плейбуке укажите: community.general.packet_volume_attachment.

Новая в community.general 0.2.0

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

Описание

Подключение/отключение тома к устройству в хосте Packet.
Документация API находится по адресу https://www.packet.com/developers/api/volumes/.
Этот модуль создает маршрут подключения в API Packet. Для обнаружения блочных устройств на сервере необходимо выполнить скрипты подключения, как описано в https://help.packet.net/technical/storage/packet-block-storage-linux.

Требования

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

packet-python >= 1.35

Параметры

Параметр	Комментарии
auth_token строка	Токен API Packet. Также можно указать его в переменной среды `PACKET_API_TOKEN`.
device строка	Селектор устройства. Может быть UUID устройства или имя хоста. Примеры значений: 98a14f7a-3d27-4478-b7cf-35b5670523f3, «мое устройство»
project_id строка / обязательно	UUID проекта, к которому относятся устройство и том.
state строка	Указывает желаемое состояние подключения. Варианты: `"present"` ← (по умолчанию) `"absent"`
volume строка / обязательно	Селектор тома. Может быть UUID, сгенерированным API именем тома или строкой пользовательского описания. Примеры значений: 4a347482-b546-4f67-8300-fb5018ef0c5, volume-4a347482, «мой том»

Атрибуты

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

Примеры

# All the examples assume that you have your Packet API token in env var PACKET_API_TOKEN.
# You can also pass the api token in module param auth_token.

- hosts: localhost

  vars:
    volname: testvol
    devname: testdev
    project_id: 52000fb2-ee46-4673-93a8-de2c2bdba33b

  tasks:
    - name: Create volume
      packet_volume:
        description: "{{ volname }}"
        project_id: "{{ project_id }}"
        facility: ewr1
        plan: storage_1
        state: present
        size: 10
        snapshot_policy:
          snapshot_count: 10
          snapshot_frequency: 1day

    - name: Create a device
      packet_device:
        project_id: "{{ project_id }}"
        hostnames: "{{ devname }}"
        operating_system: ubuntu_16_04
        plan: baremetal_0
        facility: ewr1
        state: present

    - name: Attach testvol to testdev
      community.general.packet_volume_attachment:
        project_id: "{{ project_id }}"
        volume: "{{ volname }}"
        device: "{{ devname }}"

    - name: Detach testvol from testdev
      community.general.packet_volume_attachment:
        project_id: "{{ project_id }}"
        volume: "{{ volname }}"
        device: "{{ devname }}"
        state: absent

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

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

Ключ	Описание
device_id строка	UUID устройства, на который обращается модуль. Возвращается при: успешном выполнении
volume_id строка	UUID тома, на который обращается модуль. Возвращается при: успешном выполнении

Авторы

Tomas Karasek (@t0mk)
Nurfet Becirevic (@nurfet-becirevic)

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

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