发布团队/仓库

本页面介绍了在`ros2-gbp <https://github.com/ros2-gbp>`_上托管发布仓库的推荐方法。

什么是ROS 2 GBP?

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

什么是发布团队?

发布团队是由一组人负责一个或多个仓库的发布流程的 GitHub 团队 。发布团队通常由一个组织、一个工作组甚至一个个人组成,并以他们所代表的团队或组的名称命名。发布团队及其关联的发布仓库列表在 ros2-gbp-github-org 上进行维护。

您必须是您计划发布项目的发布团队的一部分。 如果您打算在现有团队下发布仓库,请参考 加入发布团队。如果您打算启动一个新团队,请参考 启动新的发布团队

加入一个发布团队

如果您的项目已经有一个发布团队,但您尚未加入其中,请填写 更新发布团队成员问题 问题模板。

创建一个新的发布团队

如果您的项目尚未有发布团队,请填写 新建发布团队问题 问题模板,请求创建一个新的发布团队。

什么是发布仓库?

发布仓库是一个存储从发布流程生成的文件的仓库,供ROS构建工厂使用。

  • 发布仓库存储了发布流程中生成的文件,供ROS构建工厂使用。

  • 发布仓库还缓存了发布流程中的配置,以简化将来对仓库进行的后续发布。

在ROS 2中,将发布仓库与源代码仓库分开是发布的要求。

创建一个新的发布仓库

如果您的仓库对ROS社区是新的,请首先在 ros/rosdistro 上开启一个拉取请求,添加一个 source 条目用于您的仓库。rosdistro数据库的审核过程将确保您的仓库和软件包符合 REP 144软件包命名约定 和其他发布要求。一旦您的软件包名称获得批准并合并,如果您的项目还没有发布仓库,请填写 Add New Release Repositories issue 问题模板。

如果我的现有发布仓库不在ros2-gbp上怎么办?

在ros2-gbp出现之前发布的软件包可能在其他地方托管其发布仓库。现在强烈建议将发布仓库放在这个专用的GitHub组织中。如果您要将ROS 1软件包移植到ROS 2,并计划首次将您的软件包发布到ROS 2中,请按照标准程序请求为您的ROS 2发布获取新的发布仓库。如果您以前发布过ROS 2的软件包,在提出 Add New Release Repositories issue 时,指定您当前的发布仓库URL,并按照其余的标准程序操作。

注解

如果您不打算将存储库发布为Rolling,那么从其他地方托管的发布存储库仍然支持稳定版本。由于从Rolling创建的稳定版本将从ros2-gbp组织中的发布存储库开始,建议您在所有ROS 2版本中使用ros2-gbp发布存储库,以避免发布信息的分散。

在未来,ros2-gbp发布存储库可能成为硬性要求,并且为所有ROS 2版本维护单个发布存储库可以简化Rolling版本维护人员和软件包维护人员对发布的维护。