Browse Source

[Chore] modify release doc (#16371)

* modify release doc

* mvn spotless:apply

---------

Co-authored-by: wangxj959 <wangxj959@chinaunicom.cn>
dev
wangxj3 4 months ago committed by GitHub
parent
commit
c0f1269afe
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
  1. 31
      docs/docs/en/contribute/release.md
  2. 34
      docs/docs/zh/contribute/release.md

31
docs/docs/en/contribute/release.md

@ -101,6 +101,17 @@ sub 4096R/A63BC462 2019-11-15
Among them, 85E11560 is public key ID. Among them, 85E11560 is public key ID.
The format has changed after gpg2.0 version
```shell
pub rsa4096 2023-07-01 [SC]
1234ABCD5678EFGH9012IJKL3456MNOP7890QRST
uid [ultimate] ${用户名} <{邮件地址}>
sub rsa4096 2023-07-01 [E]
```
Among them, 1234ABCD5678EFGH9012IJKL3456MNOP7890QRST is public key ID。
#### Upload the Public Key to Key Server #### Upload the Public Key to Key Server
The command is as follow: The command is as follow:
@ -192,6 +203,12 @@ We need to update some documentation before the Maven release. For example, to r
> Note: `VERSION` is a place hold string, is same as the version we set in `VERSION=<THE-VERSION-YOU-RELEASE>`. > Note: `VERSION` is a place hold string, is same as the version we set in `VERSION=<THE-VERSION-YOU-RELEASE>`.
### Modify Correct year in NOTICE file
The NOTICE file needs to be checked, changing the correct year in the second line to the current year. Files to check include
- `dolphinscheduler-dist/release-docs/NOTICE`
- `NOTICE`
### Maven Release ### Maven Release
#### Maven Release Check #### Maven Release Check
@ -468,9 +485,6 @@ svn mv -m "release ${VERSION}" https://dist.apache.org/repos/dist/dev/dolphinsch
# remove old release directory # remove old release directory
svn delete -m "remove old release" https://dist.apache.org/repos/dist/release/dolphinscheduler/<PREVIOUS-RELEASE-VERSION> svn delete -m "remove old release" https://dist.apache.org/repos/dist/release/dolphinscheduler/<PREVIOUS-RELEASE-VERSION>
# Remove prepare branch
cd "${SOURCE_CODE_DIR}"
git push --delete "${GH_REMOTE}" "${VERSION}-prepare"
``` ```
and then find DolphinScheduler in [apache staging repositories](https://repository.apache.org/#stagingRepositories) and click `Release` and then find DolphinScheduler in [apache staging repositories](https://repository.apache.org/#stagingRepositories) and click `Release`
@ -497,14 +511,14 @@ the release version is `<VERSION>`, the following updates are required(note it w
We have a [workflow](../../../../.github/workflows/publish-docker.yaml) to automatically publish Docker images We have a [workflow](../../../../.github/workflows/publish-docker.yaml) to automatically publish Docker images
and a [workflow](../../../../.github/workflows/publish-helm-chart.yaml) to automatically publish Helm Chart to Docker Hub, and a [workflow](../../../../.github/workflows/publish-helm-chart.yaml) to automatically publish Helm Chart to Docker Hub,
after you change the release from "pre-release" to "release", the workflow will be triggered. All you need to do after you create release node, the workflow will be triggered. All you need to do
is to observe the aforementioned workflows, and after they are completed, you can pull the Docker images locally and is to observe the aforementioned workflows, and after they are completed, you can pull the Docker images locally and
verify that they work as expected. verify that they work as expected.
### Send Announcement E-mail Community ### Send Announcement E-mail Community
You should send announcement E-mail after release process finished. The E-mail should send to `dev@dolphinscheduler.apache.org` You should send announcement E-mail after release process finished. The E-mail should send to `dev@dolphinscheduler.apache.org`
and cc to `announce@apache.org`. and cc to `announce@apache.org`, Note: **Mail format requires plain text format**.
Announcement e-mail template as below: Announcement e-mail template as below:
@ -537,6 +551,13 @@ DolphinScheduler Resources:
- Documents: https://dolphinscheduler.apache.org/en-us/docs/<VERSION>/about/introduction - Documents: https://dolphinscheduler.apache.org/en-us/docs/<VERSION>/about/introduction
``` ```
## Remove prepare branch
```shell
cd "${SOURCE_CODE_DIR}"
git push --delete "${GH_REMOTE}" "${VERSION}-prepare"
```
## News ## News
After all set, an article should be written and publish it to the community, it should include: After all set, an article should be written and publish it to the community, it should include:

34
docs/docs/zh/contribute/release.md

@ -107,6 +107,17 @@ sub 4096R/A63BC462 2019-11-15
其中 85E11560 为公钥 ID。 其中 85E11560 为公钥 ID。
gpg2.0版本后格式发生变化
```shell
pub rsa4096 2023-07-01 [SC]
1234ABCD5678EFGH9012IJKL3456MNOP7890QRST
uid [ultimate] ${用户名} <{邮件地址}>
sub rsa4096 2023-07-01 [E]
```
其中1234ABCD5678EFGH9012IJKL3456MNOP7890QRST为公钥 ID。
#### 将公钥同步到服务器 #### 将公钥同步到服务器
命令如下: 命令如下:
@ -198,6 +209,12 @@ SVN_DIR=<PATH-TO-SVN-ROOT> # to keep binary package checkout from SVN, the sub
> 注意:`VERSION` 是一个占位字符串,与我们在 `VERSION=<THE-VERSION-YOU-RELEASE>` 中设置的版本相同。 > 注意:`VERSION` 是一个占位字符串,与我们在 `VERSION=<THE-VERSION-YOU-RELEASE>` 中设置的版本相同。
### 修改NOTICE年份
需要检查NOTICE文件,将第二行中的截止年份修改为当前年份。 需要检查的文件包括
- `dolphinscheduler-dist/release-docs/NOTICE`
- `NOTICE`
### Maven 发布 ### Maven 发布
#### Maven 发布检查 #### Maven 发布检查
@ -351,6 +368,7 @@ svn --username="${A_USERNAME}" commit -m "release ${VERSION}"
- 检查源码包是否包含由于包含不必要文件,致使 tarball 过于庞大 - 检查源码包是否包含由于包含不必要文件,致使 tarball 过于庞大
- 存在`LICENSE`和`NOTICE`文件 - 存在`LICENSE`和`NOTICE`文件
- `NOTICE` 文件中的当前年份
- 只存在文本文件,不存在二进制文件 - 只存在文本文件,不存在二进制文件
- 所有文件的开头都有 ASF 许可证 - 所有文件的开头都有 ASF 许可证
- 能够正确编译,单元测试可以通过 (mvn install) - 能够正确编译,单元测试可以通过 (mvn install)
@ -462,7 +480,7 @@ Thanks everyone for taking time to check this release and help us.
## Announce ## Announce
### Move Packages to Release ### 移动发布包
```shell ```shell
# move to release directory # move to release directory
@ -471,9 +489,6 @@ svn mv -m "release ${VERSION}" https://dist.apache.org/repos/dist/dev/dolphinsch
# remove old release directory # remove old release directory
svn delete -m "remove old release" https://dist.apache.org/repos/dist/release/dolphinscheduler/<PREVIOUS-RELEASE-VERSION> svn delete -m "remove old release" https://dist.apache.org/repos/dist/release/dolphinscheduler/<PREVIOUS-RELEASE-VERSION>
# Remove prepare branch
cd "${SOURCE_CODE_DIR}"
git push --delete "${GH_REMOTE}" "${VERSION}-prepare"
``` ```
在 [apache staging repositories](https://repository.apache.org/#stagingRepositories) 仓库找到 DolphinScheduler 并点击`Release` 在 [apache staging repositories](https://repository.apache.org/#stagingRepositories) 仓库找到 DolphinScheduler 并点击`Release`
@ -498,12 +513,12 @@ git push --delete "${GH_REMOTE}" "${VERSION}-prepare"
我们有一个 [工作流](../../../../.github/workflows/publish-docker.yaml) 来自动发布 Docker 镜像, 我们有一个 [工作流](../../../../.github/workflows/publish-docker.yaml) 来自动发布 Docker 镜像,
以及一个 [工作流](../../../../.github/workflows/publish-helm-chart.yaml) 来自动发布 Helm Chart 到 Docker Hub。 以及一个 [工作流](../../../../.github/workflows/publish-helm-chart.yaml) 来自动发布 Helm Chart 到 Docker Hub。
当你将发版从 "pre-release" 改为 "release" 后,这两个工作流就会被触发。你需要做的就是观察上述的工作流, 当你创建了release node后,这两个工作流就会被触发。你需要做的就是观察上述的工作流,
当它们完成后,你可以在本地拉取 Docker 镜像并验证它们是否按预期工作。 当它们完成后,你可以在本地拉取 Docker 镜像并验证它们是否按预期工作。
### 发送公告邮件通知社区 ### 发送公告邮件通知社区
当完成了上述的发版流程后,需要发送一封公告邮件给社区。你需要将邮件发送到 `dev@dolphinscheduler.apache.org` 并抄送到 `announce@apache.org` 当完成了上述的发版流程后,需要发送一封公告邮件给社区。你需要将邮件发送到 `dev@dolphinscheduler.apache.org` 并抄送到 `announce@apache.org`,注意**邮件格式需要使用纯文本格式**
通知邮件模板如下: 通知邮件模板如下:
@ -536,6 +551,13 @@ DolphinScheduler Resources:
- Documents: https://dolphinscheduler.apache.org/zh-cn/docs/<VERSION>/about/introduction - Documents: https://dolphinscheduler.apache.org/zh-cn/docs/<VERSION>/about/introduction
``` ```
## 删除prepare分支
```shell
cd "${SOURCE_CODE_DIR}"
git push --delete "${GH_REMOTE}" "${VERSION}-prepare"
```
## News ## News
一切就绪后,应该写一篇文章发布到社区,它应该包括: 一切就绪后,应该写一篇文章发布到社区,它应该包括:

Loading…
Cancel
Save