tarsdocs
  • Readme.md
  • CLA
  • LICENSE
  • 基础介绍
    • 简介
    • 基础概念
    • 基础通信协议 Tars
    • 统一通信协议 Tup
    • 开发模式介绍
    • 模板配置
    • 服务市场
    • 服务扩展
    • 框架版本说明
  • 开源版框架介绍
    • 开源版本部署
      • 部署总体介绍
      • Docker环境安装
      • Mysql安装
      • 框架源码部署(Linux/Mac)
      • 框架源码部署(Windows)
      • 框架Docker部署
      • 框架节点部署
      • 业务服务容器化
      • 框架K8SDocker 部署
      • 框架K8STARS 部署
      • 框架K8SFramework 部署(强烈推荐)
      • 框架更新及扩容
      • 调用链升级注意事项
      • TarsWeb-v3.0.3升级说明
    • 开源版管理平台
      • TarsWeb说明
      • web用户体系
      • web管理平台 API
  • 企业版本介绍
    • 企业版说明
    • 框架集群化机制
    • 框架单节点机制
    • 使用二进制包部署
    • 使用容器部署
    • 业务服务一主多备机制
    • 命令行控制终端
    • IP-LIST级联缓存机制
    • 多数据中心管理
    • 多网络支持
    • 第三方服务管理
    • 数据产生和管理机制
    • 密码重置
    • TarsPython介绍
  • 框架关键特性
    • 业务配置
    • 服务监控
    • 无损发布/重启
    • 调用链
    • IDC分组
    • 鉴权功能
  • TarsCPP
    • 编译
    • 快速开发入门
    • 使用指南
    • 开发规范
    • 服务线程说明文档
    • protobuf 协议支持文档
    • 第三方协议支持
    • HTTP1 支持
    • HTTP2 支持
    • TLS 通信支持
    • Push 功能说明
    • PushCallback 功能说明
    • Cookie 支持
    • 队列模式
    • 手动绑定
    • 性能数据
    • 2.x 版本变化
    • 3.x 版本变化
    • 协程版本说明
    • 基础类库说明
    • [案例]
      • 框架快速入门
      • Http 服务示例
  • TarsJava
    • 快速开始
    • 快速开发入门
    • [使用指南]
      • Tars 服务开发与上线
      • HTTP 服务开发与上线
      • 生成接口调用文件
    • [性能测试]
      • tars java 压测代码
  • TarsGo
    • 基本介绍
    • 快速开始
    • 使用指南
    • cmake 管理代码
    • pb2tarsgo
    • 性能数据
    • 使用示例
  • TarsPHP
    • 搭建 php 环境
    • 快速开发入门
    • [快速起步]
      • 搭建 HttpServer
      • 搭建 TimerServer
      • 搭建 TcpServer
      • 搭建 WebSocketServer
      • 弹幕活动实战
    • [框架简介]
      • 简介
      • tars-server
      • tars-client
      • tars-config
      • tars-deploy
      • tars-extension
      • tars-log
      • tars-monitor
      • tars-registry
      • tars-report
      • tars-utils
      • tars2php
    • [高阶应用]
      • PHP 的 Swoole 框架如何接入 Tars
      • 与 thinkphp 结合使用
      • 与 Swoft 结合使用
      • 与 Laravel 结合使用
      • 与 Yii2 结合使用
      • 持续集成方案
    • [其他]
      • 常见问题
      • 如何 Debug
      • changelog
      • 其他外部文档
  • Tars.js
    • 基本介绍
    • 脚手架
    • 快速开发入门
    • @tars/stream
    • @tars/rpc
    • @tars/logs
    • @tars/config
    • @tars/monitor
    • @tars/notify
    • @tars/utils
    • @tars/dyeing
    • @tars/node-agent
    • @tars/winston-tars
    • tars2node
  • K8SFramework
    • [安装和使用说明]
      • 介绍
      • 特性
      • 安装
      • 升级
      • 云原生运维
      • 管理平台
      • 证书
    • [开发环境构建]
      • Dockerfile 说明
      • 服务发布流程说明
      • 制作基础编译镜像
      • 制作业务服务镜像
      • 制作 Helm 包
      • 发布业务镜像到 K8S 集群
      • 服务发布示例
      • 如何调试业务服务
  • 服务扩展
    • 云告警
    • 接口及压测工具
    • 网关服务
    • dcache缓存服务
    • 发送邮件服务
    • 一致性存储服务
    • 一致性存储web管理平台
    • 唯一计数服务
  • 常见问题
    • 安装常见问题
    • Issues
    • Issues-tarscpp
    • Issues-tarsjava
    • Issues-tarsgo
    • Issues-tarsphp
  • 开源合作
    • TarsFramework 项目 Git 合作规范
  • 直播视频
    • B 站 TARS 培训系列课程
  • 相关文章
    • TARS 技术文章
  • 其它资源分享
    • 下载
    • Tars 介绍.pptx
    • TarsPHP 解密.pdf
    • TarsJava 本地调试.pdf
    • 微服务在腾讯的业务实践.pptx
Powered by GitBook
On this page
  • 简介
  • 版本规划
  • Git合作规范
  • 特别注意

Was this helpful?

  1. 开源合作

TarsFramework 项目 Git 合作规范

PreviousIssues-tarsphpNextB 站 TARS 培训系列课程

Last updated 3 years ago

Was this helpful?

简介

项目中的TarsRegistry、TarsNode、TarsProperty...等应用依赖于项目,TarsCpp项目依赖于,为TarsFramework的Web管理端,为了更好的提供Tars的多版本支持和迭代,选定v2.4为Tars的第一个LTS版本,并在这第一个LTS版本中将TarsCpp、TarsProtocol、TarsWeb、TarsFramework四个项目的主版本和子版本进行统一。

版本规划

版本号定义:v{主版本}.{子版本}.{build号}

  • 框架起始主版本为v2,子版本为4,子版本兼容的特性优化或bug修复视为一次build,如在v2.4.0基础上修复某个bug或优化了某个特性,版本号从v2.4.0升级为v2.4.1,用户可自行选择版本进行下载使用

  • 根据团队内部规划,后续逐渐开放v2.5、v2.6等框架版本,原则上高版本尽量兼容低版本,不兼容时需要在版本发布时提供用户升级指南

Git合作规范

首先欢迎各位志同道合的伙伴为社区贡献自己的力量,在源码合作时请遵循以下规范

  1. 请先fork对应的GitHub仓库

  2. 在开发之前请谨记,release/x.x为对应版本的发布分支,这个分支相当于单版本项目仓库的master分支

  3. 务必在动手之前先拉取远端仓库对应release分支的最新变动到本地release分支,避免出现合并冲突

  4. 请从本地对应版本的release分支检出一个feature分支进行功能开发,feature分支命名规范为:feature/{Git用户名}/{需求名称},如:feature/franklee/correct_error_message_on_property_table_missing

  5. 若是紧急修复,请检出hotfix分支,命名规范为:hotfix/{Git用户名}/{需求名称},如:hotfix/franklee/fix_wrong_typing_on_servant_status_enum_define

  6. 开发完成后请务必先对对应的feature或hotfix分支进行充分测试

  7. 测试完成后,请将当前的feature分支合并到本地的release分支

  8. 提交Pull Request到远端仓库release分支,并撰写必要说明

详细工作流见下图:

特别注意

  1. 远端仓库:TarsCloud/xxx 的官方仓库

  2. 远端分支:远端仓库TarsCloud/xxx下的分支

  3. 本地仓库:从远端仓库fork出来的仓库

  4. 本地分支:从本地仓库检出的分支

  5. 为了保证master版本与最新版release分支同步,最新版本框架的release版本在发布完成后需要合并到master

  6. 只有新开release版本才需要从master检出

  7. 严禁合并除最新版release分支以外的分支到master

TarsFramework
TarsCpp
TarsProtocol
TarsWeb
Tars Framework Git Flows