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
- Etre sûr que vos changements suivent les Packaging Guidelines et PackageNamingGuidelines .
- Être avertis des ForbiddenItems et Package Review Guidelines (ils devrons être utilisé pendant la revue du paquet).
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.
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.
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é:
- Visiter la page principale de votre compte système: https://admin.fedora.redhat.com/accounts/
- Cliquer sur 'Apply for a new account' et remplacer les blancs.
- 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!-~
- 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
- En bas, où il est dit "Add new membership", inscrivez cvsextras dans
Groupname. LaissezRole Typecomme user, etRole Domainvide. - Une fois que cela a été envoyé, votre compte sera montré comme "pending" à tous les sponsors Fedora Extras (qui recevrons un email).
- En bas, où il est dit "Add new membership", inscrivez cvsextras dans
- Votre sponsor vous transferera de "pending" à "sponsored". Vous devriez recevoir un email de confirmation de votre sponsor.
- 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.-~
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.
- Vérifiez les derniers fichiers en utilisant cvs:
cvs co owners
- Ensuite, éditez
owners/owners.listet ajoutez une entrée à la liste pour votre nouveau paquet.
- 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