Introducción

Instala uno o más paquetes en un dispositivo Linux como parte de una automatización. Usa esta acción para distribuir herramientas en tu inventario, configurar un conjunto base de paquetes en dispositivos nuevos o instalar software de forma programada sin tocar cada máquina manualmente.

La acción admite cinco administradores de paquetes: Apt, Yum, Pacman, Snap, y Flatpak. El administrador de paquetes se elige por paso de acción, por lo que una misma automatización puede apuntar a un entorno con distintas distribuciones ramificando en condiciones.

⚙️ REQUISITOS PREVIOS:

Un dispositivo Linux bajo administración.
El administrador de paquetes que selecciones debe estar presente en el dispositivo. Seleccionar Apt en un equipo con Arch, por ejemplo, falla el paso.
Para Flatpak, el flathub el repositorio remoto debe estar configurado en el dispositivo.

Administradores de paquetes admitidos

El administrador se elige explícitamente desde el Administrador de paquetes desplegable. No hay detección automática en la acción: el valor que elijas es el que Level ejecuta.

Administrador	Distribuciones típicas	Formato del nombre del paquete
Apt	Debian, Ubuntu, Linux Mint, Raspberry Pi OS	Nombre del paquete Debian (`apt-cache search`, `dpkg -l`)
Yum	RHEL, CentOS, Rocky, AlmaLinux, Fedora, Photon OS	Nombre RPM
Pacman	Arch Linux	Nombre en la base de datos de sincronización (`pacman -Ss`)
Snap	Cualquier distribución con snapd	Nombre del snap
Flatpak	Cualquier distribución con Flatpak	ID de aplicación de Flathub (p. ej., `org.gnome.Calculator`)

ℹ️ NOTA: La opción Yum la opción abarca yum, dnf, y tdnf. El agente detecta qué binario usa realmente el dispositivo y ejecuta el correcto, por lo que seleccionas Yum independientemente de si el dispositivo usa RHEL (yum/dnf) o Photon OS (tdnf).

Agregar la acción Instalar paquete de Linux

Abre la automatización en modo de edición y haz clic en + Agregar acción.
En Gestión de aplicaciones, selecciona Instalar paquete de Linux. El panel de acción se abre con Tipo de acción (preestablecido en Instalar paquete de Linux) y Configuración del paso.
Elige un Administrador de paquetes.
Introduce uno o más nombres en Paquete(s). Presiona Tab o agrega una coma después de cada nombre para añadir el siguiente.
Haz clic en Guardar.

Administrador de paquetes

Obligatorio. Define qué herramienta se ejecuta en el dispositivo y qué formato de nombre espera el campo Paquete(s) espera.

El desplegable muestra Apt, Yum, Pacman, Snap, y Flatpak. Consulta la tabla anterior para saber qué espera cada uno.

Paquete(s)

Obligatorio. Los nombres de los paquetes a instalar, en el formato que utiliza el administrador seleccionado.

La sugerencia en el campo indica «Usa el nombre del paquete tal como aparece en el repositorio de tu distribución», lo cual es exacto para Apt, Yum y Pacman. Snap y Flatpak son diferentes:

Snap toma el nombre del snap (por ejemplo, code).
Flatpak toma el ID de aplicación de Flathub (por ejemplo, org.gnome.Calculator), no el nombre descriptivo de la aplicación.

💡 CONSEJO: Para Apt, Yum y Pacman, un nombre que no existe en los repositorios se reporta como «no encontrado, omitiendo» y el resto de la acción continúa. Snap y Flatpak no omiten: dejan que la herramienta subyacente falle, por lo que un error tipográfico allí hace fallar el paso.

Especificar una versión exacta

De forma predeterminada, la acción instala la última versión disponible. Apt y Yum permiten fijar una versión específica escribiéndola directamente en el nombre del paquete. Pacman, Snap y Flatpak no admiten una cadena de versión en este campo.

Apt

Los paquetes se identifican por su nombre de paquete Debian tal como lo muestra apt-cache search o dpkg -l.

Formato	Ejemplo	Resultado
`name`	`nginx`	Última versión disponible
`name=version`	`nginx=1.24.0-2`	Cadena de versión exacta
`name:arch`	`libc6:i386`	Arquitectura específica (multiarquitectura)
`name/release`	`nginx/bookworm-backports`	Desde una versión o suite específica

Yum / DNF / TDNF

Los paquetes se identifican por su nombre RPM.

Formato	Ejemplo	Resultado
`name`	`httpd`	Última versión disponible
`name-version`	`httpd-2.4.57`	Versión específica
`name-version-release`	`httpd-2.4.57-5.el9`	Versión y etiqueta de lanzamiento
`name.arch`	`glibc.i686`	Arquitectura específica
`name-version-release.arch`	`httpd-2.4.57-5.el9.x86_64`	NEVRA completamente calificado

Pacman

Los paquetes se identifican por su nombre en la base de datos de sincronización tal como lo muestra pacman -Ss.

Formato	Ejemplo	Resultado
`name`	`nginx`	Última versión del repositorio de mayor prioridad
`repo/name`	`extra/nginx`	Desde un repositorio específico

ℹ️ NOTA: Pacman no admite instalar una versión específica. Siempre instala lo que contengan actualmente los repositorios configurados.

Cómo se ejecuta la acción

Algunos comportamientos aplican a todas las instalaciones, independientemente del administrador:

Solo Linux. Si se ejecuta en un dispositivo Windows o macOS, el paso devuelve «acción no compatible». El resto de la ejecución de la automatización continúa.
El administrador seleccionado debe estar presente. Si el binario no está instalado en el dispositivo, el paso falla con «Administrador de paquetes no compatible».
Tiempo de espera de 3 horas en toda la acción.
Salida en tiempo real. La salida del comando se transmite línea por línea al registro de ejecución en tiempo real, por lo que verás cada * Installing <pkg> línea mientras trabaja el administrador.

Para Apt, Yum y Pacman, Level espera el bloqueo del administrador de paquetes si otro proceso lo mantiene, con reintentos que van de 1 segundo hasta 30 segundos entre comprobaciones durante un máximo de 1 hora, luego abandona con «Otro proceso del administrador de paquetes está en ejecución». Snap y Flatpak gestionan su propia cola y no esperan un bloqueo.

Esto es lo que se ejecuta por administrador y la preparación previa que realiza Level:

Administrador	Comando de instalación	Verificaciones previas y notas
Apt	`apt-get -yq install <pkg>` luego `apt-get -yq autoremove --purge`	Ejecuta `apt-get clean` y `dpkg --configure -a` primero para limpiar un estado roto. Se ejecuta con `DEBIAN_FRONTEND=noninteractive`. Los kernels antiguos se eliminan automáticamente y se purgan.
Yum	`yum install -y --noautoremove <pkg>`	Limpia la caché de paquetes primero. Detecta automáticamente yum/dnf/tdnf; en TDNF el `--noautoremove` el indicador se elimina automáticamente.
Pacman	`pacman -S --noconfirm --needed <pkg>`	Elimina un `db.lck`, luego ejecuta `pacman -Sy` (sincronización de BD) y `-Sc` (limpieza de caché) antes de instalar.
Snap	`snap install <pkg>`	Un paquete a la vez. Sin verificación previa de «ya instalado». Tiempo de espera de instalación por paquete de 60 minutos además del límite de 3 horas.
Flatpak	`flatpak install -y --noninteractive flathub <pkg>`	Instala a nivel de sistema (el agente se ejecuta como root), no por usuario, desde el `flathub` remoto. Tiempo de espera por paquete de 60 minutos.

⚠️ ADVERTENCIA: Estas acciones no deshabilitan el actualizador automático propio del dispositivo (como unattended-upgrades). Una instalación programada aún puede coincidir con las actualizaciones en segundo plano del dispositivo. La espera de bloqueo descrita anteriormente es lo que evita que ambos colisionen, no una detención forzada del actualizador automático.

Condiciones

La sección Condiciones restringe cuándo se ejecuta esta acción según los atributos del dispositivo o el resultado de una acción anterior. Expándela para agregar condiciones.

Consulta Condiciones de las acciones para la referencia completa sobre tipos de condiciones, operadores y valores.

💡 CONSEJO: En una automatización con varias distribuciones, condiciona cada paso de instalación según la distribución o arquitectura del dispositivo para que el administrador correcto se ejecute en las máquinas adecuadas y el resto se omita correctamente.

Opciones adicionales

Expande Opciones adicionales para configuraciones de ejecución, incluidos el nombre de la acción, el comportamiento ante fallos, variables de salida y reintentos.

Consulta Descripción general de acciones para la referencia completa sobre las opciones disponibles en todas las acciones.

Preguntas frecuentes

¿Qué administrador de paquetes debo elegir? El que esté realmente presente en el dispositivo. Apt para Debian y Ubuntu, Yum para la familia RHEL y Photon, Pacman para Arch, y Snap o Flatpak donde los hayas estandarizado. No hay detección automática en la acción, por lo que el valor que elijas es el que se ejecuta.
¿Puede una acción instalar paquetes en distintas distribuciones? No, un paso ejecuta un solo administrador. Para un inventario mixto, agrega un paso por administrador y condiciona cada uno según la distribución o arquitectura para que solo los dispositivos correspondientes lo ejecuten.
¿Cómo instalo una versión específica en lugar de la más reciente? Escribe la versión en el nombre del paquete. Apt usa name=version, Yum usa name-version (y formas NEVRA más largas), Pacman no tiene fijación de versión, y Snap y Flatpak no admiten una cadena de versión aquí. Consulta Especificar una versión exacta anterior.
¿Qué ocurre si el nombre de un paquete no existe? Para Apt, Yum y Pacman, el paquete se reporta como «no encontrado, omitiendo» y la acción continúa. Snap y Flatpak exponen el error de la herramienta subyacente para ese paquete.
El paquete ya está instalado. ¿Falla la acción? No. Apt, Yum y Pacman omiten los paquetes que ya están presentes. Snap ejecuta el comando de instalación sin verificación previa, lo cual es una operación sin efecto si ya está instalado.
¿Cuál es la diferencia entre esta acción e Instalar actualizaciones de Linux? Instalar actualizaciones de Linux aplica parches pendientes del sistema operativo y de seguridad en todo el sistema. Esta acción instala los paquetes específicos que tú indicas. Usa las actualizaciones para aplicar parches y esta acción para desplegar software específico.
¿El dispositivo necesita estar en línea? Sí, para que la acción se ejecute. Si está desconectado cuando se activa la automatización, el paso se pone en cola y se reanuda una vez que el dispositivo se reconecta.
¿Quién puede agregar o editar esta acción? Los técnicos con permiso para editar automatizaciones en el grupo correspondiente. Consulta Espacio de trabajo → Permisos para el control de acceso.

Acción: Instalar paquetes de Linux