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

Примечание

Этот плагин является частью коллекции community.general (версия 2.0.1).

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

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

Введено в версии 0.2.0: of community.general

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

Описание

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

Требования

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

python >= 2.6
packet-python >= 1.35

Параметры

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

Примеры

# 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) <tom.to.the.k@gmail.com>
Nurfet Becirevic (@nurfet-becirevic) <nurfet.becirevic@gmail.com>

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