Gentoo Overlays: Guía del Usuario

1.  Introducción

Audiencia

Este documento ha sido escrito para los usuarios de Gentoo. Si es un Desarrollador de Gentoo o un miembro del equipo de Gentoo y desea manejar un overlay propio, por favor mire la Guía del Desarrollador.

¿Qué son los Overlays?

"Overlays" son árboles de paquetes para Portage que contienen ebuilds adicionales para Gentoo. Son mantenidos por desarrolladores de Gentoo, pero distribuidos de forma separada con respecto al árbol Portage principal.

¿Por qué usar Overlays?

Se crean overlays por muchas razones. Aquí mencionamos algunas de las principales:

• Si modifica un ebuild en /usr/portage, los cambios se perderán la próxima vez que haga emerge --sync. Pero, si guarda el ebuild modificado en un overlay, sus cambios están seguros de no perderse en un emerge --sync.
• Ya que los overlays no están en el árbol principal de paquetes del Portage de Gentoo, son el lugar perfecto para desarrollar y probar un ebuild sin temor a romper el árbol principal de paquetes del Portage.
• No todos los ebuilds pertenecen al árbol de paquetes del Portage de Gentoo. Un overlay es un buen sitio para almacenar un ebuild hasta que esté listo para entrar al árbol de paquetes del Portage de Gentoo.

¿Qué es el Proyecto de Overlays Gentoo?

Este proyecto proporciona espacios sociales que permite a proyectos, los desarrolladores y usuarios colaborar juntos en futuros paquetes para Gentoo. Esto lo llevamos a cabo hospedando overlays para proyectos, desarrolladores y usuarios de Gentoo.

¿Están hospedados todos los overlays oficiales en overlays.gentoo.org?

No. Los desarrolladores de Gentoo son libres de poner sus overlays donde se sientan más cómodos; no tienen que usar overlays.gentoo.org si no lo desean.

2.  Empezar con los Overlays

Use layman para instalar y actualizar fácilmente los overlays cada cierto tiempo.

Instalar Layman

Antes de instalar layman vale la pena mencionar que probablemente desee activar los parámetros USE="git subversion". Después de seleccionar los parámetros deseados, ejecute la siguiente orden:

# emerge layman

(para layman 1.1)
# echo "source /usr/portage/local/layman/make.conf" >> /etc/portage/make.conf

(para layman 1.2)
# echo "source /usr/local/portage/layman/make.conf" >> /etc/portage/make.conf

(para layman 1.3 y posteriores)
# echo "source /var/lib/layman/make.conf" >> /etc/portage/make.conf

Listar los Overlays disponibles

Para ver un listado de los overlays disponibles, ejecute:

# layman -L

Instalar un Overlay

Para instalar un overlay en su computadora, ejecute:

# layman -a <overlay-name>

Por ejemplo, para instalar el overlay de PHP, ejecute:

# layman -a php

Instalar paquetes desde un Overlay

Después de instalar un overlay, puede instalar sus paquetes ejecutando:

# emerge -av <category>/<package>

Portage automáticamente busca en su árbol principal de Gentoo (en /usr/portage), además en el de todos los overlays que tiene instalados, y elige la versión más reciente del paquete que pueda encontrar.

Si Portage no toma el paquete del overlay, es normal, ya que el paquete está marcado como ~arch, donde "arch" es la arquitectura de su computadora. Necesitará hacer keyword del paquete tal y como se explica en el Manual Gentoo.

Actualizar un overlay

Para mantener actualizados los overlays instalados, ejecute:

# layman -S

3.  Cómo involucrarse más

Introducción

Todos los desarrolladores de Gentoo fueron usuarios de Gentoo anteriormente y todavía son usuarios. Nuestros usuarios no solo son la razón de la existencia de Gentoo, también son nuestros futuros voluntarios.

Si empieza a contribuir con un proyecto, le daremos acceso de escritura al overlay del proyecto, y le proporcionaremos mentores para ayudarle a contribuir. Eventualmente, si nos agrada su trabajo y la manera en que lo hace, lo invitaremos a convertirse en un desarrollador completo de Gentoo.

Cómo empezar

Si desea contribuir en un overlay, la mejor manera es crear una buena relación con los desarrolladores de Gentoo responsables del overlay. Encontrará al responsable de cada overlay en la página de overlays.gentoo.org, y siguiendo el enlace del overlay en cuestión.

Varios desarrolladores prefieren ser contactados de diferentes maneras. Algunos permanecen en IRC, y podrían tener canales propios para sus proyectos. Ejemplos incluyen al proyecto de PHP (#gentoo-php), y al proyecto de Webapps (#gentoo-web). Otros prefieren ser contactados solo por correo. La única manera de hacerlo es intentando hacer contacto y trabajar a partir de ahí. Normalmente, en el canal IRC #gentoo-bugs en freenode IRC saben como localizar a las personas en cuestión.

Trabajar con Subversion

Subversion es un sistema de control de versiones que usamos para manejar el contenido de nuestros overlays. Si nunca ha usado Subversion anteriormente, el libro de Subversion es una excelente manera de aprender Subversion. Puede comprarlo en formato barato o leerlo en línea gratuitamente.

Trabajar con Git

Git es otro sistema de control de versiones que usamos para manejar el contenido de nuestros overlays. Para familiarizarse con el, vea el tutorial proporcionado en su página oficial.

Información Adicional

El proyecto de Gentoo (o desarrollador) para el que esté trabajando debería ser capaz de brindarle cualquier información y asistencia adicional que necesite.

4.  Preguntas frecuentes

P: ¿Hospedan overlays para los usuarios?

A: Sí, lo hacemos. Por favor lea este post para obtener instrucciones de cómo hospedar su overlay en la infraestructura de Gentoo.

El contenido de este documento, a no ser que se especifique expresamente, está registrado bajo los términos de la licencia CC-BY-SA-2.5. Se aplican las Pautas de Utilización del logotipo y nombre de Gentoo.