W3cubDocs

/Ansible

containers.podman.podman_containers – Manage podman containers in a batch

Note

This plugin is part of the containers.podman collection (version 1.8.1).

You might already have this collection installed if you are using the ansible package. 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_containers.

New in version 1.4.0: of containers.podman

Synopsis

  • Manage groups of podman containers

Requirements

The below requirements are needed on the host that executes this module.

  • podman

Parameters

Parameter Choices/Defaults Comments
containers
list / elements=dictionary / required
List of dictionaries with data for running containers for podman_container module.
debug
boolean
    Choices:
  • no
  • yes
Return additional information which can be helpful for investigations.

Examples

- name: Run three containers at once
  podman_containers:
    containers:
      - name: alpine
        image: alpine
        command: sleep 1d
      - name: web
        image: nginx
      - name: test
        image: python:3-alpine
        command: python -V

Authors

  • Sagi Shnaidman (@sshnaidm)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/containers/podman/podman_containers_module.html