/ansible-role-srv_podman

An Ansible Role to install and configure podman on a host.

Primary LanguagePythonBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

Github (tag) Github (license) Github (issues) Github (pull requests)

Travis (com)

Ansible (min. version) Ansible (platforms) Ansible (tags)

Ansible Role: srv_podman

An Ansible Role to install and configure podman on a host.

Motivation

Podman is a daemonless container engine for developing, managing, and running OCI Containers on your Linux System.

Description

This role installs podman.

Requirements

Used Modules:

Installation

Install from Ansible Galaxy

ansible-galaxy install while_true_do.srv_podman

Install from Github

git clone https://github.com/while-true-do/ansible-role-srv_podman.git while_true_do.srv_podman

Usage

Role Variables

---
# defaults file for while_true_do.srv_podman

## Package Management
wtd_srv_podman_package:
  - podman
# State can be present|latest|absent
wtd_srv_podman_package_state: "present"

# podman-docker Packages
wtd_srv_podman_docker_package:
  - podman-docker
# State can be present|latest|absent
wtd_srv_podman_docker_package_state: "present"
# Podman conflicts with docker, you can choose what happens, if docker
# is already installed with replace|skip.
wtd_srv_podman_docker_package_conflict: "skip"

Example Playbook

Running Ansible Roles can be done in a playbook.

Simple

---
- hosts: all
  roles:
    - role: while_true_do.srv_podman

Force Removal of docker and installation of podman-docker

---
- hosts: all
  roles:
    - role: while_true_do.srv_podman
      wtd_srv_podman_docker_package_conflict: "replace"

Known Issues

  1. RedHat Testing is currently not possible in public, due to limitations in subscriptions.
  2. Some services and features cannot be tested properly, due to limitations in docker.

Testing

Most of the "generic" tests are located in the Test Library.

Ansible specific testing is done with Molecule.

Infrastructure testing is done with testinfra.

Automated testing is done with Travis CI.

Contribute

Thank you so much for considering to contribute. We are very happy, when somebody is joining the hard work. Please fell free to open Bugs, Feature Requests or Pull Requests after reading the Contribution Guideline.

See who has contributed already in the kudos.txt.

License

This work is licensed under a BSD-3-Clause License.

Contact