inmanta-module-podman

This package is an adapter that is meant to be used with the inmanta orchestrator: https://docs.inmanta.com

Features

This module allows to manage podman resources, on a unix host. It contains the following resources:

podman::Network: to manage a podman network (subnets, routes, dns, driver, labels, options, ...).
podman::NetworkDiscovery: to discover existing podman networks owned by a user on a host.
podman::Pod: to manage a podman pod, including its networking, port publishing, id mapping and shared resources.
podman::Container: to manage a podman container (image, command, environment, volumes, networks, healthcheck, security label, resource limits, auto-update, ...).
podman::Image, podman::ImageFromRegistry and podman::ImageFromSource: to make sure a container image is present on a host, either pulled from a registry or built from a Containerfile.
podman::ImageDiscovery: to discover existing container images owned by a user on a host.
podman::AutoUpdate: to configure the podman auto-update service for a given user.
podman::services::SystemdContainer, podman::services::SystemdPod and podman::services::SystemdAutoUpdate: to wrap a container, a pod or the auto-update service into a systemd service. These services can either be generated as plain systemd unit files (calling the podman cli) or as quadlet unit files.

Example

The following example shows how to run a container as a systemd service, using a quadlet unit file. The container is a simple nginx web server, exposing its port 80 on the host port 8080.

import mitogen
import podman
import podman::container_like
import podman::services
import std

host = std::Host(
    name="localhost",
    os=std::linux,
    via=mitogen::Local(),
)

# Make sure the container image is present on the host
image = podman::ImageFromRegistry(
    host=host,
    name="docker.io/library/nginx:latest",
)

# Define the container
web = podman::Container(
    host=host,
    name="nginx-web",
    image=image.name,
    publish=[
        podman::container_like::Publish(host_port="8080", container_port="80"),
    ],
)

# Wrap the container into a systemd service, using a quadlet unit file
podman::services::SystemdContainer(
    container=web,
    state="running",
    enabled=true,
    systemd_unit_dir="/etc/systemd/system",
    systemd_container_dir="/etc/containers/systemd",
    quadlet=true,
)

Find more examples in the tests folder of this module!

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

inmanta_module_podman-1.12.0.tar.gz (36.1 kB view details)

Uploaded Jul 11, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

inmanta_module_podman-1.12.0-py3-none-any.whl (43.4 kB view details)

Uploaded Jul 11, 2026 Python 3

File details

Details for the file inmanta_module_podman-1.12.0.tar.gz.

File metadata

Download URL: inmanta_module_podman-1.12.0.tar.gz
Upload date: Jul 11, 2026
Size: 36.1 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for inmanta_module_podman-1.12.0.tar.gz
Algorithm	Hash digest
SHA256	`5ba3c0399365999eb5cf109fadc0a777258805baa9604c627500791a5ef48f43`
MD5	`fce4a62f41b518523b4698406e48e963`
BLAKE2b-256	`cf831f150defc658bfd59d9e91f4c7c9e1e4aa212825361b351eb1dcfb54002a`

See more details on using hashes here.

Provenance

The following attestation bundles were made for inmanta_module_podman-1.12.0.tar.gz:

Publisher: continuous-delivery.yml on edvgui/inmanta-module-podman

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: inmanta_module_podman-1.12.0.tar.gz
- Subject digest: 5ba3c0399365999eb5cf109fadc0a777258805baa9604c627500791a5ef48f43
- Sigstore transparency entry: 2143179982
- Sigstore integration time: Jul 11, 2026
Source repository:
- Permalink: edvgui/inmanta-module-podman@99a8b610f682c489e07341ca97011e470e36a692
- Branch / Tag: refs/tags/1.12.0
- Owner: https://github.com/edvgui
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: continuous-delivery.yml@99a8b610f682c489e07341ca97011e470e36a692
- Trigger Event: push