Les surcouches de Gentoo : guide de l'utilisateur

1.  Introduction

Public visé

Ce document a été écrit pour tous les utilisateurs de Gentoo. Si vous êtes un développeur Gentoo ou un membre du staff de Gentoo et que vous désirez gérer votre propre surcouche, veuillez vous réferer au Guide du Développeur.

Que sont les surcouches ?

Les surcouches ou « overlays » sont des arbres de paquets pour Portage. Elles contiennent des ebuilds supplémentaires pour Gentoo. Elles sont gérées par des développeurs Gentoo et les projets, mais sont diffusées séparément de l'arbre principal de Portage.

Pourquoi utiliser les surcouches ?

Les gens créent des surcouches pour toutes sortes de raisons. Voici les principales :

• Si vous modifiez un ebuild dans /usr/portage, votre modification sera perdue dès que vous exécuterez emerge --sync. Toutefois, si vous placez votre modification dans une surcouche, elle ne sera pas écrasée par emerge --sync.
• Puisque les surcouches ne sont pas l'arbre principal de Portage, elles sont un emplacement privilégié pour développer et tester un ebuild sans risquer de compromettre l'arbre principal de Portage.
• Tous les ebuilds ne sont pas adaptés à l'arbre principal de Portage. Une surcouche est un bon emplacement pour stocker un ebuild jusqu'à ce qu'il soit prêt à être intégré dans l'arbre principal de Portage.

Qu'est-ce que le projet Gentoo Overlays ?

Le projet Gentoo Overlays fournit des emplacements de travail pour permettre aux projets, développeurs et utilisateurs de Gentoo de collaborer autour des paquets Gentoo de demain. Nous permettons cela en hébergeant des surcouches pour les projets et les développeurs de Gentoo.

Est-ce que toutes les surcouches officielles sont hébergées sur overlays.gentoo.org ?

Non. Les développeurs Gentoo sont libres de placer leurs surcouches où il leur plaît. Ils ne sont pas forcés d'utiliser overlays.gentoo.org s'ils ne le souhaitent pas.

2.  Débuter avec les surcouches

Gunnar Wrobel a créé Layman pour installer et mettre à jour les surcouches.

Installation de Layman

Pour installer Layman, exécutez les commandes suivantes :

# emerge layman

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

(pour layman 1.2 et supérieur)
# echo "source /usr/local/portage/layman/make.conf" >> /etc/make.conf

Afficher la liste des surcouches disponibles

Pour afficher la liste des surcouches disponibles, exécutez :

# layman -L

Installer une surcouche

Pour installer une surcouche sur votre ordinateur, exécutez 

# layman -a <nom-de-la-surcouche>

Par exemple, pour installer la surcouche du projet PHP de Gentoo, exécutez :

# layman -a php

Installer des paquets depuis une surcouche

Après avoir installé une surcouche, vous pouvez installer des paquets de cette surcouche en exécutant :

# emerge -av <categorie>/<paquet>

Portage parcourt automatiquement l'arbre principal de Portage (dans /usr/portage) et toutes les surcouches que vous avez installées et sélectionne la version la plus récente du paquet.

Si Portage ne sélectionne pas le paquet fourni par la surcouche, c'est en général parce que le paquet est marqué ~arch , où « arch » est l'architecture de votre ordinateur (souvent x86).

Mettre à jour une surcouche

Pour garder les surcouches que vous avez installées à jour, exécutez :

# layman -S

Veuillez ne pas exécuter cette commande plus d'une fois par jour ou vous pourriez mettre trop de pression sur l'infrastructure de Gentoo.

3.  Comment s'investir

Introduction

Tous les développeurs Gentoo ont été des utilisateurs de Gentoo avant de devenir développeurs et sont toujours des utilisateurs. Nos utilisateurs sont la raison pour laquelle Gentoo existe aujourd'hui ; ils sont également nos futurs volontaires.

Si vous commencez à contribuer à un projet, nous vous donnerons un accès en écriture à la surcouche du projet et nous vous fournirons des mentors pour vous aider dans votre contribution. Si nous apprécions votre travail et la façon dont vous le faites, nous pourrions vous inviter à rejoindre l'équipe des développeurs Gentoo.

Comment démarrer

Si vous voulez contribuer à une surcouche, la meilleure méthode est de créer des liens solides avec les développeurs Gentoo responsables de cette surcouche. Vous pouvez découvrir qui est responsable de chaque surcouche en consultant la page de garde d'overlays.gentoo.org et en cliquant sur le lien de la surcouche en question.

Les développeurs peuvent être contactés de différentes manières. Certains sont disponibles sur IRC et ont peut-être même leurs propres salons pour leurs projets. C'est le cas par exemple du projet PHP de Gentoo (#gentoo-php) et du projet Webapps (#gentoo-web). D'autres préfèrent être contactés uniquement par courrier électronique. La seule façon de le découvrir est d'essayer de les contacter. Généralement les personnes présentes sur le canal #gentoo-bugs du réseau IRC Freenode savent comment trouver les responsables en question.

Travailler avec Subversion

Subversion est l'un des progiciels de gestion des versions que nous utilisons pour gérer le contenu de nos surcouches. Si vous n'avez jamais utilisé Subversion auparavant, le livre de Subversion (en anglais) est un excellent moyen d'apprendre à se servir de Subversion. Vous pouvez soit l'acheter au format papier, soit le lire gratuitement en ligne.

Travailler avec Git

Git est un autre progiciel de gestion des versions que nous utilisons pour nos surcouches. Vous pourrez le découvrir et apprendre à l'utiliser grâce au tutoriel fourni sur le site web.

Plus d'information

Le projet Gentoo (ou le développeur) avec lequel vous travaillez devrait être en mesure de vous procurer l'aide et l'assistance dont vous pourriez avoir besoin.

4.  Foire aux questions

Q : Hébergez-vous des surcouches pour les utilisateurs ?

• R : Non. Si vous désirez faire héberger votre propre surcouche sur (git.)overlays.gentoo.org, vous devez d'abord devenir un développeur Gentoo.

Ce document est protégé par la licence Creative Commons : Paternité - Partage des Conditions Initiales à l'Identique 2.5.