From Fedora Project Wiki
Old page
This page has been marked as "old", and likely contains content that is irrelevant or incorrect. If you can, please update this page. This page will be deleted if action is not taken.

= Contribuer à Fedora Extras =

Bon, vous avez décidé de devenir un contributeur à Fedora Extras ? Ce guide vous mènera à soumettre votre premier paquet.

Devenir un contributeur Fedora Extras

Lire les Guidelines

Liser les Packaging Guidelines et Package Naming Guidelines .

Vous avez besoin d'être familier avec ceux-ci. Ils sont là pour gouverner toutes les soumissions de paquets. Si vous avez des questions, n'ailler pas peur, demander!

Créer un compte sur Bugzilla

Faite en sort d'être sûr d'avoir un compte sur Bugzilla .

L'adresse email que vous utilisez pour votre compte bugzilla doit être la même adresse que vous utilisez pour toutes les choses relatives à Fedora Extras.

Joindre la Mailing List

Joigniez la fedora-extras-list@redhat.com mailing list.

Si vous avez des questions à propos du processus de paquagement, c'est l'endroit pour demander.

Joigniez la fedora-extras-commits@redhat.com mailing list.

La mailing list des commits est requise si vous voullez commiter des paquets.

Joigniez la fedora-maintainers@redhat.com mailing list.

Tous les paquets doivent être souscrits sur cette liste pour des annonces et discussions.

Lire les autres soumissions

Lisez les autres soumissions de paquets pour apprendre et vous familiariser avec le processus de paquagement et les autres exigences.

Faire un paquet

Vous devez être sûr qu'il s'agit d'un nouveau paquet. Une liste des paquets qui existe dans Fedora Extras est disponible à: http://cvs.fedora.redhat.com/viewcvs/owners/owners.list?root=extras&view=markup

Uploader votre paquet

Uploader vos fichiers SRPM et SPEC quelque part sur internet. Cela peut être juste pour disposer d'un acces publique.

Créer votre demande de revue

Completer ce formulaire: https://bugzilla.redhat.com/bugzilla/enter_bug.cgi?product=Fedora&format=extras-review

  • Soyer sûr que vous déposez le nom du paquetdans le champ 'Sommaire de la revue', avec une brève descriptionde ce qu'est le paquetage.
  • Déposer une description de votre paquet (usuellement, cela peut être la même chose que vous avez mis dans le champ %description du fichier spec) dans le champs 'Description de la revue'. Incluez les URLs de vos SRPM et fichier SPEC. En outre, expliquer que c'est votre premier paquet et que vous avez besoin d'un sponsor.
Soyer sûr que votre mention dans le champ 'Review Description' est indiquée de telle sorte à faire savoir que c'est votre premier paquet, et que vous cherchez un sponsor. Dans Fedora Extras, tous les nouveaux contributeurs doivent sponsoriser.

Le processus de revue est décrit en détail sur les pages Package Review Guidelines .

Montrer votre rapport

Montrer le rapport Bugzilla pour votre premier paquet. Vous devriez obtenir des notifications des changements par email. Fixer alors toutes les erreurs que le(s) vérificateur(s) aura(ont) trouvées.

Obtenir un Sponsor

Quand le paquet est APPROUVÉ par le reviewer, cette personne vous sponsorise.

Les premières reviews pour les nouveaux packagers doiventêtre faites par des sponsors enregistrés.

La liste des sponsors actuels est disponible en ligne: List of Sponsors

Le statut de Sponsor est donné aux contributeurs qui ont une longue expérience avec la revue de paquet.

Obtenir un compte Fedora

Créer un compte dans le système de compte Fedora quand vous avez trouvé un sponsor et que votre paquet à été approuvé:

  1. Visiter la page principale de votre compte système: https://admin.fedora.redhat.com/accounts/
  2. Cliquer sur 'Apply for a new account' et remplacer les blancs.
  3. Après avoir créé un compte, une demande par email contenant les instructions à signer Contributor License Agreement vous sera proposé (CLA): https://admin.fedora.redhat.com/accounts/send-cla.cgi

~-Ne cliquer qu'une seule fois!-~

  1. Une fois que vous avez obtenu un email confirmant que votre compte a bien été créé, retourné éditer votre compte: https://admin.fedora.redhat.com/accounts/userbox.cgi?_edit=1
    1. En bas, où il est dit "Add new membership", inscrivez cvsextras dans Groupname. Laissez Role Type comme user, et Role Domain vide.
    2. Une fois que cela a été envoyé, votre compte sera montré comme "pending" à tous les sponsors Fedora Extras (qui recevrons un email).
  2. Votre sponsor vous transferera de "pending" à "sponsored". Vous devriez recevoir un email de confirmation de votre sponsor.
  3. Générer un certificat coté client: https://admin.fedora.redhat.com/accounts/gen-cert.cgi

Placer le fichier dans ~/.fedora.cert, ou la configuration Fedora CVS sera regardé par défaut.

Installer les outils client de construction système

Suivez ces instructions: Extras/BuildSystemClientSetup

  • C'est important. Sans cela, vous ne serez pas apte à faire des requêtes de compilation de paquet.

Configurer votre système pour le CVS Fedora Extras

Vous avez besoin d'installer le paquet cvs depuis Fedora Core.

Votre tâche sera plus facile si vous avez un environnement de variables approprié:

export CVS_RSH=ssh
export CVSROOT=:ext:<USERNAME>@cvs.fedoraproject.org:/cvs/pkgs

~-Soyez sûr de remplacer <USERNAME> avec votre le nom de votre compte système.-~

Vous pouvez faire cela dans ~/.bash_profile pour avoir cela automatiquement lors de votre connexion.
Lancer ssh-add avant de faire n'importe quelles opérations est une très bonne idée. Cela vous sauvera et vous n'aurez pas à retaper votre mot de passe pour chaque opération. Vous devez seulement lancer une fois ssh-add par session, Il se rappelera jusqua votre log out ou reboot.

Importez votre Paquet

Utilisez cvs pour vérifier:

cvs co common

~-Il ne pourrait pas être une bonne idée de créer un répertoire "cvs", vérifier ensuite vos fichiers à l'intérieur de quoi.-~

Une fois que vous avez le répertoire common/, vous pouvez ensuite lancer:

./common/cvs-import.sh <nameofyour.src.rpm>

~-Evidemment, remplacez <nameofyour.src.rpm> avec votre chemin complet à votre fichier SRPM approuvé.-~

Vous pouvez voir qu'il a créé le nouveau module CVS, téléchargé les sources, et terminé avec succès.

Les paquets approuvés le sont pour toutes les branches (FC-3, FC-4, etc), mais, par défaut, les nouveaux imports auront une branche développement. Ne paniquez pas, vous pouvez (et cela devrait probablement) faire une demande pour les branches additionelles plus tard.

Identifiez vous comme le propriétaire du paquet

Ajoutez une entrée au fichier owners.list.

  1. Vérifiez les derniers fichiers en utilisant cvs:
    cvs co owners
  2. Ensuite, éditez owners/owners.list et ajoutez une entrée à la liste pour votre nouveau paquet.
Faite attention à propos du wrapping de ligne dans votre éditeur de texte! Ill-placed line endings are bad.
Please keep the list sorted, with uppercase and lowercase letters sorted equally (so "Tiger" would go between "tarzan" and "tijauna").
  1. Finallement, validez les changements en allant dans votre répertoire / et lancez:
    cvs commit

Cela créera un composant Bugzilla component pour votre paquet.

Demande additionnelle de nouvelles branches

Par défaut, les nouveaux modules ont seulement une branche "devel". Vous voulez probablement de nouvelles branches pour les derniers couples de releases.

Placez votre demande chez: Extras/CVSSyncNeeded

Quand votre demande a été dégagée depuis la page ["Extras/CVSSyncNeeded"] , la nouvelle branche aura été créée, et vous serez prêt à faire un checkout de votre module depuis le CVS:

cvs co <packagename>

~-Ou <packagename> devra être remplacé avec le nom de votre paquet.-~

Vous devriez maintenant avoir un nouveau répertoire nommé après votre paquet avec un répertoire pour chaque branches à l'intérieur de celui-ci.

Nommer vos branches

Les branches sont FC-#, devel, etc.

Avant une branche pouvait être construite dans le Fedora Extras build system, les fichiers dans cette branche doivent être marqué en CVS. Quand vous êtes content avec les sources, aller dans le répertoire de la branche (e.g. cd devel/) et lancer:

make tag

Vous pourrez voir que cela marquera la branche avec la version et la sortie depuis le fichier SPEC. Vous avez besoin de marquer toutes les branches que vous voulez construire.

Demande de construction

Pour chaque branche marquée dont vous voulez demander la construction, allez dans le répertoire de la branche (e.g. cd devel/) et lancer:

make build

Si tout se passe bien, c'est que la branche devrait être en file d'attente pour la construction, le paquet sera proprement compilé, et vous serez OK!

Si la construction échoue, le système de construction vous enverra un email avec un rapport d'erreurs que vous pourrez voir dans les logs. Commitez chaque besoin de changements sur le cvs, incrémentez le numéro de release du fichier SPEC, remarquez branche, et demandez une nouvelle compilation.

Nettoyez

Fermer le ticket Bugzilla quand votre paquet a été compilé avec succès. Retenez le ticket Bugzilla pour votre review? Vous devrez fermer celui si comme NEXTRELEASE.

Obtenir de l'aide

Nous savons que ce processus peut être laborieux parfois, et nous sommes toujours prêt à essayer de rendre celui-ci meilleur. Si vous rencontrez des problèmes, ou que vous avez des questions, s'il vous plaît demandez sur la fedora-extras-list mailing list ou sur #fedora-extras sur freenode . Regarder la page Communicate pour plus de détailes.

Le projet Fedora Mentors à des personnes disposées à aider les nouveaux contributeurs dans leurs efforts de paquagements. Visitez la page Mentors pour plus d'informations.

Il y a aussi une FAQ CVS ici: Extras/UsingCvsFaq