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

Note

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

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. You need further requirements to be able to use this module, see Requirements for details.

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

New in containers.podman 1.4.0

Synopsis

  • Manage groups of podman containers

Requirements

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

  • podman

Parameters

Parameter

Comments

containers

list / elements=dictionary / required

List of dictionaries with data for running containers for podman_container module.

debug

boolean

Return additional information which can be helpful for investigations.

Choices:

  • false ← (default)

  • true

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.10-alpine
        command: python -V

Authors

  • Sagi Shnaidman (@sshnaidm)