containers.podman.podman_search module – Search for remote images using podman¶
Note
This module is part of the containers.podman collection (version 1.16.2).
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_search.
Synopsis¶
- Search for remote images using - podman
Parameters¶
| Parameter | Comments | 
|---|---|
| Path to  Default:  | |
| Limit the number of image results returned from the search (per image registry) Default:  | |
| Whether or not to return the list of tags associated with each image Choices: 
 | |
| The search term to look for. Will search all default registries unless a registry is defined in the search term. | 
Notes¶
Note
- Podman may required elevated privileges in order to run properly. 
Examples¶
- name: Search for any rhel images
  containers.podman.podman_search:
    term: "rhel"
    limit: 3
- name: Gather info on a specific remote image
  containers.podman.podman_search:
    term: "myimageregistry.com/ansible-automation-platform/ee-minimal-rhel8"
- name: Gather tag info on a known remote image
  containers.podman.podman_search:
    term: "myimageregistry.com/ansible-automation-platform/ee-minimal-rhel8"
    list_tags: True
Return Values¶
Common return values are documented here, the following are the fields unique to this module:
| Key | Description | 
|---|---|
| info from all or specified images Returned: always Sample:  |