This is an automated email from the ASF dual-hosted git repository. shuai pushed a commit to branch how-to-release in repository https://gitbox.apache.org/repos/asf/incubator-answer-website.git
commit b9cfce6f569d430bece90889e6983f0dbeb1d469 Author: shuai <[email protected]> AuthorDate: Mon May 27 15:34:27 2024 +0800 fix: update release docs --- community/contributing/how-to-release.md | 26 ++++++++++++++++++++++---- static/img/community/release.jpeg | Bin 0 -> 237906 bytes static/img/community/vote-tread-link.jpeg | Bin 0 -> 85061 bytes 3 files changed, 22 insertions(+), 4 deletions(-) diff --git a/community/contributing/how-to-release.md b/community/contributing/how-to-release.md index b275f855..64727477 100644 --- a/community/contributing/how-to-release.md +++ b/community/contributing/how-to-release.md @@ -25,16 +25,17 @@ All Apache projects are required to follow the [Apache Release Policy](https://w 1. Create a GPG key if you don't have one. 2. Add the GPG key to the KEYS file. -3. Sign the release artifacts with the GPG key. +3. Sign the release artifacts with the GPG key. **Be careful to check that the binary file is complete to avoid a size of 0.** ```shell -# create a GPG key +# create a GPG key, after executing this command, select the first one RSA 和 RSA $ gpg --full-generate-key # list the GPG keys $ gpg --keyid-format SHORT --list-keys # upload the GPG key to the key server, xxx is the GPG key id +# eg: pub rsa4096/4C21E346 2024-05-06 [SC], 4C21E346 is the GPG key id; $ gpg --keyserver keyserver.ubuntu.com --send-key xxx # append the GPG key to the KEYS file the svn repository @@ -43,7 +44,7 @@ $ svn co https://dist.apache.org/repos/dist/release/incubator/answer/ $ (gpg --list-sigs [email protected] && gpg --export --armor [email protected]) >> KEYS $ svn ci -m "add gpg key" -# sign the release artifacts +# sign the release artifacts, xxxx is [email protected] $ for i in *.tar.gz; do echo $i; gpg --local-user xxxx --armor --output $i.asc --detach-sig $i ; done ``` @@ -58,9 +59,11 @@ $ for i in *.tar.gz; do echo $i; sha512sum $i > $i.sha512 ; done 1. Create a directory for the release artifacts in the svn repository. 2. Upload the release artifacts to the svn repository. +3. release-version format： 1.3.1-incubating The release artifacts should be uploaded to the `https://dist.apache.org/repos/dist/dev/incubator/answer/{release-version}` directory. + ```shell $ svn co https://dist.apache.org/repos/dist/dev/incubator/answer/ $ cp /path/to/release/artifacts/* ./{release-version}/ @@ -68,6 +71,11 @@ $ svn add ./{release-version}/* $ svn commit -m "add Answer release artifacts for {release-version}" ``` +**IMPORTANT** After completion, visit the link `https://dist.apache.org/repos/dist/dev/incubator/answer/{release-version}` to check whether the file upload is correct. + + + + ## Verify the release artifacts Following is the basic check items for the release artifacts. @@ -121,6 +129,16 @@ $ for i in *.tar.gz; do echo $i; sha512sum --check $i.sha512; done ### Vote email template +**NOTICE** Directly copying the email content will cause the format to be incorrect. It is recommended to copy the email to a `.txt` file. After writing the content, copy it into the email tool you are using. `The vote tread` and `Vote Result` is not needed during the first round of voting in dev. + +How to get the link to The vote thread： +1. Find the email you sent from the apache mailing list. +2. Click the link button below the email to get the link you need. + + + + + ```text [VOTE] Release Apache Answer (Incubating) {release-version} @@ -147,7 +165,7 @@ Hello, https://github.com/apache/incubator-answer/commit/{id} Keys to verify the Release Candidate: - https://dist.apache.org/repos/dist/dev/incubator/answer/KEYS + https://downloads.apache.org/incubator/answer/KEYS The vote will be open for at least 72 hours or until the necessary number of votes are reached. diff --git a/static/img/community/release.jpeg b/static/img/community/release.jpeg new file mode 100644 index 00000000..8291f3ec Binary files /dev/null and b/static/img/community/release.jpeg differ diff --git a/static/img/community/vote-tread-link.jpeg b/static/img/community/vote-tread-link.jpeg new file mode 100644 index 00000000..86238122 Binary files /dev/null and b/static/img/community/vote-tread-link.jpeg differ
