derjd.podman

Overview Versions Insights

Podman

Install and configure podman. Valid options for storage.conf can be seen here. Valid options for registries.conf can be seen here.

Requirements

  • Please ensure that you install all collections described in depencency section
  • Please do not use gather_facts: no as it's needed for distinguishing OS distributions

Role Variables

Variable Type Default Description
podman_packages List ["podman"] List of packages to install
podman_packages_state String present State of package to install
podman_socket Bool False Enable docker compatible podman API service
podman_conf_dir String /etc/containers/ Container config directory
podman_storage_conf_file String /etc/containers/storage.conf Path to storage.conf
podman_registries_conf_file String /etc/containers/registries.conf Path to registries.conf
podman_storage_settings Dict {} Settings for storage.conf
podman_registries_settings Dict {} Settings for registries.conf
podman_repo_base_url String See defaults/main.yml libcontainer's repository URL
podman_repo_distro String {{ ansible_distribution }}_{{ ansible_distribution_version }} String containing Distro and version
podman_yum_repo_url String {{ podman_repo_base_url }}{{ ansible_distribution }}_{{ ansible_distribution_major_version }} YUM repo URL
podman_rpm_key String {{ podman_repo_base_url }}{{ podman_repo_distro }}/repodata/repomd.xml.key URL to the RPM key
podman_libseccomp2_backport_releases List ["buster"] List of releases that needs libseccomp2 installed from backports

Dependencies

This role depends on a collection. Currently there is no way of handling these dependencies within roles meta and there won't be any.

  • Galaxy

Install directly ansible-galaxy collection install derjd.general or via requirements.yml:

---

collections:
  - derjd.general

Example Playbook

  • Most basic example
---

- hosts: servers
  become_user: root
  roles:
     - derJD.podman
  • Use zfs as storage driver and let it use a different dataset
---

- hosts: servers
  become_user: root
  vars:
    podman_storage_settings:
      storage:
        driver: zfs
      storage.options.zfs:
        fsname: rpool/podman

  tasks:
    - name: zfs create rpool/podman
      community.general.zfs:
        name: rpool/podman
        state: present
        extra_zfs_properties:
          mountpoint: none

    - include_role: 
         name: derJD.podman
  • Example with many config switches
---

- hosts: servers
  become_user: root
  vars:
    podman_storage_settings:
      storage:
        driver: zfs
      storage.options:
        override_kernel_check: true
      storage.options.thinpool:
        skip_mount_home: false
        fs: ext4
    podman_registries_settings:
      registries.search:
        regestries:
          - docker.io
          - registry.fedoraproject.org
          - quay.io
          - registry.access.redhat.com
          - registry.centos.org
      registries.block:
        registries: []

  roles:
     - derJD.podman

License

BSD

Author Information

derJD

About

Manage podman installation and configuration

role container development
Install
ansible-galaxy install derjd.podman
GitHub repository
3 stars
1 forks
0 open issues
License
Unknown
Downloads
223
Owner