Add support to interact with a local podman installation

* Add support to interact with a local podman installation
* Fix `None` returned for `gardenlinux.oci.Podman.pull()`
* Add more descriptive `gl-oci` tool description.

Signed-off-by: Tobias Wolf <wolf@b1-systems.de>
On-behalf-of: SAP <tobias.wolf@sap.com>

Author: NotTheEvilOne

poetry.lock

@@ -16,6 +16,7 @@ cryptography = "^46.0.3"
 jsonschema = "^4.26.0"
 networkx = "^3.6"
 oras = "^0.2.38"
+podman = "^5.6.0"
 pygit2 = "^1.19.1"
 pygments = "^2.19.2"
 PyGithub = "^2.8.1"
@@ -24,12 +25,12 @@ gitpython = "^3.1.45"
 
 [tool.poetry.group.dev.dependencies]
 bandit = "^1.9.3"
+isort = "^7.0.0"
 moto = "^5.1.20"
 pre-commit = "^4.5.1"
 python-dotenv = "^1.2.1"
 pytest = "^9.0.2"
 pytest-cov = "^7.0.0"
-isort = "^7.0.0"
 requests-mock = "^1.12.1"
 mypy = "1.18.2"
 types-click = "^7.1.8"

pyproject.toml

@@ -166,6 +166,8 @@
 GARDENLINUX_GITHUB_RELEASE_BUCKET_NAME = "gardenlinux-github-releases"
 GLVD_BASE_URL = "https://security.gardenlinux.org/v1"
 
+PODMAN_CONNECTION_MAX_IDLE_SECONDS = 3
+
 # https://github.com/gardenlinux/gardenlinux/issues/3044
 # Empty string is the 'legacy' variant with traditional root fs and still needed/supported
 IMAGE_VARIANTS = ["", "_usi", "_tpm2_trustedboot"]

src/gardenlinux/constants.py

@@ -9,5 +9,15 @@
 from .index import Index
 from .layer import Layer
 from .manifest import Manifest
+from .podman import Podman
+from .podman_context import PodmanContext
 
-__all__ = ["Container", "ImageManifest", "Index", "Layer", "Manifest"]
+__all__ = [
+    "Container",
+    "ImageManifest",
+    "Index",
+    "Layer",
+    "Manifest",
+    "Podman",
+    "PodmanContext",
+]