Les Overlays de Gentoo

L’équipe de Gentoo est ravi d’annoncer l’ouverture d’un nouveau service destiné à centraliser les overlays de développement « Gentoo Overlays ». Stuart Herbert, le fondateur du projet, voit ce service, overlays.gentoo.org, comme un moyen de créer un espace où les développeurs et utilisateurs, pourront travailler main dans la main pour améliorer la distribution Gentoo.

Les « Overlays » sont des arbres de paquets externes à l’arbre officiel de portage. Ils sont maintenus et distribués séparement de l’arbre principal. Ils permettent à quiconque de distribuer ses ebuilds pour la distribution Gentoo.

Les environnements de travail, hébergés sur le site overlays.gentoo.org, offrent un espace de test et de developpement pour les équipes de gentoo qui travaillent avec les utilisateurs. Ensemble, les utilisateurs et les développeurs pourront donc travailler sur les nouveaux paquets et améliorer les paquets existants de Gentoo.

• Si tu modifies un ebuild dans /usr/portage, tes changements seront perdus aprés une synchronisation de l’arbre avec emerge —sync. En revanche, si tu le mets dans un overlay, la synchronisation ne touchera pas à ton ebuild.
• Les overlays permettent d’avoir des arbres de développement et de test sans « casser » l’arbre officiel.
• Ils sont facile à diffuser.

Layman est un outil pour gérer les overlays du système Gentoo. On lui donne des adresses correspondant aux fichiers contenant les listes des overlays. Et ensuite, il suffit de lui dire quel overlay télécharger.

L’outil layman posséde un ebuild dans l’arbre officiel, il suffit de passer par emerge pour l’installer :

$ emerge -av layman

Ensuite, vous indiquerez la référence du fichier /usr/portage/local/layman/make.conf qui contient la liste des overlays dans /etc/make.conf :

$ echo "source /usr/portage/local/layman/make.conf" >> /etc/make.conf

Le fichier de configuration de layman est /etc/layman/layman.cfg. Rien de plus simple pour le configurer, il suffit de l’éditer pour ensuite modifier les variables :

• config_dir : Le chemin du répertoire de configuration de layman. Elle sera surement supprimer dans les versions prochaines.
• storage : Le chemin du répertoire contenant les overlays. Par défaut, c’est /usr/portage/local/layman pour une bonne raison : l’arbre officiel peut être sur un serveur nfs ou smb pour n’avoir qu’un arbre pour plusieurs machines. Donc l’overlay ne sera synchronisé qu’une fois pour toutes les machines locales.
• cache : layman va stocker la liste des overlays ici dans chaque fichier cache_*. Vous indiquerez juste le début du chemin. La fin sera complétée par layman par le md5 de l’url.
• local_list : le chemin du fichier qui contiendra la liste des overlays installés sur votre système.
• make_conf : le chemin du make.conf local qui sera modifié par layman à chaque ajout d’overlay. Il contiendra la variable PORTDIR_OVERLAY qui liste les overlays installés. Attention, il ne faut pas oublier d’en faire référence dans le fichier /etc/make.conf.
• overlays : la liste des urls contenant la liste des overlays. Par défaut, il n’y a que http://www.gentoo.org/proj/en/overlays/layman-global.txt.
• proxy : si tu as un proxy, il suffit d’indiquer son adresse. Même si layman supporte le proxy, il ne supporte pas encore l’authentification au proxy.
• nocheck : il faut indiquer si oui (1) ou non (0), layman doit vérifier s’il manque l’url ou la description d’un overlay.

Voici les quelques actions de layman :

• Télécharger ou mettre à jour la liste des overlays :

  $ layman -f

• Afficher la liste des overlays disponibles :

  $ layman -L

• Selectionner et installer un overlay :

  $ layman -a nom_overlay

• Supprimer un overlay du système :

  $ layman -d nom_overlay

• Synchroniser un overlay :

  $ layman -s nom_overlay

• Synchroniser tous les overlays :

  $ layman -S

• Le guide de Gentoo
• Le site officiel