发版参考 #1035

Code-Fight · 2025-12-20T09:36:49Z

Code-Fight
Dec 20, 2025
Collaborator

1. 发版准备

1. 创建 KEY

安装 GnuPG。

按照 OpenPGP KEY Management [1] 的说明创建 KEY：

gpg --full-gen-key

创建步骤（以下内容来自控制台输出）：

gpg (GnuPG) 2.2.4; Copyright (C) 2017 Free Software Foundation, Inc.
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.

Please select what kind of key you want:
  (1) RSA and RSA (default)
  (2) DSA and Elgamal
  (3) DSA (sign only)
  (4) RSA (sign only)
Your selection? 1
RSA keys may be between 1024 and 4096 bits long.
What keysize do you want? (2048) 4096
Requested keysize is 4096 bits
Please specify how long the key should be valid.
        0 = key does not expire
     <n>  = key expires in n days
     <n>w = key expires in n weeks
     <n>m = key expires in n months
     <n>y = key expires in n years
Key is valid for? (0)
Key does not expire at all
Is this correct? (y/N) y

GnuPG needs to construct a user ID to identify your key.

Real name: （设置用户名）(使用apache id)
Email address: （设置邮件地址）(使用apache邮箱)
Comment: （填写注释）
You selected this USER-ID:
   "用户名 (注释) <邮件地址>"

Change (N)ame, (C)omment, (E)mail or (O)kay/(Q)uit? O
You need a Passphrase to protect your secret key. （设置密码）

2. 检查 KEY

按照 Operational GPG Commands [2] 的说明检查 KEY：

gpg --list-keys

命令输出：

pub   rsa4096 2019-03-11 [SC]
      095E0D21BC28CFC7A8B8076DF7DF28D237A8048C
uid           用户名 (注释) <邮件地址>
sub   rsa4096 2019-03-11 [E]

公钥为 095E0D21BC28CFC7A8B8076DF7DF28D237A8048C。

3. 上传公钥

按照 Dirmngr Options [3] 的说明上传公钥：

gpg --send-key 095E0D21BC28CFC7A8B8076DF7DF28D237A8048C

可以参考:https://github.com/wongoo/apache-release-procedure

2. 准备changeLog

参考既往的发版release准备，中文两个版本

https://github.com/apache/incubator-seata-go/tree/master/changes

准备完，要push到仓库中

3. 准备tag

下载并安装 Git.

创建并切换到 x.x.x 标签. （参考既有的）

git clone https://github.com/apache/incubator-seata-go ~/incubator-seata-go
cd ~/incubator-seata-go/
git checkout master
git tag -a x.x.x -m "x.x.x release seata-go"

提交更新版本号后的代码和新标签。

git push origin --tags

4. push到apache仓库

下载并安装SVN。

1. 更新 KEYS 文件

如果还没有将自己的公钥追加到 KEYS 文件中，请执行以下操作。否则，跳过此步骤。

根据 signing basics 的说明更新 KEYS 文件。

mkdir -p ~/keys/release/
cd ~/keys/release/
svn --username=${LDAP ID} co https://dist.apache.org/repos/dist/dev/incubator/seata/
cd ~/keys/release/
gpg -a --export ${GPG 用户名} >> KEYS
svn --username=${LDAP ID} commit -m "append to KEYS"

2. 添加源码包和二进制文件包

根据 Uploading packages 的说明添加源码包和二进制文件包。

mkdir -p ~/svn_release/dev/
cd ~/svn_release/dev/
svn --username=${LDAP ID} co https://dist.apache.org/repos/dist/dev/incubator/seata/incubator-seata-go/
mkdir -p ~/svn_release/dev/${PUBLISH.VERSION}
git archive --format=tar  --prefix=incubator-seata-go-${PUBLISH.VERSION}/ ${PUBLISH.VERSION} | gzip > incubator-seata-go-${PUBLISH.VERSION}-src.tar.gz
cd ~/svn_release/dev/${PUBLISH.VERSION}
cp -f ~/xxx/shenyu-client-golang/*.src.tar.gz ~/svn_release/dev/${PUBLISH.VERSION}
cp -f ~/xxx/shenyu-client-golang/*.src.tar.gz.asc ~/svn_release/${PUBLISH.VERSION}

3. 添加校验文件

根据 Requirements for cryptographic signatures and checksums [7] 的说明添加校验文件。

shasum -a 512 incubator-seata-go-${PUBLISH.VERSION}-src.tar.gz  > incubator-seata-go-${PUBLISH.VERSION}-src.tar.gz.sha512

4. 提交新版本

cd ~/svn_release/dev/${PUBLISH.VERSION}
svn add ${PUBLISH.VERSION}/
svn --username=${LDAP ID} commit -m "release incubator-seata-go ${PUBLISH.VERSION}"

可以参考：https://shenyu.apache.org/zh/community/release-guide/shenyu-client-golang-release-guide/