Gentoo Overlays: Guía del DesarrolladorÉste documento ha sido escrito para desarrolladores de Gentoo y miembros del equipo de Gentoo. Si usted es usuario de Gentoo, o solo desea empezar a usar y descargar de los overlays, por favor mire Gentoo Overlays: Guía del Usuario. overlays.gentoo.org provee un espacio social que permite a los desarroladores de proyectos de Gentoo y a sus usuarios colaborar juntos en los futuros paquetes de Gentoo. Realizamos ésto, hospedando overlays para proyectos de Gentoo y overlays para desarrolladores de Gentoo. ¿Quién puede usar overlays.gentoo.org? Cualquier proyecto de Gentoo, o desarrollador de Gentoo puede tener su propio overlay hospedado en overlays.gentoo.org, incluyendo el RSS feed de su changelog en la página de overlays.gentoo.org. Cualquier miembro del equipo de Gentoo o usuario (p. e., cualquiera que no tenga acceso a escritura en el árbol principal de paquetes del Portage) puede descargar y usar los contenidos de cualquier overlay hospedado. Si lo desea, puede también otorgar acceso de escritura a los usuarios de su overlay. ¿Qué me da overlays.gentoo.org? Actualmente overlays.gentoo.org provee:
... todo hospedado en la segura y respaldada infraestructura de Gentoo, administrada por el equipo de infraestructura de Gentoo (hardware / OS base) y el equipo de Overlays de Gentoo (wiki / VCS / ACLs). Cada overlay tiene listas de autenticación por separado para Trac y Subversion. No hay problema alguno en dar acceso de escritura a alguien a Trac (p. e., para escribir documentación) sin darle acceso a escritura en Subversion. ¿Por qué debería usar overlays.gentoo.org? No tiene que hacerlo. No es necesario que tenga un overlay, y si tiene alguno, es absolutamente libre de poner su overlay donde desee. No debe hospedar un overlay en o.g.o para que sea considerado "oficial". La ventaja de usar overlays.gentoo.org es la de tener todo ya configurado. Usted no necesita administrar su propio servidor, o preocuparse de las actualizaciones de software. Nosotros nos ocupamos de todo eso por usted. ¿Cuándo no debería usar overlays.gentoo.org? El propósito de o.g.o es el de ayudar a salvar las distancias entre desarrolladores y usuarios. Gentoo es una distribución basada en la comunidad, y creemos que nuestros usuarios son tan importantes en la comunidad como los desarrolladores. Todos los overlays hospedados en o.g.o están ahí para que los usuarios los usen y descarguen de ellos. Es decisión de los usuarios cuál software instalarán en sus computadoras - y eso incluye elegir usar su overlay. Algunos usuarios tomarán malas decisiones, y terminarán malogrando su computadora. Incluso podrían llegar a culpar a Gentoo por ello. Eso está bien; esas personas probablemente vayan culpando a todos excepto a ellos por sus propios errores, y es probable que usted no pueda hacer nada al respecto. Pero aún así ninguno de nosotros tiene el derecho de elegir por ellos. Los usuarios son libres (de hecho, los animamos) de brindar opiniones constructivas acerca de cualquier tema relacionado con Gentoo - incluyendo a los overlays hospedados en o.g.o. Esa retroalimentación puede venir vía bugs.g.o., vía correo al equipo del proyecto o directamente a usted; vía foros, o por el IRC. No hablamos de los usuarios verdaderamente abusivos; no tenemos tiempo para ellos, y nadie espera que usted lo tenga.
Otra cosa que necesitamos decir es que o.g.o es para hospedar overlays. Usted no puede usarlo para convertirlo en un $UPSTREAM de sus paquetes. Si ese es el tipo de hospedaje que necesita, puede usar servicios SourceForge.net, Berlios, o el GentooExperimental.org de Patrick. Existen dos tipos de overlay - overlays de "proyecto", y overlays de "desarrollador". La única diferencia entre ellos es la responsabilidad.
Los Overlays de "Proyecto" son overlays para proyectos oficiales de Gentoo. Un buen ejemplo es el Overlay de PHP. Un proyecto oficial de Gentoo es aquel que tiene una página de proyecto en www.gentoo.org, y un líder electo. (Esta definción viene de (en inglés) el documento de metaestructura, el cuál es el documento que gobierna a Gentoo). El(los) lider(es) de proyecto es responsable del overlay del proyecto, incluyendo sus contenidos, y cualquier problema que éstos causen a otros proyectos y desarrolladores de Gentoo. Para requerir un overlay de proyecto, el líder de éste solo necesita pasar por #gentoo-overlays en el IRC y solicitar que el overlay le sea creado. O, si él/ella lo prefiere, puede envíar un correo a overlays@gentoo.org. Nosotros nos encargaremos del resto, incluyendo otorgar accesos de escritura a todos los miembros del proyecto (listados en la página de su proyecto). Nosotros:
Los Overlays de "Desarrollador" son overlays manejados individualmente por desarrolladores de Gentoo. Un ejemplo de ello es Overlay de tcort. Si tiene una dirección de correo @gentoo.org y ha pasado la prueba de ebuilds entonces puede tener su propio overlay de desarrollador en o.g.o. Para requerir un overlay de desarrolador, simplemente ingrese a #gentoo-overlays en el IRC y solicite que el overlay le sea creado. O, si prefiere, envíe un correo a overlays@gentoo.org Nosotros:
Una palabra acerca de las cuentas Ya que o.g.o está diseñada para dar cabida tanto a desarrolladores de Gentoo y a usuarios de Gentoo, no creamos cuentas a nivel de sistema 'reales' en el host de o.g.o. Actualmente todos los accesos se realizan a través de Apache, y estan manejados por el htpasswd de Apache y archivos de htgroup.
Usted puede acceder a su overlay tan pronto como éste sea creado. Los overlays de proyecto y de desarrolladores tienen distintas URLs, así cada cual sabe qué es de quien, a parte de ello son en iguales en todo sentido. *No* existen restricciones de lectura en los overlays o wikis. Todos tienen completo acceso a todos los overlays y wikis. Si necesita un overlay 'secreto' o algo así, entonces o.g.o no es para usted. Accediendo a los Overlays de Proyecto Si el overlay de su proyecto se llama 'foo', el wiki de su Trac estará aquí: http://overlays.gentoo.org/proj/foo/. Para verificar su repositorio en Subversion, ejecute:
Nosotros mantenemos una lista completa de los overlays de proyecto hospedados en overlays.gentoo.org. Accediendo a los Overlays de Desarrollador Si su dirección de correo electrónico es 'foo@gentoo.org', el wiki de su sitio en Trac estará aquí: http://overlays.gentoo.org/dev/foo/. Para verificar su repositorio en Subversion, ejecute:
Nosotros mantenemos una lista completa de los overlays de desarrollador hospedados en overlays.gentoo.org. Su overlay viene con Trac. Trac es un wiki, un navegador de repositorios Subversion, y un sistema de monitoreo de bugs muy popular entre los desarrolladores de código abierto. Hemos deshabilitado el sistema de monitoreo de bugs en Trac. Use el Bugzilla de Gentoo para controlar los bugs de su overlay. El feed RSS de su overlay - el que se muestra en la página de o.g.o - viene de la página Timeline de Trac. Hemos instalado muchos plugins de Trac, los cuales esperamos hagan de su wiki aún más útil para usted. Si necesita algún plugin adicional que le gustaría sea instalado, por favor háganoslo saber, y le daremos un vistazo.
Hemos instalado muchos macros para Trac, los cuales esperamos hagán a su wiki más útil para usted. Si necesita algún macro adicional que le gustaría sea instalado, por favor háganoslo saber, y nosotros le daremos un vistazo.
Su overlay viene con Subversion, una moderna alternativa a CVS. Las ventajas de Subversion sobre CVS incluyen control real de versiones sobre directorios, soporte completo de cambios, y es mucho más fácil hacer ramificaciones (branching) si lo necesita. La mayor desventaja de Subversion es que es más lento que CVS, y hacer una verificación local de Subversion requiere más espacio en disco. Si nunca ha usado Subversion anterioremente, el libro en línea es una excelente manera de aprenderlo. También puede comprarlo en formato impreso si lo prefiere. Aquí ponemos unos cuantos comandos básicos para empezar.
Le sugerimos a los usuarios usar layman para descargar y manejar su overlay. Layman es una utilidad escrita por Gunnar Wrobel la cual le facilita a los usuarios trabajar con los overlays. Para empezar a usar layman, mire (en inglés) el Semanario de Gentoo del 22 de Mayo, éste artículo en Gentoo-Wiki.com, o la página man que viene con layman. Sincronización Automática desde Portage Sus paquetes en el árbol de Portage siempre están en riego de ser cambiados sin previo aviso. Los equipos de Arquitectura necesitan ser capaces de enmascarar paquetes (y arreglar problemas específicos de arquitectura), el equipo de QA arregla violaciones de estándares que se han detectado, y ocasionalmente los desarroladores editarán paquetes que no deberían. Usted necesita asegurarse que los cambios hechos en el Portage no se pierdan la próxima vez que copie sus paquetes desde su overlay de vuelta al Portage. El equipo de PHP ha resuelto éste problema copiando automáticamente sus paquetes desde el Portage de vuelta a la rama 'portage' de su overlay cada noche. Luego puede usar Subversion (o el Timeline de Trac) para ver los cambios cada día. Si le gustaría tener ésta característica en su overlay, contácte a CHTEKK. Configurando git para envíos con webdav
Fuente (en inglés): http://www.kernel.org/pub/software/scm/git/docs/howto/setup-git-server-over-http.txt Ántes de enviar usted necesita crear localmente un repositorio git y agregar todos los ítems:
Note que éste envío fue localmente, ahora introducimos al servidor en el juego. Asegúrese de agregar el rastro /
Fuente (en inglés): http://www.kernel.org/pub/software/scm/git/docs/tutorial.html Verificando el overlay con git
5. Otorgando a Otros acceso a su Overlay Una de las características clave de o.g.o es que la gente que no tiene acceso de escritura al árbol de paquetes del Portage de Gentoo puede tener acceso de escritura a uno o más overlays. Muchos proyectos de Gentoo han encontrado en ésta una excelente manera de entrenar y evaluar a potenciales desarrolladores de Gentoo en un entorno seguro. Actualmente, sólo el equipo de Overlays puede actualizar las listas de control de acceso de overlays.gentoo.org. Más adelante hemos de proveer una herramienta web para el manejo de listas de acceso. Pero, por ahora, si necesita que un cambio sea hecho, por favor, pase por #gentoo-overlays en el IRC para asistencia. Overlays de Proyecto: Otorgando accesos de escritura a Miembros del Equipo Cualquier desarrollador listado en la página del equipo del proyecto en www.g.o puede tener acceso de escritura al overlay del equipo. El líder de proyecto puede preguntar en su nombre, o el desarrollador puede venir y preguntar por su cuenta. Si el desarrollador no tiene una cuenta en o.g.o aún, el/ella necesitará pasar por #gentoo-overlays así podremos crearle una cuenta. Overlays de Proyecto: Otorgando accesos los Otros desarrolladores de Gentoo Cualquier desarrollador de Gentoo *no* listando en la página de equipo del proyecto en www.g.o puede tener acceso de escritura al overlay del equipo. El requerimiento para acceso de escritura debe venir de un miembro del equipo. No debe venir del líder de proyecto. Si el desarrollador no tiene una cuenta en o.g.o aún, el/ella necesitará pasar por #gentoo-overlays así podremos crearle una cuenta. Overlays de Proyecto: Otorgando accesos de escritura a Usuarios de Gentoo Cualquier usuario de Gentoo puede tener acceso de escritura en el overlay del equipo. El requerimiento de acceso de escritura debe venir de uno de los líderes de proyecto. Usted puede requerir que le demos al usuario acceso de escritura a Trac, a Subversion, o a ambos. (Nosotros asumiremos que el requerimiento es para acceso de escritura a ambos, a menos que usted diga lo contrario). No hemos de aceptar éste requerimiento de otro que no sea el líder de proyecto. Si su proyecto sólo tiene un líder, recomendamos elegir un segundo líder. Si su único líder está AWOL (Ausente Sin Renuncia Oficial), consideren elegir un reemplazo :) Si el usuario no tiene una cuenta en o.g.o aún, el/ella necesitará pasar por #gentoo-overlays así podremos crearle una cuenta. Overlays de Desarrollador: Otorgando accesos de escritura a Desarrolladores de Gentoo Cualquier desarrollador de Gentoo puede tener acceso a su overlay de desarrollador. El desarrollador puede preguntarnos directamente; nosotros no le daremos acceso hasta haberlo confirmado con usted. También puede usted consultarnos para dar accesos de escritura a cualquier desarrollador. Si el desarrollador no tiene una cuenta en o.g.o aún, el/ella necesitará pasar por #gentoo-overlays así podremos crearle una cuenta. Overlays de Desarrollador: Otorgando accesos de escritura a Usuarios de Gentoo Cualquier usuario de Gentoo puede tener acceso de escritura a su overlay de desarrollador. El requerimiento para el acceso a escritura debe venir de usted. Puede requerir que le demos al usuario accesos de escritura sólo en Trac, sólo en Subversion, o ambos. (Nosotros asumiremos que el requerimiento es para accesos de escritura a ambos a menos que usted diga lo contrario). No aceptaremos éste requerimiento de otro excepto usted. Si ve que está dando accesos a mucha más gente, es posible que deba considerar crear un nuevo proyecto, y transferir su trabajo ahí. Si el usuario no tiene una cuenta en o.g.o aún, el/ella debe pasar por #gentoo-overlays así nosotros podremos crearle una cuenta. 6. Accediendo al Overlay de alguien más Todos tienen acceso completo de lectura a cualquier overlay. Le recomendamos usar
Luego, para ver el listado de overlays, ejecute
Para instalar un overlay, ejecute
Ahora puede instalar los paquetes del overlay. Requiriendo Accesos de Escritura Si usted desea accesos de escritura a un overlay de proyecto, contácte a un miembro del equipo del proyecto, y consulte por del acceso. Si aprueba su requerimiento, ellos se encargarán de su acceso a escritura contactándo al equipo de Overlays. Si usted desea accesos de escritura en un overlay de desarrollador, contácte al desarrollador directamente, y consulte por el acceso. Si aprueba su requerimiento, él se encargará de su acceso a escritura contactándo al equipo de Overlays. P: ¿Cómo contacto al equipo de administración de o.g.o?
P: ¿Por qué no puedo editar las listas de control de acceso directamente?
P: ¿Está mi overlay disponible por https?
P: ¿Puedo tener acceso a multiples overlays?
Importando Overlays Existentes P: Ya tengo un overlay, y me gustaría moverlo a o.g.o. ¿Cómo puedo hacer eso?
P: Tengo un overlay, pero no usa subversion. ¿Cómo puedo moverlo a o.g.o?
P: ¿Cuándo un overlay es considarado "oficial"?
P: ¿Debe un overlay estar en o.g.o para ser "oficial"?
El contenido de este documento está registrado bajo los términos de la licencia Creative Commons - Reconocimiento / Compartir Igual |
|
