Guia de Empaquetado RPM

Transcripción

1 Guia de Empaquetado RPM Guía para iniciar en la tareas de Empaquetado RPM. Fedora Nicaragua, Comunidad de Usuarios y Colaboradores de Fedora en Nicaragua <contacto@fedora.org.ni>

2 Guia de Empaquetado RPM: Guía para iniciar en la tareas de Empaquetado RPM. por Fedora Nicaragua Resumen Esta es una guía práctica y está dirigida a potenciales colaboradores del Proyecto Fedora que quieren unirse al grupo de empaquetadores. Hace un recorrido por todos los pasos a seguir, desde cero hasta el envío del paquete para ser incluido en los repositorios. También debería ser válida para quienes están interesados en colaborar con RPM Fusion y/o con el proyecto EPEL para CentOS/Red Hat. Copyright. The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at The original authors of this document, and Red Hat, designate the Fedora Project as the "Attribution Party" for purposes of CC-BY-SA. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version. Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law. Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, MetaMatrix, Fedora, the Infinity Logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries. For guidelines on the permitted uses of the Fedora trademarks, refer to Linux is the registered trademark of Linus Torvalds in the United States and other countries. Java is a registered trademark of Oracle and/or its affiliates. XFS is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries. MySQL is a registered trademark of MySQL AB in the United States, the European Union and other countries. All other trademarks are the property of their respective owners.

3 Tabla de contenidos Preface... iv 1. Elegir una aplicación que te gustaría empaquetar... 1 Verificar que la licencia sea considerada «LIBRE»... 1 Compilar exitosamente el software desde el código fuente... 1 Identificar las dependencias Configurar tu entorno de empaquetado... 3 Crear un usuario del sistema para empaquetar... 3 Configuración inicial... 3 Crear una Cuenta de Usuario de Fedora... 4 Crear una Cuenta de Usuario en Bugzilla Crear un archivo SPEC... 5 Estructura de un archivo SPEC... 5 A. Historia de revisiones... 7 Índice... 8 iii

4 Preface Escribir Prefacio iv

5 Capítulo 1. Elegir una aplicación que te gustaría empaquetar La cantidad de paquetes disponibles desde los repositorios de Fedora es enorme, incluso llega a aparentar que ya no queda nada por empaquetar, en realidad la situación es todo lo contrario, hay miles de aplicaciones disponibles que no están incluidas en los repositorios. En algún momento encontrarás alguna aplicación que no ha sido empaquetada Fedora y que te gustaría que estuviera disponible en los repositorios. Tú puedes empaquetar esa aplicación, la recomendación general es que el primer proyecto de empaquetado sea una aplicación simple. Existen miles de bibliotecas de Python y Ruby que pueden incluidas en los repos de Fedora son una buena opción para personas que desean iniciar como empaquetador. Sin embargo, lo más importante es que el mantenedor tenga un interés genuino en mantener la aplicación. El mantenedor debe estar familiarizado con lo que el paquete hace, al menos.finalmente toma en cuenta que no solo se pueden empaquetar aplicaciones o software, puedes empaquetar temas para un entorno de escritorio determinado, juegos de iconos, etc. Verificar que la licencia sea considerada «LIBRE» El Proyecto Fedora solo permite en sus repositorios contenido que se puede distribuir libremente. Todo el software en Fedora debe estar conforme la Lista de licencias de Fedora. Esta lista se basa en las licencias aprobadas por la Free Software Foundation, Open Source Initiative y en concenso con Red Hat Legal. Si el código es multi-licencia, y al menos una de las licencias está aprobado para Fedora, ese código se puede incluir en los repositorios bajo la licencia(s) aprobado (pero sólo bajo los términos de la licencia(s) aprobadas). Compilar exitosamente el software desde el código fuente Antes de iniciar el proyecto de empaquetado se deben obtener los archivos fuentes desde los que se va a crear el paquete, todo RPM debe ser construido desde las fuentes originales sin ninguna modificación alguna, incluso se debe tratar de conservar la marca de tiempo, luego se debe poder instalar exitosamente la aplicación en el sistema, para luego poder proceder a repetir los pasos de la instalación al crear el paquete. Los archivos fuentes o "sources" generalmente se encuentran disponibles en formato comprimido, los formatos mas comunes para distribuir archivos fuentes son.tar.gz y.zip, a este archivo comprimido que contiene el código fuente de la aplicación que nos gustaría empaquetar se le suele llamar "tarball". Para obterner el tarball del proyecto que queremos empaquetar conservando las marcas de tiempo originales se puede usar: $ wget -N link-para-bajar-el-tarball Una vez descargado el archivo fuente es necesario descomprimirlo, luego de descomprimirlo debemos buscar cualquier información que el desarrollador incluye en la fuentes, generalmente un archivo "Readme" o similar, en la documentación debemos seguir los pasos para compilar e instalar el programa manualmente en muestro sistema operativo, hay que prestar especial atención a aquellas dependencias para 1

6 Elegir una aplicación que te gustaría empaquetar necesarias para compilar el programa y aquellas dependencias necesarias para el correcto funcionamiento del mismo. La compilación del código fuente es algo incierto, dependiendo del lenguaje de programación, las bibliotecas utilizadas, el entorno de escritorio que se esté utilizando e incluso el tipo de aplicación o lo que el desarrollador pensó al momento de escribir el código. Debido a que esta es una guía para realizar un paquete RPM bajo los lineamientos de Fedora no hablaremos mucho de cómo se compila una determinada aplicación aplicación o con un determinado lenguaje de programación. Identificar las dependencias Si estas familiarizado con instalar aplicaciones en Fedora, el termino "dependencia" te debe resultar familiar, una dependencía es una aplicación o librearía necesaria para que el programa funcione correctamente, o necesaria para compilar exitosamente la aplicación. Es decir, el software que estamos empaquetando puede depender de otras aplicaciones para funcionar correctamente, si estas aplicaciones no estan disponibles el software no funcionara como se espera. Al momento de crear un RPM es necesario definir claramente aquellas depencias necesarias para compilar la aplicación, así como aquellas dependencias necesarias para que el usuario pueda hacer uso de la aplicación una vez empaquetada. Nota Hay que prestar mucha atención a las dependencias del software que estamos tratando de empaquetar, así como la versión necesaria. Si nuestro paquete depende de una aplicación que no esta disponible en Fedora debemos empaquetar esa dependencia para asegurar que todas las dependecias de nuestro paquetes esten disponibles Aviso Si el software que estamos tratando de empaquetar depende de aplicaciones que por asuntos de licencias no pueden estar disponibles en Fedora, y sin esa dependencia no es posible un correcto funcionamiento del software, el paquete no podra ser incluido en Fedora. Para paquetes que por problemas de licencias no puede estar disponibles en Fedora existe el proyecto RPMFusion [rpmfusion.org/]. 2

7 Capítulo 2. Configurar tu entorno de empaquetado Antes de crear paquetes RPM en Fedora, necesita instalar algunas herramientas básicas de desarrollo: # dnf -y # dnf -y install fedora-packager fedora-review rpmlint Crear un usuario del sistema para empaquetar Es recomendable crear un usuario ficticio (dummy) específicamente para crear paquetes RPM, si el proceso de construcción sale mal evitara destruir sus archivos o enviar sus claves privadas a la web. Aviso Nunca se debe crear los paquetes como usuario root. Crear un nuevo usuario: # useradd nombre_nuevo_usuario Agregar el usuario al grupo 'mock': # usermod -a -G mock nombre_nuevo_usuario Establecer una contraseña para el nuevo usuario: # passwd nombre_nuevo_usuario Fedora cuenta con una rama de desarrollo conocida como Rawhide [ Releases/Rawhide], Fedora Rawhide es la base para el próximo lanzamiento de Fedora, en Rawhide se encuentran las últimas versiones disponibles del software disponible en Fedora y sirve como una etapa de pruebas y estabilización antes de ponerlas a disposición del público en general. No se exige realizar empaquetar usando Fedora Rawhide pero es altamente recomendable usar una maquina virtual con Fedora Rawhide para asegurarnos que el software que estamos empaquetando podra funcionar sin problemas en la próxima versión estable de Fedora. Configuración inicial Una vez creado el usuario para empaquetar en nuestro sistema y habiendo instalando el entorno minimo de empaquetado podemos iniciar la configuración de nuestro entorno de empaquetado. El trabajo de empaquetado RPM se llega a caba utilizando herramientas de linea de comandos, se recomiendo estar familiarizado con la "Terminal". Iniciamos sesión con el usuario empaquetador, accedemos a una terminal y ejecutamos $ rpmdev-setuptree El comando anterior creo el directorio ~/rpmbuild y los subdirectorios que son necesarios para la creación de paquetes RPM: 3

8 Configurar tu entorno de empaquetado BUILD: Este es el directorio de compilación del código fuente, durante el proceso de de creación de un paquete RPM los archivos fuentes deben compilarse a binarios, a este directorio de copian los archivos fuentes descomprimidos, se aplican los parches sin son necesarios y se ejecuta la compilación de las fuentes. BUILDROOT: En este directorio se "instalan" virtualmente los archivos compilados anteriormente en el directorio /BUILD, bajo este directorio se crean los directorios que necesita el software que estamos empaquetando una vez instalado, los archivos en /BUILDROOT son los que se incluyen en el "payloda" del RPM. RPMS: En directorio se guardan los archivos RPM que vamos a crear. SOURCES: En este directorio se deben guardar los archivos fuentes que se van a compilar, en este mismo directorio se deben guardar los parches sin son necesarios así como todo contenido que queramos incluir en el archivo RPM. SPECS: En este directorio se deben colocar los archivos.spec que vamos a crear para compilar las fuentes en un archivo RPM RPMS: En directorio se guardan los archivos SOURCE RPM que resultan del proceso de crear un RPM, un SOURCE RPM es un archivo que contiene todos los archivos necesarios para recompilar nuevamente el archivo RPM desde las fuentes. Crear una Cuenta de Usuario de Fedora Es recomendable a este punto tener activa una cuenta de usuario en el "Fedora Accounts System (FAS)", tener una cuenta FAS nos permitira mas adelante hacer compilaciones de pruebas de nuestro paquete o ponerlo a disposición del público de formal fácil, si no tiene una cuenta FAS debera crear una desde: Crear una Cuenta de Usuario en Bugzilla El Proyecto Fedora utiliza Bugzilla para llegar registro de bugs, solicitudes de ususarios y revisiones de nuevos paquetes a este punto tener activa una cuenta de usuario en Bugzilla, si no tiene una cuenta FAS debera crear una desde: 4

9 Capítulo 3. Crear un archivo SPEC Un SPEC no es mas que un archivo de texto plano con especsificaciones sobre como crear un Paquete RPM a partir del código fuente o tarball. En el directorio ~/rpmbuild/specs es donde se coloca el archivo "NOMBRE.spec", donde "NOMBRE" debe coresponder con el nombre es el nombre paquete que queremos crear, es decir si queremos compilar foo-bar.rpm el archivo.spec se debe llamar foo-bar.spec. Para crear un nuevo archivo.spec ejecutamos: $ cd ~/rpmbuild/specs $ rpmdev-newspec NOMBRE.spec Estructura de un archivo SPEC Un archivo SPEC debe constar con al menos cuatro secciones Metadatos: Esta sección del spec contiene información del paquete que vamos a crear como: Nombre, Versión, Lanzamiento, Licencia, Descripción, URL del Proyecto. Ademas contiene información sobre las dependencias del paquete, archivos fuentes, parches, arquitecturas, etc. Información para compilación del paquete: Estós son propiamente los pasos necesarios para compilar los archivos fuentes e instalarlos en el sistema, así como realizar pruebas básicas que provee el desarrollador. Esta pasos se deben seguir estrictamente en el orden previsto: %prep, %build, %install, %chec. Archivos a ser incluidos en el RPM: Estos son los archivos que van a incluir en el "payload" del RPM. Control de Cambios: Un registro cronologico de los cambios en el empaquetado, incluyendo nuevas versiones, mejoras al empaquetado, etc. Nota Las etiquetas deden ser en Ingles, no se hace diferencia entre Mayusculas y Minusculas en el nombre de las etiquetas, generalemente en el Proyecto Fedora se acostumbra usar soló la primer letra en Mayusculas. 5

10 Crear un archivo SPEC 6

11 Apéndice A. Historia de revisiones Historial de revisiones Revisión Thu Oct Enter your first name here.ingrese su apellido aquí.<enter your address here.> Initial creation by publican 7

12 Índice 8