Git 开发流程 git-flow

Git-Flow是什么

Git 诸多命令就像一个个零件,代码管理是够用的。但是工程化代码管理尤其是团队协作的工程化,就需要这些零件整合起来,形成一套工作流。Git Flow 就是这么一套工具。

http://danielkummer.github.io/git-flow-cheatsheet/index.zh_CN.html

安装

brew install git-flow-avh

初始化项目

git flow init
# 然后一路回车

Which branch should be used for bringing forth production releases?
   - main
Branch name for production releases: [main]
Branch name for "next release" development: [develop]

How to name your supporting branch prefixes?
# 功能开发
Feature branches? [feature/]
# bug修复
Bugfix branches? [bugfix/]
# 发布分支
Release branches? [release/]
# hotfix修复
Hotfix branches? [hotfix/]
Support branches? [support/]
# tag前缀,一般可以设为v
Version tag prefix? []
Hooks and filters directory? [/data/demo/.git/hooks]

Hotfix 与 Bugfix 的区别

  • Hotfix 热修复,通常是开发完成就需要立即上线,执行 hotfix finish 的时候就合并进入 main 分支,同时打好tag,就可以发布了。
  • Bugfix 也是修复bug,不是那么紧急,通常可以认为与 feature 功能分支同步开发,最后放在一个 release 进行发布。

Feature 分支新功能开发

开发环节:

  1. 开启一个新分支
  2. 立即推送到远端,避免同事推送了相同的分支
# 开启一个分支
git flow feature start pre-release-config

# 推送提交到远端,效果等同于 git push origin feature/pre-release-config
git flow publish

上线环节:

  1. feature分支开发完成,代码会合并到本地 develop
  2. 开启一个 release 分支,一般分支名为版本号,如:v1.0.0.0
  3. 完成release分支,会新建一个 release 分支命名的 tag 如: v1.0.0.0
  4. 推送 develop 和 main 分支到远端
  5. 将 tag 推送到远端

以上 5 步基本都是直接完成,不会穿插其他环节,完成后线上可以基于 main 分支发布或者基于对应版本的 tag 进行部署发布了。

需要注意的是:在开启 release 分支之前,可以对多个 feature 分支进行合并。

# feature 分支开发完成,代码会合并到 develop
git flow feature finish

# 开启 release 分支
git flow release start v1.0.0.0

# release 分支完成,新建 release 分支命名的 tag 如:v1.0.0.0,并需填写 tag 的备注信息
git flow release finish

# 以上操作除了 git flow publish 都是本地分支进行操作,

# 最后需要推送 develop 和 main 分支以及 tag 到远端
git checkout develop
git push origin develop

git checkout main
git push origin main

git push --tag

Hotfix 分支功能修复

hotfix 与 feature 大同小异,主要差异体现在 release 分支,具体见下文

开发环节:

  1. 开启新分支
  2. 立即推送到到远端,避免同事推送相同的分支
# 开启一个分支
git flow feature start typo-fix

# 推送提交到远端,效果等同于 git push origin hotfix/typo-fix
git flow publish

上线环节:

  1. hotfix 分支开发完成,会直接创建 tag,并且以hotfix分支命名,但是建议带上参数 -T 重新命名
  2. 推送 develop 和 main 分支到远端
  3. 将 tag 推送到远端

可以看到与 feature 开发不同的是,hotfix 不需要通过创建 release,可以快速操作,毕竟我们是修复,需要尽快操作完成上线。

Read more

golang proto api 校验国际化 protovalidate

golang proto api 校验国际化 protovalidate

众所周知,protobuf 原型文件扩展很多功能,比如生成 http 接口层代码,顺势就有了生成接口参数校验代码的需求。 早期可以使用https://github.com/bufbuild/protoc-gen-validate 来实现,通过生成特定的 go 代码的方式来实现校验。 github 中也提到目前趋于稳定,不会有更多新特性的支持,推荐大家使用新的版本 protovalidate,https://github.com/bufbuild/protovalidate 。该版本是protoc-gen-validate 的“精神继承者”。它不需要任何代码生成并支持自定义约束。 现在我们尝试新版本,并且增加国际化支持。 go get github.com/bufbuild/protovalidate-go import "github.com/bufbuild/protovalidate-go" syntax = "proto3"; package

By brian
git clone 复制一个整个仓库并推送到新地址

git clone 复制一个整个仓库并推送到新地址

要使用 git clone --bare 复制一个新的仓库并推送到远程仓库,可以按照以下步骤操作: 1. 克隆一个裸仓库 首先,使用 git clone --bare 命令克隆源仓库。假设源仓库的 URL 是 https://github.com/user/source-repo.git,你可以执行以下命令: bash复制 git clone --bare https://github.com/user/source-repo.git 这将创建一个新的裸仓库(没有工作区),通常会创建一个名为 source-repo.git 的目录。 2. 进入裸仓库目录 进入刚刚克隆的裸仓库目录: bash复制 cd source-repo.git 3. 添加新的远程仓库 接下来,

By brian
搜索引擎技巧不用多,学会 3 个加速 100% 找到目标

搜索引擎技巧不用多,学会 3 个加速 100% 找到目标

在搜索时使用英文关键词,提高结果质量。尽量使用 google.com 以下搜索引擎技巧在 google.com 进行测试,效果都很好,前三个非常常用且强烈推荐。 使用精确搜索 * 建议: 使用双引号 "" 搜索完全匹配的短语,避免无关结果。 * 示例: * "Java NullPointerException" fix * 场景: 找到错误信息的精确解决方案。 利用站内搜索 * 建议: 使用 site: 限制搜索范围到特定网站。 * 示例: * site:stackoverflow.com "TypeError: undefined is not a function" * 场景: 搜索 Stack Overflow、官方文档或技术博客的特定内容。 一些关键词 * 建议:

By brian
沪ICP备2022013452号-1