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, то собирается информация о всех изображениях типа 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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/digitalocean/digital_ocean_image_info_module.html