community.digitalocean.digital_ocean_image_info – Сбор информации об изображениях DigitalOcean
Примечание
Этот плагин входит в коллекцию community.digitalocean (версия 1.0.0).
Для его установки используйте: ansible-galaxy collection install community.digitalocean.
Чтобы использовать его в книге задач, укажите: community.digitalocean.digital_ocean_image_info.
Обзор
- Этот модуль может использоваться для сбора информации об изображениях, предоставленных DigitalOcean.
- Эти изображения могут быть типами
distribution,applicationиprivate. - Этот модуль назывался
digital_ocean_image_factsдо Ansible 2.9. Способ использования не изменился.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- python >= 2.6
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| image_type строка |
| Указывает тип информации об изображении, которую необходимо получить. Если установлено значение application, то собирается информация о всех изображениях типа application.Если установлено значение distribution, то собирается информация обо всех изображениях типа distribution.Если установлено значение private, то собирается информация обо всех частных изображениях.Если не установлено ни одно из вышеперечисленных значений, то собирается информация обо всех изображениях. |
| oauth_token строка | Токен DigitalOcean OAuth. Существует несколько других переменных среды, которые можно использовать для предоставления этого значения. Например, - 'DO_API_TOKEN', 'DO_API_KEY', 'DO_OAUTH_TOKEN' и 'OAUTH_TOKEN' Псевдонимы: api_token | |
| timeout целое число | Значение по умолчанию: 30 | Время ожидания в секундах, используемое для опроса API DigitalOcean. |
| validate_certs логическое значение |
| Если установлено значение no, сертификаты SSL не будут проверены.Это следует устанавливать только в случае использования на сайтах, контролируемых лично, с использованием самозаверяющих сертификатов. |
Примеры
- name: Gather information about all images
community.digitalocean.digital_ocean_image_info:
image_type: all
oauth_token: "{{ oauth_token }}"
- name: Gather information about application images
community.digitalocean.digital_ocean_image_info:
image_type: application
oauth_token: "{{ oauth_token }}"
- name: Gather information about distribution images
community.digitalocean.digital_ocean_image_info:
image_type: distribution
oauth_token: "{{ oauth_token }}"
- name: Get distribution about image with slug coreos-beta
community.digitalocean.digital_ocean_image_info:
register: resp_out
- set_fact:
distribution_name: "{{ item.distribution }}"
loop: "{{ resp_out.data | community.general.json_query(name) }}"
vars:
name: "[?slug=='coreos-beta']"
- debug:
var: distribution_name
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| data список / элементы=строка | успех | Информация об изображении DigitalOcean Пример: [{'created_at': '2018-02-02T07:11:43Z', 'distribution': 'CoreOS', 'id': 31434061, 'min_disk_size': 20, 'name': '1662.1.0 (beta)', 'public': True, 'regions': ['nyc1', 'sfo1', 'nyc2', 'ams2', 'sgp1', 'lon1', 'nyc3', 'ams3', 'fra1', 'tor1', 'sfo2', 'blr1'], 'size_gigabytes': 0.42, 'slug': 'coreos-beta', 'type': 'snapshot'}] |
Авторы
- Abhijeet Kasurde (@Akasurde)
© 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/digitalocean/digital_ocean_image_info_module.html