Watch

mirror of https://github.com/containers/ansible-podman synced 2026-07-21 14:13:56 +00:00

No description

Python 100%

Find a file

Repository files (latest commit first)
Filename	Latest commit message	Latest commit date
Daniel J Walsh b73aadf81e Merge pull request #10 from TomSweeneyRedHat/sec Add Security Policy		2020-05-11 10:48:30 -04:00
examples	Changed the task name to 'Remove image'	2019-07-25 20:38:24 -04:00
modules	Adding documentation to the file	2019-07-25 09:43:04 -04:00
tests	Adding testcase for podman pull image	2019-06-23 18:03:44 -04:00
CODE-OF-CONDUCT.md	Add Code of Conduct	2020-02-08 15:21:31 -05:00
LICENSE	Add LICENSE file	2019-06-22 14:28:18 -04:00
README.md	Update README.md	2019-06-25 17:07:04 -04:00
SECURITY.md	Add Security Policy	2020-05-09 13:46:28 -04:00

README.md

Ansible Module for Podman

This module allows Ansible to use Podman to manage container images.

Requirements

Python 3.6+
Ansible 2.8

Installation

Install Podman
Install Python-podman library on the host you will be running ansible playbooks.

git clone git@github.com:containers/python-podman.git
cd ~/python-podman
python3 setup.py clean -a && python3 setup.py sdist bdist
python3 setup.py install --user

Copy podman_images_v2.py to your directory library

../podman_test/
├── library
│   └── podman_image_v2.py
└── pull_image.yml

Usage Examples

This module will pull the fedora latest image from docker hub.

hosts: localhost
  tasks:
   - name: Pull an image
     podman_image_v2:
       name: fedora
     register: result

   - debug: var=result

Parameters

parameter	required	default	choices	comments
name	yes			Set image name
tag	no	latest		Set the tag of the image
pull	no	true		Set the pull option
force	no	false		Set to pull an image forcefully
state	no	present	present build absent	Set the state of the image