podman

El dominio podman tiene 6 acciones. En la superficie meta se alcanzan todas a través de arcane_podman; en la individual, cada una es una herramienta propia; en la dinámica se ejecutan con arcane_execute_action y el ID canónico.

Resumen

Acción	Título	Tipo
podman.auto_update_run	Run Podman auto-update	destructiva
podman.info	Get Podman info	lectura
podman.kube_down	Tear down kube YAML	destructiva
podman.kube_generate	Generate kube YAML	lectura
podman.kube_play	Play kube YAML	destructiva
podman.status	Get Podman status	lectura

Acciones

podman.auto_update_run

Run Podman auto-update

Run podman auto-update through the REST API or its systemd unit

• Tipo: destructiva — solo cuando dryRun is false or absent; esas llamadas exigen confirm: true, las demás no
• Parámetros obligatorios: ninguno
• Meta-herramienta: arcane_podman con "action": "auto_update_run"
• Herramienta individual: arcane_podman_auto_update_run
• Ruta de Arcane: POST /api/environments/{id}/podman/autoupdate
• ID de operación: run-podman-autoupdate
• Desde: Arcane v2.17.0
• Uso: Runs podman auto-update: containers with the label io.containers.autoupdate=registry (or local) whose image has a newer digest are pulled and restarted through their systemd units. On Podman 6.2+ it runs over the REST API and returns one report per container (dryRun only reports, and rollback, tlsVerify, authfile and filters are passed on). On older Podman it starts podman-auto-update.service on the host and returns the unit’s final state (mode systemd, no reports, and dryRun and the other options are refused with 400). 409 when neither is available (see podman.status autoUpdateMode). Sends Arcane’s update notifications for containers it updated. Needs confirm=true unless dryRun=true (a dry run only reports). Needs podman:autoupdate.
• Acciones relacionadas: podman.status, podman_quadlet.list, updater.run

podman.info

Get Podman info

• Tipo: lectura
• Parámetros obligatorios: ninguno
• Meta-herramienta: arcane_podman con "action": "info"
• Herramienta individual: arcane_podman_info
• Ruta de Arcane: GET /api/environments/{id}/podman/info
• ID de operación: get-podman-info
• Desde: Arcane v2.17.0
• Uso: Podman’s own podman info for the environment: host (arch, kernel, cgroup manager and version, OCI runtime, network backend, security such as rootless and SELinux), store (graph driver, image and container counts), registries and version. 400 on an environment that is not Podman (see podman.status). Needs podman:read.
• Acciones relacionadas: podman.status, system.docker_info

podman.kube_down

Tear down kube YAML

Remove pods and containers created from Kubernetes YAML

• Tipo: destructiva — exige confirm: true
• Parámetros obligatorios: yaml
• Meta-herramienta: arcane_podman con "action": "kube_down"
• Herramienta individual: arcane_podman_kube_down
• Ruta de Arcane: POST /api/environments/{id}/podman/kube/down
• ID de operación: down-podman-kube
• Desde: Arcane v2.17.0
• Uso: Stops and removes the pods and containers a Kubernetes YAML created (pass the same yaml as podman.kube_play), as podman kube down, and force=true also removes the volumes it created. Returns stopReport and rmReport with the pod IDs. Irreversible. Needs podman:kube.
• Acciones relacionadas: podman.kube_play, podman_pod.list, podman_pod.delete

podman.kube_generate

Generate kube YAML

Generate Kubernetes YAML from pods, containers, or volumes

• Tipo: lectura
• Parámetros obligatorios: names
• Meta-herramienta: arcane_podman con "action": "kube_generate"
• Herramienta individual: arcane_podman_kube_generate
• Ruta de Arcane: POST /api/environments/{id}/podman/kube/generate
• ID de operación: generate-podman-kube
• Desde: Arcane v2.17.0
• Uso: Writes Kubernetes YAML for existing pods, containers or volumes (names: their names or IDs, from podman_pod.list or container.list), as podman kube generate. type picks the kind (pod by default, or deployment, daemonset, job) and service=true adds a Service. Returns yaml. Nothing is changed, so it is safe to call to back up a pod or move it with podman.kube_play elsewhere. Needs podman:kube.
• Acciones relacionadas: podman.kube_play, podman_pod.list

podman.kube_play

Play kube YAML

Create pods and containers from Kubernetes YAML

• Tipo: destructiva — solo cuando replace is true; esas llamadas exigen confirm: true, las demás no
• Parámetros obligatorios: yaml
• Meta-herramienta: arcane_podman con "action": "kube_play"
• Herramienta individual: arcane_podman_kube_play
• Ruta de Arcane: POST /api/environments/{id}/podman/kube/play
• ID de operación: play-podman-kube
• Desde: Arcane v2.17.0
• Uso: Creates pods (and their containers, volumes and config maps) from Kubernetes YAML, as podman kube play: yaml is the manifest text, start (default true) starts them, networks attaches them, and replace=true first removes existing pods of the same names: only that needs confirm=true (without replace, a name already in use fails instead of being replaced). Returns pods (id, containers, logs, containerErrors), volumes and serviceContainerId. Images are pulled when missing, so give fully qualified names (docker.io/library/…) unless the host’s registries.conf resolves short ones. Needs podman:kube.
• Acciones relacionadas: podman.kube_down, podman.kube_generate, podman_pod.list, podman_pod.get

podman.status

Get Podman status

Report whether the environment runs Podman and which Podman features it supports

• Tipo: lectura
• Parámetros obligatorios: ninguno
• Meta-herramienta: arcane_podman con "action": "status"
• Herramienta individual: arcane_podman_status
• Ruta de Arcane: GET /api/environments/{id}/podman/status
• ID de operación: get-podman-status
• Desde: Arcane v2.17.0
• Uso: Whether the environment’s engine is Podman, and what Arcane can do with it: detected, version, apiVersion, rootless, quadletsSupported (Podman 5.8+), quadletAppsSupported (6.1+), autoUpdateMode (rest on Podman 6.2+, systemd when Arcane reaches the host’s systemd bus, else unavailable) and systemdAvailable with systemdReason. Always answers 200: on a Docker environment detected is false and every other podman, podman_pod, podman_quadlet and podman_secret action fails with 400 ‘Podman was not detected on this environment’. Check it first. Needs podman:read.
• Acciones relacionadas: podman.info, podman_pod.list, podman_quadlet.list, podman.auto_update_run