Binary package guide/es

Next to the usual support for ebuilds, Portage supports building and installing binary packages. This guide explains how to create them, install them, and how to setup a binary package server.

Introducción
Hay muchas razones por la que a los administradores de sistemas Gentoo les gusta utilizar instalaciones de paquetes binarios.


 * 1) En primer lugar, permite a los administradores  mantener actualizados los sistemas que tienen características similares. Compilar todo desde el código fuente puede llevar mucho tiempo. El mantenimiento de varios sistemas similares, probablemente algunos de ellos con hardware antiguo, puede ser mucho más fácil si solo un sistema tiene que compilar todo desde el código fuente y el resto de sistemas reutilizan los paquetes binarios.
 * 2) Una segunda razón es hacer actuaarchivo de medio ambientelizaciones seguras. Es importante mantener utilizables los sistemas de misión crítica la mayor parte del tiempo posible. Esto se puede hacer con un servidor de ensayo que realiza todas las actualizaciones en sí mismo en primer lugar. Una vez el servidor de ensayo se encuentra en un buen estado, las actualizaciones se pueden aplicar a los sistemas críticos. Una variante de este enfoque es hacer los cambios en un entorno chroot en el mismo sistema y utilizar los binarios creados allí en el sistema real.
 * 3) Una tercera razón es a modo de copia de seguridad. A menudo, los paquetes binarios son la única forma de recuperar un sistema que no funciona (por ejemplo, el compilador no funciona). Tener los binarios preconstruidos a mano ya sea en un servidor de paquetes binarios o localmente puede ser de gran ayuda en caso de que se rompa la cadena de herramientas.
 * 4) Por último, también permite la actualización de sistemas muy antiguos . La tarea de actualizar sistemas muy antiguos se puede aliviar en gran medida si se utilizan paquetes binarios. Por lo general es útil para instalar paquetes binarios en los sistemas antiguos, ya que no requieren de dependencias en tiempo de compilación para instalarse o actualizarse. Los paquetes binarios también evitan fallos de los procesos de construcción, ya que están preconstruidos.

This guide will focus on the following topics:


 * How to create binary packages;
 * How to distribute the packages to clients;
 * How to use binary packages;
 * How to maintain the binary packages.

Casi al final se tratan algunos temas avanzados sobre cómo tratar con los paquetes binarios.

Crear paquetes binarios
There are three main methods for creating binary packages:


 * 1) After a regular installation, using the  application;
 * 2) Explicitly during an emerge operation by using the   option;
 * 3) Automatically through the use of the   as a Portage feature.

Los tres métodos crearán un paquete binario en el directorio al que apunta la variable  (cuyo valor por defecto es ).

Utilizar quickpkg
The application takes one or more dependency atoms (or package sets) and creates binary packages for all installed packages that match that atom.

Por ejemplo, para crear paquetes binarios de todas las versiones de GCC instaladas:

Para crear paquetes binarios de todos los paquetes instalados en el sistema, utilice la expresión :

There is a caveat with this method: it relies on the installed files, which can be a problem in case of configuration files. Administrators often change configuration files after installing software. Because this could leak out important (perhaps even confidential) data into the packages, by default does not include configuration files that are protected through the   method. To force inclusion of configuration files, use the  or   options.

Utilizar --buildpkg como opción de emerge
When installing software using, Portage can be asked to create binary packages by using  option:

También es posible pedirle a Portage que únicamente cree los paquetes binarios pero que no instale el software en el sistema vivo. Para hacer esto se puede utilizar la opción  :

El último enfoque requiere sin embargo que estén instaladas previamente todas las dependencias necesarias en el momento de la construcción.

Implementar buildpkg como una característica de Portage
La forma más común para crear automáticamente paquetes binarios cuando Portage instala un paquete es utilizar la característica, que se puede configurar en  de esta forma:

Cuando se activa esta característica, cada vez que Portage instala software se creará también un paquete binario.

Evitar la creación de algunos paquetes
Es posible indicarle a Portage que no cree paquetes binarios para un grupo de paquetes o categorías seleccionados. Esto se hace pasando la opción  a emerge:

Esto se podría utilizar para paquetes en los que se obtiene poco o ningún beneficio teniendo instalado el paquete binario disponible. Ejemplos de ello serían los paquetes fuentes del núcleo Linux o paquetes binarios de los desarrolladores del propio paquete (los que terminan en -bin como ).

Poner en marcha un servidor de paquetes binarios
Portage ofrece el soporte de varios protocolos para la descarga de paquetes binarios: FTP, FTPS, HTTP, HTTPS y SSH. Esto deja espacio suficiente para muchas formas de implementación del servidor.

No hay sin embargo un método "listo para funcionar" que ofrezca Portage para la distribución de paquetes binarios. Dependiendo de la configuración deseada, será necesario instalar software adicional.

Servidor de paquetes binarios basado en Web
Una forma muy usada para la distribución de paquetes binarios es crear un servidor de paquetes basado en web.

Utilice un servidor web como lighttpd y configúrelo para ofrecer acceso de lectura a la localización definida en   dentro del fichero.

A continuación, en los equipos cliente, configure la variable  apropiadamente:

Equipo de paquetes binarios con SSH
Para ofrecer un enfoque con mayor autenticación para los paquetes binarios, se puede considerar el uso de SSH.

Cuando se utiliza SSH es posible utilizar la clave SSH del usuario Linux de Portage (sin frase contraseña ya que se necesita realizar la instalación en segundo plano) para conectar a un equipo remoto con los paquetes binarios.

To accomplish this, make sure that the Portage user's SSH key is allowed on the server. This will need to happen for each machine that will connect to the SSH capable binary host:

El  debería entonces tener el siguiente aspecto:

Exportar mediante NFS
Cuando se utilizan paquetes binarios dentro de una red internt, puede que se más sencillo exportar los paquetes mediante NFS y montarlo en los clientes.

El fichero debería tener el siguiente aspecto:

En los clientes, se puede ahora montar la localización. Un ejemplo de entrada podría ser este:

Utilizar paquetes binarios
Para que los paquetes binarios se puedan utilizar en otros sistemas, deben cumplir algunos requisitos.
 * La arquitectura del cliente y del servidor y su CHOST deben coincidir.
 * El ajuste  y el   que se utilzaron para construir los paquetes binarios deben ser compatibles con todos los clientes.
 * Los ajustes USE de características específicas del procesador (como MMX, SSE,...) deben seleccionarse con cuidado ya que todos los clientes deben ofrecer soporte para ellos.

Aparte de esto, Portage comprobará si el paquete binario se construye utilizando los mismos ajustes USE que se esperan en el cliente. Si se construye un paquete con una combinación distinta de ajustes USE, Portage, bien ignorará el paquete binario (y utilizará un ebuild basado en fuentes), bien fallará, dependiendo de las opciones que se pasen a la orden emerge cuando se invoque (leer Instalar paquetes binarios).

En los cliente se requieren algunos cambios en la configuración para poder utilizar paquetes binarios.

Instalar paquetes binarios
There are a few options that can be passed on to the command that inform Portage about using binary packages:

Para utilizar instalaciones basadas en paquetes binarios de forma automática, se puede añadir la opción elegida a la variable :

Hay una característica (FEATURE) de Portage que implementa automáticamente el equivalente a  sin tener que actualizar la variable  : getbinpkg.

Obtener paquetes desde un servidor de paquetes binarios
Cuando se utiliza una gran cantidad de servidores de paquetes binarios, los clientes necesitan tener definida la variable. De otro modo el cliente no sabrá dónde se almacenan los paquetes binarios lo que resultará en que Portage no podrá recuperarlos.

La variable  utiliza una lista de URIs separada por espacios. Esto permite a los administradores utilizar varios servidores de paquetes binarios de forma simultánea. El URI siempre debe apuntar al directorio en el que el reside el fichero.

Reinstalar paquetes binarios modificados
Passing the  option to emerge will reinstall every binary that has been rebuilt since the package was installed. This is useful in case rebuilding tools like or  are run on the binary package server.

Una opción relacionada es. Hace que emerge no considere los paquetes binarios para una reinstalar si esos paquetes binarios se han reconstruido antes de la marca de tiempo dada. Esto es útil para evitar la reinstalación de todos los paquetes, si el servidor de paquetes binarios se tuvo que reconstruir desde cero, de lo contrario utilice.

Ajustes adicionales en el cliente
Además de la característica getbinpkg, Portage también acepta la característica  binpkg-logs . Ésta controla si los archivos de registro de las instalaciones exitosas de paquetes binarios se deben mantener. Solo es relevante si se ha definido  y está activado por defecto.

Similar a la exclusión de los paquetes binarios para un determinado conjunto de paquetes o categorías, los clientes se pueden configurar para excluir la instalación de paquetes binarios para un determinado conjunto de paquetes o categorías.

Para hacer esto, utilice la opción :

Mantenimiento de paquetes binarios
Si la lista de paquetes binarios no se mantiene de forma activa, la exportación y distribución de paquetes binarios conllevará un consumo inútil de espacio de almacenamiento.

Eliminar paquetes binarios obsoletos
In the package an application called  is provided. It allows for maintaining Portage-related variable files, such as downloaded source code files, but also binary packages.

La siguiente orden elimina todos los paquetes binarios que no tengan un ebuild correspondiente:

Para más detalles, por favor, lea el artículo sobre eclean.

Another tool that can be used is the tool from the  package. However, this tool is a bit less configurable.

Para limpiar paquetes binarios no utilizados (en el sentido de que no los utiliza el servidor en el que se almacenan los paquetes binarios):

Mantener el fichero Packages
Inside the packages directory, a file called exists. This file acts as a cache for the metadata of all binary packages in the packages directory. The file is updated whenever Portage adds a binary package to the directory. Similarly, updates it when it removes binary packages.

If for some reason binary packages are simply deleted or copied into the packages directory, or the file gets corrupted or deleted, then it must be recreated. This is done using command:

Crear instantáneas del directorio de paquetes
Cuando se despliegan paquetes binarios para un gran número de sistemas cliente podría resultar adecuado crear instantáneas del directorio de paquetes. Los sistemas cliente entonces no utilizan el directorio de paquetes directamente, sino que utilizan los paquetes binarios de la instantánea.

Snapshots can be created using the or  tool. It takes four arguments:


 * 1) A source directory (the path to the packages directory).
 * 2) A target directory (that must not exist).
 * 3) A URI.
 * 4) A binary package server directory.

Los ficheros del directorio de paquetes se copian al directorio destino. Se crea entonces un fichero dentro del directorio de paquetes binarios del servidor (el cuarto argumento) con el URI que se indica.

Client systems need to use an URI that points to the binary package server directory. From there they will be redirected to the URI that was given to. This URI has to refer to the target directory.

Comprender el formato del paquete binario
Binary packages created by Portage have the file name ending with. These files consist of two parts:


 * 1) A  archive containing the files that will be installed on the system.
 * 2) A  archive containing package metadata, the ebuild, and the environment file.

See for a description of the format.

In some tools exists that are able to split or create  and  files.

The following command will split the into a  and an  file:

The xpak file can be examined using the utility.

Para listar los contenidos:

La siguiente orden extrae un fichero llamado que contiene los ajustes USE habilitados para este paquete:

La plantilla PKGDIR
El formato de la versión que es el que se utiliza actualmente tiene la siguiente disposición:

El fichero es la principal mejora (y también el desencadenante de que Portage sepa que el directorio de paquete binario utiliza la versión 2) sobre la primera disposición de directorios de paquetes binarios (versión 1). En la versión 1, todos los paquetes binarios también se alojaban dentro de un único directorio (llamado ) y los directorios de categoría contenían únicamente enlaces simbólicos a los paquetes binarios dentro del directorio.

Desempaquetar con quickunpkg
Zoobab wrote a simple shell tool named quickunpkg to quickly unpack files.