Équipe de publication / Référentiel

Table des matières

Qu’est-ce que le ROS 2 GBP ?
Qu’est-ce qu’une équipe de publication ?
- Rejoignez une équipe de publication
- Démarrer une nouvelle équipe de publication
Qu’est-ce qu’un dépôt de version ?
- Créer un nouveau référentiel de version
Que se passe-t-il si mon dépôt de version existant n’est pas sur ros2-gbp ?

Cette page explique la méthode recommandée pour héberger vos dépôts de version sur ros2-gbp.

Qu’est-ce que le ROS 2 GBP ?

ros2-gbp est une organisation GitHub qui héberge les dépôts de version pour les packages ROS. Il maintient également une liste des équipes de publication, la liste des membres par équipe de publication et la liste des référentiels de publication maintenus par les équipes de publication sur https://github.com/ros2-gbp/ros2-gbp-github-org. Les interactions avec ros2-gbp-github-org se font en soulevant des problèmes GitHub. Il est recommandé de demander à rejoindre une équipe de publication et de mettre en place un référentiel de publication tôt car cela peut prendre un certain temps pour que les responsables de ros2-gbp répondent à vos demandes.

Qu’est-ce qu’une équipe de publication ?

Une équipe de publication est une équipe GitHub composée d’un groupe de personnes responsables de la publication processus d’un ou plusieurs référentiels. Les équipes de publication sont souvent constituées d’une organisation, d’un groupe de travail ou même d’un individu, et portent le nom de l’équipe ou du groupe qu’elles représentent. La liste des équipes de publication et leurs référentiels de publication associés sont conservés sur ros2-gbp-github-org.

Vous devez faire partie de l’équipe de publication pour laquelle vous prévoyez de publier le projet. Si vous avez l’intention de publier le référentiel sous une équipe existante, suivez Rejoindre une équipe de publication. Si vous avez l’intention de démarrer une nouvelle équipe, suivez Démarrer une nouvelle équipe de publication.

Rejoignez une équipe de publication 

Remplissez le problème d’adhésion à l’équipe de mise à jour <https://github.com/ros2-gbp/ros2-gbp-github-org/issues/new?assignees=&labels=&template=update_release_team_membership.md&title=Update+release+team+membership >`_ modèle de problème si une équipe de publication existe déjà pour votre projet mais que vous n’en faites pas partie.

Démarrer une nouvelle équipe de publication 

Remplissez le New Release Team issue modèle de problème s’il n’existe pas encore d’équipe de publication pour votre projet, demandez la création d’une nouvelle équipe de publication.

Qu’est-ce qu’un dépôt de version ?

Un référentiel de version est un référentiel qui

stocke les fichiers générés à partir du processus de publication, pour que le buildfarm ROS les utilise
met en cache les configurations du processus de publication pour simplifier les versions ultérieures du référentiel à l’avenir

Disposer d’un référentiel de versions distinct de votre référentiel de code source est une condition préalable à la création d’une version dans ROS 2.

Créer un nouveau référentiel de version 

Si votre référentiel est nouveau dans la communauté ROS, vous devez d’abord ouvrir une demande d’extraction sur ros/rosdistro en ajoutant une entrée source pour votre référentiel. Le processus de révision de la base de données rosdistro garantira que votre référentiel et vos packages sont conformes aux conventions de dénomination des packages REP 144 et aux autres exigences avant la publication. Une fois le nom de votre package approuvé et fusionné, remplissez le problème Add New Release Repositories modèle de problème si vous n’avez pas encore de dépôt de version pour votre projet.

Que se passe-t-il si mon dépôt de version existant n’est pas sur ros2-gbp ?

Les packages publiés avant l’existence de ros2-gbp peuvent avoir leurs référentiels de publication hébergés ailleurs. Il est maintenant fortement recommandé que les référentiels de version vivent dans cette organisation GitHub dédiée. Si vous transférez un package ROS 1 vers ROS 2 et prévoyez de publier vos packages dans ROS 2 pour la première fois, suivez la procédure standard pour demander un nouveau référentiel de versions pour vos versions ROS 2. Si vous avez déjà publié vos packages pour ROS 2, lorsque vous soulevez le problème Add New Release Repositories, spécifiez l’URL de votre référentiel de version actuel et suivez la procédure standard pour le reste.

Note

Les référentiels de publication hébergés ailleurs sont toujours pris en charge pour les distributions stables si vous ne prévoyez pas de publier le référentiel dans Rolling. Étant donné que les distributions stables créées à partir de Rolling commenceront par des référentiels de version dans l’organisation ros2-gbp, il est recommandé d’utiliser les référentiels de version ros2-gbp pour toutes les distributions ROS 2 afin d’éviter de fragmenter les informations de version.

Un référentiel de versions ros2-gbp peut devenir une exigence absolue à l’avenir et le maintien d’un référentiel de versions unique pour toutes les distributions ROS 2 simplifie la maintenance des versions pour les responsables de la distribution Rolling et les responsables des packages.