ansible.builtin._smartos_image_facts (v2.9.27) — module

Get SmartOS image details.

| "added in version" 2.2 of ansible.builtin"

Authors: Adam Števko (@xen0l)

preview | supported by community

Install Ansible via pip

Install with pip install ansible==2.9.27

Description

Retrieve information about all installed images on SmartOS.

This module was called C(smartos_image_facts) before Ansible 2.9, returning C(ansible_facts). Note that the M(smartos_image_info) module no longer returns C(ansible_facts)!

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
# Return information about all installed images.
- smartos_image_info:
  register: result
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
# Return all private active Linux images.
- smartos_image_info: filters="os=linux state=active public=false"
  register: result
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
# Show, how many clones does every image have.
- smartos_image_info:
  register: result
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- debug: msg="{{ result.smartos_images[item]['name'] }}-{{ result.smartos_images[item]['version'] }}
            has {{ result.smartos_images[item]['clones'] }} VM(s)"
  with_items: "{{ result.smartos_images.keys() | list }}"
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
# When the module is called as smartos_image_facts, return values are published
# in ansible_facts['smartos_images'] and can be used as follows.
# Note that this is deprecated and will stop working in Ansible 2.13.
- debug: msg="{{ smartos_images[item]['name'] }}-{{ smartos_images[item]['version'] }}
            has {{ smartos_images[item]['clones'] }} VM(s)"
  with_items: "{{ smartos_images.keys() | list }}"

Inputs

    
filters:
    description:
    - Criteria for selecting image. Can be any value from image manifest and 'published_date',
      'published', 'source', 'clones', and 'size'. More information can be found at U(https://smartos.org/man/1m/imgadm)
      under 'imgadm list'.