Skip to main content

ShenYu client .NET Release Guide

Update release notes#

Update RELEASE-NOTES in the following format:

## ${PUBLISH.VERSION}
### New Features
1. xxx1. xxx...
### API Changes
1. xxx1. xxx...
### Enhancement
1. xxx1. xxx...
### Refactor
1. xxx1. xxx...
### Bug Fix
1. xxx1. xxx...

Create GPG KEY#

Each release manager only creates a GPG KEY for the first release, which can be reused for subsequent releases.

1. Create KEY

Install GnuPG.

Follow OpenPGP KEY Management [1] instructions.

gpg --full-gen-key

Steps (the following are from console output).

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? 1RSA keys may be between 1024 and 4096 bits long.What keysize do you want? (2048) 4096Requested keysize is 4096 bitsPlease 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 yearsKey is valid for? (0)Key does not expire at allIs this correct? (y/N) y
GnuPG needs to construct a user ID to identify your key.
Real name: (Set username) (use your apache id)Email address: (Set email address)(use your apache email)Comment: (Fill in the comments)You selected this USER-ID:   "username (comments) <email>"
Change (N)ame, (C)omment, (E)mail or (O)kay/(Q)uit? OYou need a Passphrase to protect your secret key. (Set password)

2. Verify KEY

Follow Operational GPG Commands [2] instructions.

gpg --list-keys

Output:

pub   rsa4096 2019-03-11 [SC]      095E0D21BC28CFC7A8B8076DF7DF28D237A8048Cuid           username (comments) <email>sub   rsa4096 2019-03-11 [E]

Public key is 095E0D21BC28CFC7A8B8076DF7DF28D237A8048C.

3. Upload public key

Follow Dirmngr Options [3] instructions.

gpg --send-key 095E0D21BC28CFC7A8B8076DF7DF28D237A8048C

Before Release#

1. Publish a new tag

Download and install Git.

Create a new tag called ${PUBLISH.VERSION}.

git clone https://github.com/apache/shenyu-client-dotnet.git ~/shenyu-client-dotnetcd ~/shenyu-client-dotnet/git checkout maingit tag -a v${PUBLISH.VERSION} -m "${PUBLISH.VERSION} release shenyu client dotnet"

Push new created tag to github.

git push origin v${PUBLISH.VERSION}

Publish to SVN dev repository#

Install SVN.

1. Update KEYS file

If the release manager has not yet appended his or her public key to the KEYS file, do the following. Otherwise, skip this step.

Follow signing basics [5] instructions.

mkdir -p ~/keys/release/cd ~/keys/release/svn --username=${LDAP ID} co https://dist.apache.org/repos/dist/release/shenyucd ~/keys/release/shenyugpg -a --export ${GPG username} >> KEYSsvn --username=${LDAP ID} commit -m "append to KEYS"

2. Adding source code packages

Follow Uploading packages [6] instructions.

# create release folder and check out svn dev repomkdir -p ~/svn_release/dev/cd ~/svn_release/dev/svn --username=${LDAP ID} co https://dist.apache.org/repos/dist/dev/shenyumkdir -p ~/svn_release/dev/shenyu/shenyu-client-dotnet/${PUBLISH.VERSION}
# generate source filegit archive --format=tar --prefix=shenyu-client-dotnet-${PUBLISH.VERSION}/ v${PUBLISH.VERSION} | gzip > shenyu-client-dotnet-${PUBLISH.VERSION}-src.tar.gz
# generate sign file for each filesgpg -u <id>@apache.org --armor --output shenyu-client-dotnet-${PUBLISH.VERSION}-src.tar.gz.asc --detach-sign shenyu-client-dotnet-${PUBLISH.VERSION}-src.tar.gz
# copy source files andcd ~/svn_release/dev/shenyu/shenyu-client-dotnet/${PUBLISH.VERSION}cp -f ~/shenyu/shenyu-client-dotnet/shenyu-client-dotnet-${PUBLISH.VERSION}-src.tar.gz ~/svn_release/dev/shenyu/shenyu-client-dotnet/${PUBLISH.VERSION}cp -f ~/shenyu/shenyu-client-dotnet/shenyu-client-dotnet-${PUBLISH.VERSION}-src.tar.gz.asc ~/svn_release/dev/shenyu/shenyu-client-dotnet/${PUBLISH.VERSION}

3. Adding hashes

Follow Requirements for cryptographic signatures and checksums [7] instructions.

# go to release foldercd ~/svn_release/dev/shenyu/shenyu-client-dotnet/${PUBLISH.VERSION}shasum -a 512 shenyu-client-dotnet-${PUBLISH.VERSION}-src.tar.gz > shenyu-client-dotnet-${PUBLISH.VERSION}-src.tar.gz.sha512

4. Submit the new release

cd ~/svn_release/dev/shenyu/shenyu-client-dotnetsvn add ${PUBLISH.VERSION}/svn --username=${LDAP ID} commit -m "release dotnet client ${PUBLISH.VERSION}"

Check Release#

1. Verify sha512 checksum

Follow Checking Hashes [8] instructions.

shasum -c shenyu-client-dotnet-${PUBLISH.VERSION}-src.tar.gz.sha512

2. Verifying GPG Signatures

Follow Checking Signatures [9] instructions.

curl https://downloads.apache.org/shenyu/KEYS >> KEYSgpg --import KEYSgpg --verify shenyu-client-dotnet-source.zip.asc shenyu-client-dotnet-${PUBLISH.VERSION}-src.tar.gz

3. Ensure that SVN is consistent with GitHub source code

Follow Incubator Release Checklist [10] instructions.

wget https://github.com/apache/shenyu-client-dotnet/archive/v${PUBLISH.VERSION}.zipunzip v${PUBLISH.VERSION}.ziptar xzf shenyu-client-dotnet-v${PUBLISH.VERSION}-src.tar.gzdiff -r shenyu-client-dotnet-${PUBLISH.VERSION} shenyu-client-dotnet-v${PUBLISH.VERSION}

4. Check the source code package

Follow Incubator Release Checklist [10] instructions.

  • LICENSE and NOTICE files exist
  • The year in the NOTICE file is correct
  • All files have ASF licenses at the beginning
  • There are no LICENSE and NOTICE that do not depend on the software
  • There are no binaries that do not meet expectations
  • Compilation passes (dotnet build) (.NET 3 or higher is currently supported)
  • If there are third-party code dependencies.
    • License compatibility for third-party code dependencies
    • All licenses of third-party code dependencies are named in the LICENSE file
    • The full version of the third-party code dependency license is in the license directory
    • If the dependency is an Apache license and there are NOTICE files, then these NOTICE files need to be added to the project's NOTICE file

5. Check the binary package

Follow Binary distributions [11] instructions.

  • LICENSE and NOTICE files exist
  • The year in the NOTICE file is correct
  • All text files start with an ASF license
  • No LICENSE and NOTICE for undependent software
  • If third-party code dependencies exist.
    • Third-party code dependent licenses are compatible
    • All licenses of third-party code dependencies are named in the LICENSE file
    • The full version of the third-party code dependency license is in the LICENSE directory
    • If the dependency is an Apache license and there are NOTICE files, then these NOTICE files need to be added to the project's NOTICE file

Voting Process#

Follow RELEASE APPROVAL [12], Releases [13], voting [14] instructions.

ShenYu community vote#

1. Voting lasts for at least 72 hours and receives 3 +1 binding votes

To:

dev@shenyu.apache.org

Title:

[VOTE] Release Apache ShenYu .NET client ${PUBLISH.VERSION}

Content:

Hello ShenYu Community,
This is a call for vote to release Apache ShenYu Client .NET version ${PUBLISH.VERSION}.
Release notes:https://github.com/apache/shenyu-client-dotnet/blob/main/RELEASE-NOTES.md
The release candidates:https://dist.apache.org/repos/dist/dev/shenyu/shenyu-client-dotnet/${PUBLISH.VERSION}/
Git tag for the release:https://github.com/apache/shenyu-client-dotnet/tree/v${PUBLISH.VERSION}
Release Commit ID:https://github.com/apache/shenyu-client-dotnet/commit/xxxxxxxxx

Keys to verify the Release Candidate:https://downloads.apache.org/shenyu/KEYS
Look at here for how to verify this release candidate:https://shenyu.apache.org/community/shenyu-client-dotnet-release-guide/#check-release
The vote will be open for at least 72 hours or until necessary number of votes are reached.
Please vote accordingly:
[ ] +1 approve
[ ] +0 no opinion
[ ] -1 disapprove with the reason
Checklist for reference:
[ ] Download links are valid.
[ ] Checksums and PGP signatures are valid.
[ ] Source code distributions have correct names matching the current release.
[ ] LICENSE and NOTICE files are correct for each ShenYu Client .NET repo.
[ ] All files have license headers if necessary.
[ ] No compiled archives bundled in source archive.

2. Announcement of voting results

To:

dev@shenyu.apache.org

Title:

[RESULT][VOTE] Release Apache ShenYu .NET ${PUBLISH.VERSION}

Content:

We’ve received 3 +1 binding votes and 2 +1 non-binding votes:
+1, xxx (binding)+1, xxx (binding)+1, xxx (binding)+1, xxx (non-binding)+1, xxx (non-binding)
Vote thread:https://lists.apache.org/thread/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Thanks everyone for taking the time to verify and vote for the release!

Finish publishing#

1. Finish SVN release

Follow Uploading packages [6] instructions.

svn mv https://dist.apache.org/repos/dist/dev/shenyu/shenyu-client-dotnet/${PUBLISH.VERSION} https://dist.apache.org/repos/dist/release/shenyu/shenyu-client-dotnet -m "transfer packages for ${PUBLISH.VERSION}"svn delete https://dist.apache.org/repos/dist/release/shenyu/shenyu-client-dotnet/${PREVIOUS.RELEASE.VERSION}

2. Finish NuGet release

Publish this package to the NuGet website.

Package Apache.ShenYu.Client and Apache.ShenYu.AspNetCore.

# goto client foldercd client/Apache.ShenYu.Client
# packagedotnet pack -c Release
# goto AspNetCore foldercd client/Apache.ShenYu.AspNetCore
# packagedotnet pack -c Release

Publish them to NuGet website.

# publish client packagecd client/Apache.ShenYu.Client/bin/Release
dotnet nuget push Apache.ShenYu.Client.<version>.nupkg --api-key <push_api_key> --source https://api.nuget.org/v3/index.json
# publish asp.net core packagecd client/Apache.ShenYu.AspNetCore/bin/Release
dotnet nuget push Apache.ShenYu.AspNetCore.<version>.nupkg --api-key <push_api_key> --source https://api.nuget.org/v3/index.json

3. Finish GitHub release

Edit Releases ${PUBLISH.VERSION} and click release.

4. Update download page

Follow Release Download Pages for Projects [15], Normal distribution on the Apache downloads site [16] instructions.

After the Apache mirror links take effect (at least one hour), update the download page for: English version and Chinese version

Note: Project download links should use https://www.apache.org/dyn/closer.lua instead of closer.cgi or mirrors.cgi

Note: Download links for GPG signature files and hash-check files must use this prefix: https://downloads.apache.org/shenyu/

5. Update documentation

Archive the ${PUBLISH.VERSION} version of the document and update the version page.

6. Update event page

Add new release event.

7. Update news page

Add new release news.

Release Announcement#

Note: announce@apache.org address requires the email to be sent in plain text format. If you are using Gmail, you can check Plain Text Mode in the edit screen.

To:

dev@shenyu.apache.organnounce@apache.org

Title:

[ANNOUNCE] Apache ShenYu Client .NET ${PUBLISH.VERSION} available

Content:

Hi,
Apache ShenYu Team is glad to announce the new release of Apache ShenYu Client .NET ${PUBLISH.VERSION}.
Apache ShenYu is an asynchronous, high-performance, cross-language, responsive API gateway.Support various languages (http protocol), support Dubbo, Spring-Cloud, Grpc, Motan, Sofa, Tars and other protocols.Plugin design idea, plugin hot swap, easy to expand.Flexible flow filtering to meet various flow control.Built-in rich plugin support, authentication, limiting, fuse, firewall, etc.Dynamic flow configuration, high performance.Support cluster deployment, A/B Test, blue-green release.
Download Links: https://shenyu.apache.org/download/
Release Notes: https://github.com/apache/shenyu-client-dotnet/blob/master/RELEASE-NOTES.md
Website: https://shenyu.apache.org/
ShenYu Resources:- Issue: https://github.com/apache/shenyu/issues- Mailing list: dev@shenyu.apache.org- Documents: https://shenyu.apache.org/docs/index/

- Apache ShenYu Team

Reissue (not required)#

Note: You only need to republish if the vote did not pass.

1. Cancellation of voting email template

To:

dev@shenyu.apache.org

Title:

[CANCEL][VOTE] Release Apache ShenYu Client .NET ${PUBLISH.VERSION}

Content:

Hi,
I'm cancelling this vote because of xxxxxx issues. I'll fix them and start the round ${n} vote process.The detail of the modifications are as follows:
1. xxxxxx2. xxxxxx
Thanks a lot for all your help.

2. Clean stagingRepositories

Go to https://repository.apache.org/#stagingRepositories, After logging in with your Apache LDAP account, select the previous Close version and click Drop.

3。Deleting GitHub branches and tags

git push origin --delete ${PUBLISH.VERSION}-releasegit branch -D ${PUBLISH.VERSION}-releasegit push origin --delete tag v${PUBLISH.VERSION}git tag -d v${PUBLISH.VERSION}

4. Deleting SVN content to be published

svn delete https://dist.apache.org/repos/dist/dev/shenyu/shenyu-client-dotnet/${PUBLISH.VERSION} -m "delete ${PUBLISH.VERSION}"

5. Update email title

After completing the above steps, you can start the re-posting operation. The next poll email title needs to have the [ROUND ${n}] suffix added. For example.

[VOTE] Release Apache ShenYu .NET client ${PUBLISH.VERSION} [ROUND 2]

Voting result and announcement emails do not need to be suffixed.

The content refers to