发布团队/存储库

本页介绍了在 ros2-gbp 上托管发布存储库的推荐方法。

什么是 ROS 2 GBP？

ros2-gbp 是一个 GitHub 组织，托管 ROS 软件包的发布存储库。它还维护发布团队列表、每个发布团队的成员列表以及发布团队在 https://github.com/ros2-gbp/ros2-gbp-github-org 中维护的发布存储库列表。与 ros2-gbp-github-org 的交互是通过提出 GitHub 问题来完成的。建议您尽早申请加入发布团队并设置发布存储库，因为 ros2-gbp 维护人员可能需要一些时间来响应您的请求。

什么是发布团队？

发布团队是一个 GitHub 团队，由一组负责一个或多个存储库发布过程的人员组成。发布团队通常由组织、工作组甚至个人组成，并以他们所代表的团队或团体命名。发布团队及其相关发布存储库的列表在 ros2-gbp-github-org 中维护。

您必须是您计划为其发布项目的发布团队的一员。 如果您打算在现有团队下发布存储库，请按照：ref：加入发布团队进行操作。如果您打算组建新团队，请按照：ref：组建新发布团队进行操作。

加入发布团队 

如果您的项目已经有一个发布团队，但您不是其中的一员，请填写`更新发布团队成员资格问题<https://github.com/ros2-gbp/ros2-gbp-github-org/issues/new?assignees=&labels=&template=update_release_team_membership.md&title=Update+release+team+membership>`_问题模板

开始新的发布团队 

如果您的项目尚未有发布团队，请填写“新发布团队问题<https://github.com/ros2-gbp/ros2-gbp-github-org/issues/new?assignees=&labels=&template=new_release_team.md&title=Add+release+team>”问题模板以请求创建一个。

什么是发布存储库？

发布存储库是这样一种存储库：

存储发布过程中生成的文件，供 ROS buildfarm 使用
缓存发布过程中的配置，以简化将来存储库的后续发布

在 ROS 2 中发布时，必须将发布存储库与源代码存储库分开。

创建新的发布存储库 

如果您的存储库是 ROS 社区的新存储库，您应该首先在 ros/rosdistro 上打开拉取请求，为您的存储库添加 source 条目（例如 https://github.com/ros/rosdistro/pull/39513）。 rosdistro 数据库的审核过程将确保您的存储库和软件包符合 REP 144 软件包命名约定以及发布前的其他要求。

一旦您的软件包名称获得批准并合并，如果您的项目尚未有发布存储库，请填写添加新发布存储库问题问题模板

如果我现有的发布存储库不在 ros2-gbp 上怎么办？

在 ros2-gbp 存在之前发布的软件包可能将其发布存储库托管在其他地方。

现在强烈建议将发布存储库放在这个专用的 GitHub 组织中。如果您正在将 ROS 1 软件包移植到 ROS 2 并计划首次将软件包发布到 ROS 2，请按照标准程序为您的 ROS 2 版本请求新的发布存储库。如果您之前已经为 ROS 2 发布过软件包，则在提出“添加新发布存储库问题 <https://github.com/ros2-gbp/ros2-gbp-github-org/issues/new?assignees=&labels=&template=new_release_repository.md&title=Add+new+release+repositories>”时，指定您当前的发布存储库 URL，然后按照标准程序完成其余操作。

如果您不打算将存储库发布到 Rolling 中，则在其他地方托管的发布存储库仍受稳定发行版的支持。由于 Rolling 创建的稳定发行版将从 ros2-gbp 组织中的发布存储库开始，因此建议您对所有 ROS 2 发行版使用 ros2-gbp 发布存储库，以避免发布信息分散。

ros2-gbp 发布存储库将来可能会成为一项硬性要求，并且为所有 ROS 2 发行版维护一个发布存储库可简化 Rolling 发行版维护者和软件包维护者的发布维护工作。