/ home / community / community.general / 3.8.10 / module / smartos_image_info

community.general.smartos_image_info (3.8.10) — module

Get SmartOS image details.

Authors: Adam Števko (@xen0l)

Install collection

Install with ansible-galaxy collection install community.general:==3.8.10

Add to requirements.yml

  collections:
    - name: community.general
      version: 3.8.10

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(community.general.smartos_image_info) module no longer returns C(ansible_facts)!

Usage examples

Scanned by Steampunk Spotter

- name: Return information about all installed images
  community.general.smartos_image_info:
  register: result

Scanned by Steampunk Spotter

- name: Return all private active Linux images
  community.general.smartos_image_info:
    filters: "os=linux state=active public=false"
  register: result

Scanned by Steampunk Spotter

- name: Show, how many clones does every image have
  community.general.smartos_image_info:
  register: result

Scanned by Steampunk Spotter

- name: Print information
  ansible.builtin.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 }}"

Scanned by Steampunk Spotter

- name: Print information
  ansible.builtin.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'.
    type: str