podman_quadlet

El dominio podman_quadlet tiene 7 acciones. En la superficie meta se alcanzan todas a través de arcane_podman_quadlet; 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_quadlet.create	Install quadlet	escritura
podman_quadlet.delete	Remove quadlet	destructiva
podman_quadlet.file_get	Get quadlet file	lectura
podman_quadlet.get	Get quadlet	lectura
podman_quadlet.lifecycle	Run quadlet lifecycle action	destructiva
podman_quadlet.list	List quadlets	lectura
podman_quadlet.update	Update quadlet	destructiva

Acciones

podman_quadlet.create

Install quadlet

• Tipo: escritura
• Parámetros obligatorios: content, name
• Meta-herramienta: arcane_podman_quadlet con "action": "create"
• Herramienta individual: arcane_podman_quadlet_create
• Ruta de Arcane: POST /api/environments/{id}/podman/quadlets
• ID de operación: install-podman-quadlet
• Desde: Arcane v2.17.0
• Uso: Installs a quadlet file, as podman quadlet install: name includes the type extension (.container, .pod, .kube, .network, .volume, .image, .build or .artifact, anything else is refused with 400), content is the unit text ([Container] Image=…, Exec=…, [Install] WantedBy=default.target to start at boot), extraFiles go beside it, and app groups it into an application (Podman 6.1+). systemd is reloaded but the unit is not started: use podman_quadlet.lifecycle start. Returns installedQuadlets (source to installed path) and quadletErrors. Needs podman:quadlets.
• Acciones relacionadas: podman_quadlet.lifecycle, podman_quadlet.get, podman_quadlet.list, podman_quadlet.update

podman_quadlet.delete

Remove quadlet

• Tipo: destructiva — exige confirm: true
• Parámetros obligatorios: name
• Meta-herramienta: arcane_podman_quadlet con "action": "delete"
• Herramienta individual: arcane_podman_quadlet_delete
• Ruta de Arcane: DELETE /api/environments/{id}/podman/quadlets/{name}
• ID de operación: delete-podman-quadlet
• Desde: Arcane v2.17.0
• Uso: Removes a quadlet (name from podman_quadlet.list), as podman quadlet rm --force: its unit is stopped (which removes a .container quadlet’s container and anonymous volumes) and the file deleted. Returns removed and errors (a failure answers 409 with the reason). Images and named volumes stay. Needs podman:quadlets.
• Acciones relacionadas: podman_quadlet.list, podman_quadlet.lifecycle

podman_quadlet.file_get

Get quadlet file

• Tipo: lectura
• Parámetros obligatorios: name
• Meta-herramienta: arcane_podman_quadlet con "action": "file_get"
• Herramienta individual: arcane_podman_quadlet_file_get
• Ruta de Arcane: GET /api/environments/{id}/podman/quadlets/{name}/file
• ID de operación: get-podman-quadlet-file
• Desde: Arcane v2.17.0
• Uso: The text of a quadlet file (name from podman_quadlet.list), to read or edit before podman_quadlet.update. Needs podman:read.
• Acciones relacionadas: podman_quadlet.update, podman_quadlet.get

podman_quadlet.get

Get quadlet

Get a quadlet with its unit status and backing containers

• Tipo: lectura
• Parámetros obligatorios: name
• Meta-herramienta: arcane_podman_quadlet con "action": "get"
• Herramienta individual: arcane_podman_quadlet_get
• Ruta de Arcane: GET /api/environments/{id}/podman/quadlets/{name}
• ID de operación: get-podman-quadlet
• Desde: Arcane v2.17.0
• Uso: One quadlet by its file name (name from podman_quadlet.list, e.g. web.container) with its systemd unitStatus (activeState, subState) and the containers its unit runs. Not found fails with 404. Needs podman:read.
• Acciones relacionadas: podman_quadlet.file_get, podman_quadlet.lifecycle, podman_quadlet.list

podman_quadlet.lifecycle

Run quadlet lifecycle action

Start, stop, or restart the quadlet’s systemd unit

• Tipo: destructiva — solo cuando action is stop or restart; esas llamadas exigen confirm: true, las demás no
• Parámetros obligatorios: name, action
• Meta-herramienta: arcane_podman_quadlet con "action": "lifecycle"
• Herramienta individual: arcane_podman_quadlet_lifecycle
• Ruta de Arcane: POST /api/environments/{id}/podman/quadlets/{name}/{action}
• ID de operación: podman-quadlet-action
• Desde: Arcane v2.17.0
• Uso: Starts, stops or restarts the systemd unit of a quadlet (name from podman_quadlet.list, action start, stop or restart) and returns the unit’s state after the job (activeState, subState). stop and restart need confirm=true, start does not: the unit of a .container quadlet runs its container with —rm and removes it with its anonymous volumes when it stops, so stop and restart delete the container and that data (named volumes stay, and restart creates a new container), and a .kube quadlet’s stop tears its pods down (the action cannot tell the quadlet’s type, so stop and restart ask for every type). start runs the unit, whose podman run —replace removes any other container already using the quadlet’s container name (systemd-<name>), but that is rare and start stays unconfirmed. Template quadlets (name@.container) have no unit and answer 409. Arcane reaches systemd over D-Bus, so this works only when the agent runs on the Podman host (podman.status systemdAvailable). Containers a quadlet runs are also started and stopped through their unit by container.start/stop/restart, while container.redeploy, container.edit and container.delete refuse them with 409. Needs podman:quadlets:lifecycle.
• Acciones relacionadas: podman_quadlet.get, podman_quadlet.update, container.list

podman_quadlet.list

List quadlets

List installed Podman quadlets with their systemd units

• Tipo: lectura
• Parámetros obligatorios: ninguno
• Meta-herramienta: arcane_podman_quadlet con "action": "list"
• Herramienta individual: arcane_podman_quadlet_list
• Ruta de Arcane: GET /api/environments/{id}/podman/quadlets
• ID de operación: list-podman-quadlets
• Desde: Arcane v2.17.0
• Uso: A page of the quadlets installed on the Podman host (name such as web.container, unitName such as web.service, path, status, type, app, template). Filter with name, pod or status (lists, pod and status need Podman 6.0+), search name, unit, type, status or app, sort by name, type, status, unitName or app, page with start and limit. Quadlets need Podman 5.8+ (else 400) and systemd on the host (Podman answers 500 ‘connecting to systemd dbus’ without it). See podman.status. Needs podman:read.
• Acciones relacionadas: podman_quadlet.get, podman_quadlet.create, podman_quadlet.file_get, podman.status

podman_quadlet.update

Update quadlet

Replace a quadlet file, keeping its application

• Tipo: destructiva — exige confirm: true
• Parámetros obligatorios: name, content
• Meta-herramienta: arcane_podman_quadlet con "action": "update"
• Herramienta individual: arcane_podman_quadlet_update
• Ruta de Arcane: PUT /api/environments/{id}/podman/quadlets/{name}
• ID de operación: update-podman-quadlet
• Desde: Arcane v2.17.0
• Uso: Replaces a quadlet file (name from podman_quadlet.list) with content and its extraFiles, keeping its application. systemd is reloaded, but a running unit keeps its old definition until podman_quadlet.lifecycle restart. Read the current text with podman_quadlet.file_get first. Needs podman:quadlets.
• Acciones relacionadas: podman_quadlet.file_get, podman_quadlet.lifecycle