Gentoo Overlays: Guía del Usuario

1.  Introducción

Audiencia

Este documento ha sido escrito para los usuarios de Gentoo. Si usted 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 ustéd modifica un ebuild en /usr/portage, los cambios se perderán la próxima vez que realize un 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 y desarrolladores 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.  Empezando con los Overlays

Use la herramienta layman de Gunnar Wrobel para instalar y actualizar fácilmente los overlays cada cierto tiempo.

Instalando Layman

Para instalar layman, debe seguir estos pasos:

emerge layman

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

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

Listando los Overlays disponibles

Para ver un listado de los overlays disponibles, ejecute:

layman -L

Instalando un Overlay

Para instalar un overlay en su computadora, ejecute:

layman -a <nombre-del-overlay>

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 <categoría>/<paquete>

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

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 (normalmente x86).

Actualizando un overlay

Para mantener actualizados los overlays instalados, ejecute:

layman -S

Por favor, no haga esto más de una vez al día o causará demasiada tensión a la infraestructura de Gentoo.

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 sólo 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 contácto y partir de ahí. Normalmente, en el canal IRC #gentoo-bugs en freenode IRC saben como localizar a las personas en cuestión.

Trabajando 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, una excelente manera de aprender Subversion es leer libro en línea. Si lo prefiere, puede comprarlo en formato impreso.

Trabajando 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.

Información Adicional

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

4.  Preguntas frecuentes

P: ¿Hospedan overlays para los usuarios?

• R: No, no lo hacemos. Si desea un overlay propio en (git.)overlays.gentoo.org, debe convertirse en un desarrollador de Gentoo primero.

El contenido de este documento está registrado bajo los términos de la licencia Creative Commons - Reconocimiento / Compartir Igual