Модуль community.general.packet_ip_subnet – Назначение IP-подсети для сервера bare metal

Примечание

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

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

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

Для использования в playbook, укажите: community.general.packet_ip_subnet.

Новое в community.general 0.2.0

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

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

Назначить или отменить назначение IPv4 или IPv6 подсетей устройству в хосте Packet.
IPv4 подсети должны быть из уже зарезервированного блока.
IPv6 подсети должны быть из публично маршрутизируемого блока /56 вашего проекта.
См. https://support.packet.com/kb/articles/elastic-ips для получения дополнительной информации о резервировании блоков IP.

Требования

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

packet-python >= 1.35

Параметры

Параметр	Комментарии
auth_token string	Токен API Packet. Вы также можете указать его в переменной окружения `PACKET_API_TOKEN`.
cidr aliases: name string / required	IPv4 или IPv6 подсеть, которой вы хотите управлять. Она должна быть из зарезервированного блока для вашего проекта в Packet Host.
device_count integer	Количество устройств для получения из проекта. Максимально допустимое значение – 1000. См. https://www.packet.com/developers/api/#retrieve-all-devices-of-a-project для получения дополнительной информации. Значение по умолчанию: `100`
device_id string	UUID устройства, которому нужно назначить/с которого нужно удалить подсеть.
hostname string	Имя хоста устройства, которому нужно назначить/с которого нужно удалить подсеть.
project_id string	UUID проекта устройства, которому нужно назначить/с которого нужно удалить подсеть.
state string	Требуемое состояние IP-подсети на указанном устройстве. С `state=present`, вы должны указать либо `hostname` либо `device_id`. Подсеть с заданным CIDR будет затем назначена указанному устройству. С `state=absent`, вы можете указать либо `hostname` либо `device_id`. Подсеть будет удалена с указанных устройств. Если вы оставите оба `hostname` и `device_id` пустыми, подсеть будет удалена с любого устройства, которому она назначена. Варианты: `"present"` ← (по умолчанию) `"absent"`

Атрибуты

Атрибут	Поддержка	Описание
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 it to the auth_token parameter of the module instead.

- name: Create 1 device and assign an arbitrary public IPv4 subnet to it
  hosts: localhost
  tasks:

  - packet_device:
      project_id: 89b497ee-5afc-420a-8fb5-56984898f4df
      hostnames: myserver
      operating_system: ubuntu_16_04
      plan: baremetal_0
      facility: sjc1
      state: active

# Pick an IPv4 address from a block allocated to your project.

  - community.general.packet_ip_subnet:
      project_id: 89b497ee-5afc-420a-8fb5-56984898f4df
      hostname: myserver
      cidr: "147.75.201.78/32"

# Release IP address 147.75.201.78

- name: Unassign IP address from any device in your project
  hosts: localhost
  tasks:
  - community.general.packet_ip_subnet:
      project_id: 89b497ee-5afc-420a-8fb5-56984898f4df
      cidr: "147.75.201.78/32"
      state: absent

Значения возврата

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

Ключ	Описание
changed boolean	Истинно, если какие-либо назначения IP-адресов были изменены (созданы или удалены). Возвращено: успех Пример: `true`
device_id string	UUID устройства, связанного с указанным IP-адресом. Возвращено: успех
subnet dictionary	Словарь с данными об обработанной IP-подсети. Возвращено: успех Пример: `{"address": "147.75.90.241", "address_family": 4, "assigned_to": {"href": "/devices/61f9aa5e-0530-47f5-97c2-113828e61ed0"}, "cidr": 31, "created_at": "2017-08-07T15:15:30Z", "enabled": true, "gateway": "147.75.90.240", "href": "/ips/31eda960-0a16-4c0f-b196-f3dc4928529f", "id": "1eda960-0a16-4c0f-b196-f3dc4928529f", "manageable": true, "management": true, "netmask": "255.255.255.254", "network": "147.75.90.240", "public": true}`

Авторы

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_ip_subnet_module.html