containers.podman.podman_image_info module – Gather info about images using podman

Note

This module is part of the containers.podman collection (version 1.18.0).

It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install containers.podman.

To use it in a playbook, specify: containers.podman.podman_image_info.

Synopsis

  • Gather info about images using podman

Parameters

Parameter

Comments

executable

string

Path to podman executable if it is not in the $PATH on the machine running podman

Default: "podman"

name

list / elements=string

List of tags or UID to gather info about. If no name is given return info about all images.

Notes

Note

  • Podman may required elevated privileges in order to run properly.

Examples

- name: Gather info for all images
  containers.podman.podman_image_info:

- name: Gather info on a specific image
  containers.podman.podman_image_info:
    name: nginx

- name: Gather info on several images
  containers.podman.podman_image_info:
    name:
      - redis
      - quay.io/bitnami/wildfly

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key

Description

images

list / elements=string

info from all or specified images

Returned: always

Sample: [{"Annotations": {}, "Architecture": "amd64", "Author": "", "Comment": "", "Config": {"Cmd": ["/bin/sh"], "Env": ["PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"]}, "Created": "2023-06-14T20:42:13.993588153Z", "Digest": "sha256:3362f865019db5f14ac5154cb0db2c3741ad1cce0416045be422ad4de441b081", "GraphDriver": {"Data": {"UpperDir": "/home/podman/.local/share/containers/storage/overlay/579b.../diff", "WorkDir": "/home/podman/.local/share/containers/storage/overlay/579b.../work"}, "Name": "overlay"}, "History": [{"created": "2023-06-14T20:42:13.893052319Z", "created_by": "/bin/sh -c #(nop) ADD file:234234234 in / "}, {"created": "2023-06-14T20:42:13.993588153Z", "created_by": "/bin/sh -c #(nop)  CMD [\"/bin/sh\"]", "empty_layer": true}], "Id": "029bed813f07be84fae0344cbf8076ced5ea3c929d5f064ba617ac7d8c610a4b", "Labels": null, "ManifestType": "application/vnd.docker.distribution.manifest.v2+json", "NamesHistory": ["quay.io/podman/alpine:3.15", "quay.io/podman/alpine:3.15", "docker.io/library/alpine:3.15"], "Os": "linux", "Parent": "", "RepoDigests": ["docker.io/library/alpine@sha256:3362f865019db5f14ac5154cb0db2c3741ad1cce0416045be422ad4de441b081", "docker.io/library/alpine@sha256:c58a2fce65cb3487f965d2fb08eec4843384dbe29264f427b665421db1aabef2", "quay.io/podman/alpine@sha256:3362f865019db5f14ac5154cb0db2c3741ad1cce0416045be422ad4de441b081", "quay.io/podman/alpine@sha256:c58a2fce65cb3487f965d2fb08eec4843384dbe29264f427b665421db1aabef2", "quay.io/podman/alpine@sha256:3362f865019db5f14ac5154cb0db2c3741ad1cce0416045be422ad4de441b081", "quay.io/podman/alpine@sha256:c58a2fce65cb3487f965d2fb08eec4843384dbe29264f427b665421db1aabef2"], "RepoTags": ["docker.io/library/alpine:3.15", "quay.io/podman/alpine:3.15", "quay.io/podman/alpine:3.15"], "RootFS": {"Layers": ["sha256:579b..."], "Type": "layers"}, "Size": 11745350, "User": "", "Version": "20.10.23", "VirtualSize": 11745350}]

Authors

  • Sam Doran (@samdoran)