Skip to main content

inmanta-module-podman

pypi version build status

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:

  1. podman::Network: to manage a podman network (subnets, routes, dns, driver, labels, options, ...).
  2. podman::NetworkDiscovery: to discover existing podman networks owned by a user on a host.
  3. podman::Pod: to manage a podman pod, including its networking, port publishing, id mapping and shared resources.
  4. podman::Container: to manage a podman container (image, command, environment, volumes, networks, healthcheck, security label, resource limits, auto-update, ...).
  5. 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.
  6. podman::ImageDiscovery: to discover existing container images owned by a user on a host.
  7. podman::AutoUpdate: to configure the podman auto-update service for a given user.
  8. 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.13.0.tar.gz (37.0 kB view details)

Uploaded Source

Built Distribution

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

inmanta_module_podman-1.13.0-py3-none-any.whl (43.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: inmanta_module_podman-1.13.0.tar.gz
  • Upload date:
  • Size: 37.0 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.13.0.tar.gz
Algorithm Hash digest
SHA256 c9e4b04eff4e2e2651cb635683645f6a1648a0e79dc76d5bf96f8d473da765a7
MD5 5b8c89c2ec400ba8356978f6d48c042c
BLAKE2b-256 8bb70010bd159acecfcddc21f50cb21d75443e919622c3b0e8f9c87bcf50d189

See more details on using hashes here.

Provenance

The following attestation bundles were made for inmanta_module_podman-1.13.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.

File details

Details for the file inmanta_module_podman-1.13.0-py3-none-any.whl.

File metadata

File hashes

Hashes for inmanta_module_podman-1.13.0-py3-none-any.whl
Algorithm Hash digest
SHA256 a70231a23931bb4f663da875add015aa810bd5a40267f581252a4f850a44b080
MD5 76c707177936557b6cf8b52e6f65c59a
BLAKE2b-256 8bde3505df1fbbddf7cad7a907d722f49dbc9aeb223786cabeafef86d2e715ad

See more details on using hashes here.

Provenance

The following attestation bundles were made for inmanta_module_podman-1.13.0-py3-none-any.whl:

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.

Release history Release notifications | RSS feed

1.13.1

2 files

This release

1.13.0 This release

2 files

1.12.0

2 files

1.11.3

2 files

1.11.2

2 files

1.11.1

2 files

1.11.0

2 files

1.10.1

2 files

1.10.0

2 files

1.9.0

2 files

1.8.1

2 files

1.8.0

2 files

1.7.0

2 files

1.6.0

2 files

1.5.1

2 files

1.5.0

2 files

1.4.1

2 files

1.4.0

2 files

1.3.0

1 file

1.2.0

1 file

1.1.0

1 file

1.0.1

1 file

1.0.0

1 file

0.7.1

1 file

0.7.0

1 file

0.6.0

1 file

0.5.0

1 file

0.4.2

1 file

0.4.1

1 file

0.4.0

1 file

0.3.1

1 file

0.3.0

1 file

0.2.0

1 file

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page