Saltar al contenido
Engineer
Menú
Diseño
Español

Engineer / Glosario

Paquete de software

Código empaquetado con una descripción, listo para instalar

Qué es

Un paquete es la forma en que el software pasa de quienes lo escriben a las máquinas que lo ejecutan: el código, en un archivo o un directorio, acompañado de un manifiesto que indica su nombre, su versión y qué más necesita para funcionar. El plural es paquetes, y la documentación de sistemas suele hablar de paquetes de software. Cada ecosistema fija sus propios límites. Para npm, un paquete es un archivo o directorio descrito por un archivo package.json, y su documentación lo distingue de un módulo: cualquier cosa que Node.js pueda cargar con require() o import; solo los módulos que incluyen un package.json son paquetes. Python usa la palabra para dos cosas, y la Guía del usuario de Python Packaging las distingue: un paquete de importación es un directorio de módulos que el código importa, mientras que un paquete de distribución es el archivo con versión que una persona descarga e instala. En Rust, un paquete reúne uno o más crates con un Cargo.toml que indica cómo compilarlos. En Debian, la unidad es el paquete binario, el archivo .deb que el sistema instala y registra.

Un paquete es una unidad de distribución, y se entiende mejor al compararlo con los conceptos cercanos. Una biblioteca es código; un paquete es la forma de distribuirlo, y una misma biblioteca puede llegar a sus usuarios como paquete npm, wheel de Python y paquete Debian a la vez. Un gestor de paquetes es el programa que lee los manifiestos, descarga lo que enumeran y lo instala todo en un orden en el que todo pueda funcionar: npm, pip, Cargo y apt. Un registro o repositorio de paquetes es donde estos esperan a ser descargados, como el registro de npm, PyPI, crates.io o una réplica de Debian. Los gestores de paquetes de lenguajes instalan código para un proyecto, normalmente en un directorio junto a él. Los gestores de paquetes del sistema instalan software para toda la máquina y registran qué paquete colocó cada archivo en cada sitio.

Por qué importa

El código de terceros llega a un proyecto de una de estas tres maneras: mediante un gestor de paquetes, copiado al repositorio con su licencia y una suma de comprobación, lo que se llama vendoring, o compilado desde el código fuente. Un gestor de paquetes suele ser la opción elegida por buenas razones. Resuelve todo el árbol de dependencias, las actualiza con un solo comando y registra lo que instala. El coste es la confianza: el proyecto pasa a depender de cada manifiesto de ese árbol y de cada registro del que procede. El vendoring cambia esa confianza por trabajo, porque el código copiado solo cambia cuando alguien copia una versión nueva de forma deliberada. Compilar desde el código fuente ofrece el máximo control y exige el máximo mantenimiento.

En el manifiesto se aprecian la mayoría de las ventajas y las contrapartidas. Suele indicar un intervalo de versiones, no una sola; en npm, un intervalo con circunflejo como ^10.0.1 admite cualquier versión posterior con la misma versión principal. Los intervalos permiten recibir correcciones sin editar el archivo, y también hacen que dos instalaciones separadas por una semana puedan producir árboles distintos. Un archivo de bloqueo cierra esa brecha. npm escribe package-lock.json para describir el árbol exacto que construyó, de modo que las instalaciones posteriores lo reproduzcan; Cargo escribe Cargo.lock con la versión exacta de cada dependencia, y ambos esperan que el archivo se incluya en el control de versiones. El manifiesto registra lo que un proyecto está dispuesto a aceptar; el archivo de bloqueo registra lo que recibió.

Los manifiestos también indican hasta qué punto un paquete necesita a otro. El Manual de políticas de Debian define una escala. Depends es absoluto: el paquete no se configura hasta que se hayan configurado todas sus dependencias. Recommends es una relación fuerte, aunque no absoluta, para paquetes que acompañan a este en todas las instalaciones salvo las poco habituales. Suggests enumera paquetes que lo hacen más útil, aunque instalarlo sin ellos es perfectamente razonable. Una instalación que omite un paquete recomendado es válida, y el software que contiene puede seguir necesitando ese paquete para alguna de sus tareas.

Toda herramienta que analiza paquetes confía en sus metadatos. Un comprobador de licencias lee la licencia declarada, a menudo una expresión SPDX como MIT OR Apache-2.0, donde OR ofrece una elección y AND exige todas las licencias a la vez. Un analizador de vulnerabilidades coteja los nombres y las versiones declarados con los avisos publicados. Si una declaración es incorrecta, todas las herramientas que la leen se equivocan del mismo modo; por eso los archivos de licencia incluidos en un paquete distribuido merecen una lectura por separado.

Cómo se aplica en la práctica

Una revisión de endurecimiento de un servidor de producción descubrió que su jail de bloqueo de intrusiones nunca había bloqueado a nadie, y una de las tres causas independientes era una relación entre paquetes. La acción de bloqueo llamaba a un programa de filtrado de paquetes que el empaquetado clasifica como recomendado, no obligatorio, y el servidor se había construido sin él. El jail arrancaba, contaba los inicios de sesión fallidos y tomaba su decisión cada vez, pero fallaba en el último paso: aplicar el bloqueo. La revisión de tres protecciones de SSH lo descubrió inspeccionando el sistema en ejecución, en vez de los archivos de configuración, y dejó una regla: cada control de seguridad debe estar respaldado por una aserción automatizada, no por un comentario.

Un núcleo de Rust enlazado con una aplicación distribuida incorpora al producto todo su grafo de dependencias: aquí, 644 crates, cada uno con su propia declaración de licencia. Una dependencia situada varios niveles por debajo puede pasar a una licencia copyleft de una versión a otra, y la única huella sería una línea modificada en un archivo de bloqueo que poca gente lee. La auditoría de licencias de 644 crates se ejecuta en cada compilación: evalúa la expresión de licencia de cada crate frente a una lista de licencias permitidas, admite una elección si al menos una licencia está permitida y una combinación solo si lo están todas, y detiene la compilación ante cualquier caso que no encaje. Para demostrar que el control podía activarse, se hizo fallar deliberadamente dos veces: una al reescribir la expresión de licencia de un crate y otra al cambiar la revisión fijada del núcleo sin regenerar la auditoría. La página expone el límite con claridad: la auditoría lee metadatos declarados, que pueden ser incorrectos, y no constituye asesoramiento jurídico.

La forja Git de la empresa se instaló desde la fuente de paquetes del propio proveedor como un único programa que el sistema operativo mantiene en ejecución. Añadir el repositorio de un proveedor a un servidor es una decisión por sí misma, porque, desde ese momento, las actualizaciones habituales instalan lo que ese proveedor publique y firme.

Este sitio no necesita Node para funcionar. Su package.json está marcado como private, lo que indica a npm que rechace su publicación, enumera únicamente herramientas de desarrollo con intervalos de versión con circunflejo y está junto a un package-lock.json incluido en el control de versiones. Su pyproject.toml configura un linter, un corrector ortográfico y un comprobador de tipos, y no contiene tablas [project] ni [build-system], porque no describe ningún paquete que generar. Los iconos se incorporan mediante vendoring: se copian con la licencia del proyecto de origen y una suma SHA-256 para cada archivo.

Dónde surgen los problemas

Una función aparece como operativa, pero no hace nada

Un servicio arranca, registra que está funcionando y omite silenciosamente una de sus tareas cada vez. Un programa al que llama pertenece a un paquete recomendado o sugerido, que la instalación podía omitir legítimamente. Si una función depende de un programa externo, compruebe su presencia al arrancar y deténgase con un error claro si falta, declárelo como requisito obligatorio de su propio despliegue y pruebe la función de extremo a extremo en un servidor construido como el de producción.

Dos máquinas instalan código distinto desde el mismo manifiesto

La compilación funciona en un portátil y falla en integración continua, o al revés, sin cambios en el código del proyecto. El manifiesto indica intervalos de versión, nunca se incluyó el archivo de bloqueo en el control de versiones y una dependencia publicó una versión entre ambas instalaciones. Incluya el archivo de bloqueo en el control de versiones, instale a partir de él en la automatización con comandos que se nieguen a modificarlo, como npm ci o cargo build –locked, y actualícelo mediante un cambio separado y revisado.

Una dependencia conocida cambia de licencia

Un producto que superó una revisión de licencias el año pasado distribuye ahora código con condiciones que nadie aceptó, aunque su lista de dependencias parezca la misma. Una dependencia existente cambió de licencia entre versiones, y una actualización habitual incorporó la nueva versión mediante el archivo de bloqueo. Compruebe las licencias declaradas frente a una lista explícita de licencias permitidas en cada compilación, para que el cambio la detenga el mismo día en que llegue.

Lecturas adicionales

Contacto

¿Aún está definiendo lo que necesita?

Cuéntenos qué está fallando o qué intenta construir. Le diremos qué haría falta, cuánto costaría aproximadamente y si somos las personas adecuadas.

Desde 1.400 DKK por hora, sin IVA; y un precio por hora menor en una contratación más larga.

welcome@engineer.company +45 50 10 61 84 Copenhague, Dinamarca