Releases are managed through an SVN repository. There are two locations where releases can be committed dev and release. Prior to voting a release is staged in the dev folder after a release is approved by the IPMC it is then moved to the release location and committed for distribution. The release folder also holds the GPG public keys that are used for signing release in a KEYS file.
svn checkout https://dist.apache.org/repos/dist/dev/incubator/nuttx nuttx-dev
svn checkout https://dist.apache.org/repos/dist/release/incubator/nuttx nuttx-release
Inside of the dist/release/incubator/nuttx folder is a KEYS file where committers must upload their GPG public key that they use to sign releases. On the top of the file you can see instructions on how to add your key to this file. Be careful to not remove any existing keys. There is a KEYS file in both the dev and releases folder, but uploading to the releases folder is the important one.
If you have not created a GPG key for use with this project see https://infra.apache.org/openpgp.html#generate-key It is important that your Apache email is associated with this key.
My key id is 3554D78458CEB6954B020E12E1B6E30DB05D6280 you can list they keys that you have a secret key for with this command. Make sure your Apache email is associated with this key.
❯ gpg2 --list-secret-keys
/home/bashton/.gnupg/pubring.kbx
--------------------------------
sec> rsa4096 2019-11-24 [SC] [expires: 2021-09-02]
3554D78458CEB6954B020E12E1B6E30DB05D6280
Card serial no. = 0006 09239558
uid [ultimate] Brennan Ashton <btashton@apache.org>
uid [ultimate] Brennan Ashton <bashton@brennanashton.com>
ssb> rsa4096 2019-11-24 [E] [expires: 2021-09-02]
ssb> rsa4096 2019-11-24 [A] [expires: 2021-09-02]
ssb rsa4096 2019-11-24 [S] [expires: 2021-09-02]
You can then use this command to add to the KEYS file (fill in "key id" with your key id):
(gpg --list-sigs <key id> && gpg --armor --export <key id>) >> KEYS
You can verify your key is in the file with:
cat KEYS | gpg2 --import-options show-only
Once you are happy with your changes you can commit your key
svn commit -m "Update <my name> GPG key"
So that the release tags show up as "verified" attach your GPG key to you Apache and GitHub accounts
- GitHub -- https://docs.github.com/en/github/authenticating-to-github/adding-a-new-gpg-key-to-your-github-account
- Apache -- https://id.apache.org add the fingerprint to OpenPGP Public Key Primary Fingerprint
When the project is happy with a release branch and is ready to create a release candidate, the first step is to create a signed tag. This should be done for both the incubator-nuttx and incubator-nuttx-apps repositories.
This is an example for tagging RC0 for the 10.1.0 release. Only the OS repository is shown here this must also be done for the apps repository.
# Checkout the release branch
~/nuttx/wrk/nuttx on releases/10.1 [$]
❯ git checkout releases/10.1
Already on 'releases/10.1'
Your branch is up to date with 'origin/releases/10.1'.
# Make sure it is up-to-date with upstream
~/nuttx/wrk/nuttx on releases/10.1 [$]
❯ git pull
Already up to date.
# Make create the signed tag (note the -s option)
~/nuttx/wrk/nuttx on releases/10.1 [$]
❯ git tag -s nuttx-10.1.0-RC0 -m nuttx-10.1.0-RC0
# Verify the tag is on the correct commit
~/nuttx/wrk/nuttx on releases/10.1 [$]
❯ git log -n 1
commit 16748108c503d762779545d40113825e54b75252 (HEAD -> releases/10.1, tag: nuttx-10.1.0-RC0, origin/releases/10.1)
Author: Dong Heng <dongheng@espressif.com>
Date: Fri Apr 9 20:03:24 2021 +0800
riscv/esp32c3: Fix heap end address
# Push the tag to the apache repository
~/nuttx/wrk/nuttx on releases/10.1 [$]
❯ git push -u origin nuttx-10.1.0-RC0
Enumerating objects: 1, done.
Counting objects: 100% (1/1), done.
Writing objects: 100% (1/1), 805 bytes | 402.00 KiB/s, done.
Total 1 (delta 0), reused 0 (delta 0), pack-reused 0
To github.com:apache/incubator-nuttx.git
* [new tag] nuttx-10.1.0-RC0 -> nuttx-10.1.0-RC0
You should be able to see the tag here https://github.com/apache/incubator-nuttx/tags and https://github.com/apache/incubator-nuttx-apps/tags
Make sure that you have both repositories checked to the correct release candidate tag. The folder names must be nuttx and apps.
~/nuttx/wrk/release
❯ ls
apps nuttx
~/nuttx/wrk/release
❯ git -C nuttx log -n 1
commit 16748108c503d762779545d40113825e54b75252 (HEAD -> releases/10.1, tag: nuttx-10.1.0-RC0, origin/releases/10.1)
Author: Dong Heng <dongheng@espressif.com>
Date: Fri Apr 9 20:03:24 2021 +0800
riscv/esp32c3: Fix heap end address
~/nuttx/wrk/release
❯ git -C apps log -n 1
commit 4348d91d1356335483089c3865282d80f13bedcd (HEAD -> releases/10.1, tag: nuttx-10.1.0-RC0, origin/releases/10.1)
Author: Abdelatif Guettouche <abdelatif.guettouche@espressif.com>
Date: Mon Apr 12 10:11:05 2021 +0200
wireless/wapi/src/wapi.c: When executing a command return it's error code on failure.
Signed-off-by: Abdelatif Guettouche <abdelatif.guettouche@espressif.com>
When creating the release tarballs consider enabling debug mode with the -d flag to make sure everything looks correct including using the correct folders.
Note that here we do not use the RC in the version. If this RC is accepted these exact files will be moved from dev to the release folder, the tarballs are not recreated. Here is an example signing using my key id and the 10.1.0 release:
~/nuttx/wrk/release took 2s
❯ ./nuttx/tools/zipme.sh -d -s -k 3554D78458CEB6954B020E12E1B6E30DB05D6280 10.1.0
+ DEBUG=-d
+ shift
+ '[' '!' -z -s ']'
+ case $1 in
+ sign=1
+ shift
+ '[' '!' -z -k ']'
+ case $1 in
+ shift
+ GPG+=' --default-key 3554D78458CEB6954B020E12E1B6E30DB05D6280'
+ shift
+ '[' '!' -z 10.1.0 ']'
+ case $1 in
+ break
+ VERSION=10.1.0
+ '[' -n 10.1.0 ']'
+ VERSIONOPT='-v 10.1.0'
+ for pat in ${EXCLPAT}
+ TAR+=' --exclude=.github'
+ for pat in ${EXCLPAT}
+ TAR+=' --exclude=.asf.yaml'
+ TAR+=' --exclude-vcs'
+ '[' 0 '!=' 0 ']'
+ TAR+=' -czf'
++ basename ./nuttx/tools/zipme.sh
+ MYNAME=zipme.sh
+ '[' -x /home/bashton/nuttx/wrk/release/zipme.sh ']'
+ '[' -x /home/bashton/nuttx/wrk/release/tools/zipme.sh ']'
+ '[' -x /home/bashton/nuttx/wrk/release/nuttx/tools/zipme.sh ']'
+ TRUNKDIR=/home/bashton/nuttx/wrk/release
+ NUTTXDIR=/home/bashton/nuttx/wrk/release/nuttx
+ APPSDIR=/home/bashton/nuttx/wrk/release/apps
+ '[' '!' -d /home/bashton/nuttx/wrk/release ']'
+ cd /home/bashton/nuttx/wrk/release
+ '[' '!' -d /home/bashton/nuttx/wrk/release/nuttx ']'
+ '[' '!' -d /home/bashton/nuttx/wrk/release/apps ']'
+ echo 'Cleaning the repositories'
Cleaning the repositories
+ '[' 0 '!=' 0 ']'
+ make -C /home/bashton/nuttx/wrk/release/nuttx distclean
+ VERSIONSH=/home/bashton/nuttx/wrk/release/nuttx/tools/version.sh
+ '[' '!' -x /home/bashton/nuttx/wrk/release/nuttx/tools/version.sh ']'
+ /home/bashton/nuttx/wrk/release/nuttx/tools/version.sh -d -v 10.1.0 /home/bashton/nuttx/wrk/release/nuttx/.version
+ shift
+ '[' '!' -z -v ']'
+ case $1 in
+ shift
+ VERSION=10.1.0
+ shift
+ '[' '!' -z /home/bashton/nuttx/wrk/release/nuttx/.version ']'
+ case $1 in
+ break
+ OUTFILE=/home/bashton/nuttx/wrk/release/nuttx/.version
+ '[' -z 10.1.0 ']'
+ '[' -z 10.1.0 ']'
+ '[' -z /home/bashton/nuttx/wrk/release/nuttx/.version ']'
++ echo 10.1.0
++ cut -d. -f1
+ MAJOR=10
+ '[' X10 = X10.1.0 ']'
++ echo 10.1.0
++ cut -d. -f2
+ MINOR=1
+ '[' X10.1 = X10.1.0 ']'
++ echo 10.1.0
++ grep -Eo '[0-9]+\.[0-9]+\.[0-9]+'
++ cut -d. -f3
+ PATCH=0
+ '[' -z '' ']'
++ git -C /home/bashton/nuttx/wrk/release/nuttx/tools log --oneline -1
++ cut '-d ' -f1
+ BUILD=16748108c5
+ '[' -z 16748108c5 ']'
++ git -C /home/bashton/nuttx/wrk/release/nuttx/tools diff-index --name-only HEAD
++ head -1
+ '[' -n '' ']'
+ echo '#!/bin/bash'
+ echo ''
+ echo 'CONFIG_VERSION_STRING="10.1.0"'
+ echo CONFIG_VERSION_MAJOR=10
+ echo CONFIG_VERSION_MINOR=1
+ echo CONFIG_VERSION_PATCH=0
+ echo 'CONFIG_VERSION_BUILD="16748108c5"'
+ chmod 755 /home/bashton/nuttx/wrk/release/nuttx/.version
+ '[' -z 10.1.0 ']'
+ NUTTX_TARNAME=apache-nuttx-10.1.0-incubating.tar
+ APPS_TARNAME=apache-nuttx-apps-10.1.0-incubating.tar
+ NUTTX_ZIPNAME=apache-nuttx-10.1.0-incubating.tar.gz
+ APPS_ZIPNAME=apache-nuttx-apps-10.1.0-incubating.tar.gz
+ NUTTX_ASCNAME=apache-nuttx-10.1.0-incubating.tar.gz.asc
+ APPS_ASCNAME=apache-nuttx-apps-10.1.0-incubating.tar.gz.asc
+ NUTTX_SHANAME=apache-nuttx-10.1.0-incubating.tar.gz.sha512
+ APPS_SHANAME=apache-nuttx-apps-10.1.0-incubating.tar.gz.sha512
+ '[' -f apache-nuttx-10.1.0-incubating.tar ']'
+ '[' -f apache-nuttx-10.1.0-incubating.tar.gz ']'
+ echo 'Removing /home/bashton/nuttx/wrk/release/apache-nuttx-10.1.0-incubating.tar.gz'
Removing /home/bashton/nuttx/wrk/release/apache-nuttx-10.1.0-incubating.tar.gz
+ rm -f apache-nuttx-10.1.0-incubating.tar.gz
+ '[' -f apache-nuttx-apps-10.1.0-incubating.tar ']'
+ '[' -f apache-nuttx-apps-10.1.0-incubating.tar.gz ']'
+ '[' -f apache-nuttx-10.1.0-incubating.tar.gz.asc ']'
+ '[' -f apache-nuttx-apps-10.1.0-incubating.tar.gz.asc ']'
+ '[' -f apache-nuttx-10.1.0-incubating.tar.gz.sha512 ']'
+ '[' -f apache-nuttx-apps-10.1.0-incubating.tar.gz.sha512 ']'
+ echo 'Archiving and zipping nuttx/'
Archiving and zipping nuttx/
++ basename /home/bashton/nuttx/wrk/release/nuttx
+ tar --exclude=.github --exclude=.asf.yaml --exclude-vcs -czf apache-nuttx-10.1.0-incubating.tar.gz nuttx
+ echo 'Archiving and zipping apps/'
Archiving and zipping apps/
++ basename /home/bashton/nuttx/wrk/release/apps
+ tar --exclude=.github --exclude=.asf.yaml --exclude-vcs -czf apache-nuttx-apps-10.1.0-incubating.tar.gz apps
+ echo 'Creating the hashes'
Creating the hashes
+ sha512sum apache-nuttx-10.1.0-incubating.tar.gz
+ sha512sum apache-nuttx-apps-10.1.0-incubating.tar.gz
+ '[' 1 '!=' 0 ']'
+ echo 'Signing the tarballs'
Signing the tarballs
+ gpg -sab --default-key 3554D78458CEB6954B020E12E1B6E30DB05D6280 apache-nuttx-10.1.0-incubating.tar.gz
gpg: using "3554D78458CEB6954B020E12E1B6E30DB05D6280" as default secret key for signing
+ gpg -sab --default-key 3554D78458CEB6954B020E12E1B6E30DB05D6280 apache-nuttx-apps-10.1.0-incubating.tar.gz
gpg: using "3554D78458CEB6954B020E12E1B6E30DB05D6280" as default secret key for signing
+ cd /home/bashton/nuttx/wrk/release/nuttx
~/nuttx/wrk/release took 6s
❯ ls
apache-nuttx-10.1.0-incubating.tar.gz apache-nuttx-10.1.0-incubating.tar.gz.sha512 apache-nuttx-apps-10.1.0-incubating.tar.gz.asc apps
apache-nuttx-10.1.0-incubating.tar.gz.asc apache-nuttx-apps-10.1.0-incubating.tar.gz apache-nuttx-apps-10.1.0-incubating.tar.gz.sha512 nuttx
Prior to uploading the artifacts it is a good idea to make sure that they pass a sanity check. You can do this by running the nuttx/tools/checkrelease.sh script on them.
This will only use the GPG keys at https://dist.apache.org/repos/dist/dev/incubator/nuttx/KEYS so make sure
~/nuttx/wrk/release
❯ ./nuttx/tools/checkrelease.sh --dir ./
gpg: directory '/tmp/nuttx-checkrelease/.gnupg' created
gpg: keybox '/tmp/nuttx-checkrelease/.gnupg/pubring.kbx' created
gpg: /tmp/nuttx-checkrelease/.gnupg/trustdb.gpg: trustdb created
gpg: key E1B6E30DB05D6280: public key "Brennan Ashton <btashton@apache.org>" imported
gpg: Total number processed: 1
gpg: imported: 1
OK: https://dist.apache.org/repos/dist/dev/incubator/nuttx/KEYS is imported.
Checking apache-nuttx-10.1.0-incubating.tar.gz sha512...
OK: apache-nuttx-10.1.0-incubating.tar.gz sha512 hash matches.
Checking apache-nuttx-10.1.0-incubating.tar.gz GPG signature:
gpg: Signature made Sat 17 Apr 2021 08:02:29 PM PDT
gpg: using RSA key 66C4832A165ECC9354895A209750ED7E692B99E2
gpg: Good signature from "Brennan Ashton <btashton@apache.org>" [unknown]
gpg: aka "Brennan Ashton <bashton@brennanashton.com>" [unknown]
gpg: WARNING: This key is not certified with a trusted signature!
gpg: There is no indication that the signature belongs to the owner.
Primary key fingerprint: 3554 D784 58CE B695 4B02 0E12 E1B6 E30D B05D 6280
Subkey fingerprint: 66C4 832A 165E CC93 5489 5A20 9750 ED7E 692B 99E2
OK: apache-nuttx-10.1.0-incubating.tar.gz gpg signature matches.
Checking apache-nuttx-10.1.0-incubating.tar.gz for required files:
OK: all required files exist in nuttx.
Checking apache-nuttx-apps-10.1.0-incubating.tar.gz sha512...
OK: apache-nuttx-apps-10.1.0-incubating.tar.gz sha512 hash matches.
Checking apache-nuttx-apps-10.1.0-incubating.tar.gz GPG signature:
gpg: Signature made Sat 17 Apr 2021 08:02:30 PM PDT
gpg: using RSA key 66C4832A165ECC9354895A209750ED7E692B99E2
gpg: Good signature from "Brennan Ashton <btashton@apache.org>" [unknown]
gpg: aka "Brennan Ashton <bashton@brennanashton.com>" [unknown]
gpg: WARNING: This key is not certified with a trusted signature!
gpg: There is no indication that the signature belongs to the owner.
Primary key fingerprint: 3554 D784 58CE B695 4B02 0E12 E1B6 E30D B05D 6280
Subkey fingerprint: 66C4 832A 165E CC93 5489 5A20 9750 ED7E 692B 99E2
OK: apache-nuttx-apps-10.1.0-incubating.tar.gz gpg signature matches.
Checking apache-nuttx-apps-10.1.0-incubating.tar.gz for required files:
OK: all required files exist in apps.
Trying to build nuttx sim:nsh...
OK: we were able to build sim:nsh.
To stage a release a new folder should be created under https://dist.apache.org/repos/dist/dev/incubator/nuttx for the release candidate and these release artifacts should be copied there:
apache-nuttx-<version>-incubating.tar.gz apache-nuttx-<version>-incubating.tar.gz.sha512 apache-nuttx-apps-<version>-incubating.tar.gz.asc
apache-nuttx-<version>-incubating.tar.gz.asc apache-nuttx-apps-<version>-incubating.tar.gz apache-nuttx-apps-<version>-incubating.tar.gz.sha512
If you checked that svn repository out as shown earlier as nuttx-dev. This should be done like this:
~/nuttx/svn/nuttx-dev
❯ mkdir 10.1.0-RC0
~/nuttx/svn/nuttx-dev
❯ cp -v ../../wrk/release/apache-{nuttx,nuttx-apps}-10.1.0-incubating.tar.gz* ./10.1.0-RC0/
'../../wrk/release/apache-nuttx-10.1.0-incubating.tar.gz' -> './10.1.0-RC0/apache-nuttx-10.1.0-incubating.tar.gz'
'../../wrk/release/apache-nuttx-10.1.0-incubating.tar.gz.asc' -> './10.1.0-RC0/apache-nuttx-10.1.0-incubating.tar.gz.asc'
'../../wrk/release/apache-nuttx-10.1.0-incubating.tar.gz.sha512' -> './10.1.0-RC0/apache-nuttx-10.1.0-incubating.tar.gz.sha512'
'../../wrk/release/apache-nuttx-apps-10.1.0-incubating.tar.gz' -> './10.1.0-RC0/apache-nuttx-apps-10.1.0-incubating.tar.gz'
'../../wrk/release/apache-nuttx-apps-10.1.0-incubating.tar.gz.asc' -> './10.1.0-RC0/apache-nuttx-apps-10.1.0-incubating.tar.gz.asc'
'../../wrk/release/apache-nuttx-apps-10.1.0-incubating.tar.gz.sha512' -> './10.1.0-RC0/apache-nuttx-apps-10.1.0-incubating.tar.gz.sha512'
Then commit these files:
~/nuttx/svn/nuttx-dev
❯ svn status
? 10.1.0-RC0
~/nuttx/svn/nuttx-dev
❯ svn add 10.1.0-RC0/
A 10.1.0-RC0
A 10.1.0-RC0/apache-nuttx-10.1.0-incubating.tar.gz.sha512
A 10.1.0-RC0/apache-nuttx-apps-10.1.0-incubating.tar.gz.sha512
A (bin) 10.1.0-RC0/apache-nuttx-10.1.0-incubating.tar.gz.asc
A (bin) 10.1.0-RC0/apache-nuttx-apps-10.1.0-incubating.tar.gz.asc
A (bin) 10.1.0-RC0/apache-nuttx-10.1.0-incubating.tar.gz
A (bin) 10.1.0-RC0/apache-nuttx-apps-10.1.0-incubating.tar.gz
~/nuttx/svn/nuttx-dev
❯ svn commit -m "Staging apache-nuttx-10.1.0-RC0-incubating"
Verify the release exists under https://dist.apache.org/repos/dist/dev/incubator/nuttx/
To do this send an email that looks something like this:
Subject: [VOTE] Apache NuttX 10.1.0 (incubating) RC0 release
To: dev@nuttx.apache.org
Hello all,
Apache NuttX (Incubating) 10.1.0 RC0 has been staged under [1] and it's
time to vote on accepting it for release. If approved we will seek
final release approval from the IPMC. Voting will be open for 72hr.
A minimum of 3 binding +1 votes and more binding +1 than binding -1 are
required to pass.
The Apache requirements for approving a release can be found here [3]
"Before voting +1 [P]PMC members are required to download the signed
source code package, compile it as provided, and test the resulting
executable on their own platform, along with also verifying that the
package meets the requirements of the ASF policy on releases."
A document to walk through some of this process has been published on
our project wiki and can be found here [4].
[ ] +1 accept (indicate what you validated - e.g. performed the non-RM
items in [4])
[ ] -1 reject (explanation required)
Thank you all,
<Release Manager>
SCM Information:
Release tag: nuttx-10.1.0-RC0
Hash for the release incubating-nuttx tag:
<GIT HASH>
Hash for the release incubating-nuttx-apps tag:
<GIT HASH>
[1] https://dist.apache.org/repos/dist/dev/incubator/nuttx/10.1.0-RC0/
[2]
https://raw.githubusercontent.com/apache/incubator-nuttx/nuttx-10.1.0-RC0/ReleaseNotes
[3] https://www.apache.org/dev/release.html#approving-a-release
[4]
https://cwiki.apache.org/confluence/display/NUTTX/Validating+a+staged+Release
After the voting requirements have been met (see the email text) the release an email is sent closing out the voting.
Example text for that email is here. Note you will have to fill in the vote count and an archive link to the voting thread. The best way to find the link is here https://lists.apache.org/list.html?dev@nuttx.apache.org
Subject: [RESULT] [VOTE] Release Apache NuttX (Incubating) 10.0.0 [RC0]
To: dev@nuttx.apache.org
Hi,
The vote closes now as over 72hr have passed. The vote PASSES with 6
(+6 non-binding) votes from the PPMC,
0 (+1 binding) vote from the IPMC,
1 (+0 non-binding) votes from the developer community,
No further +1, 0 or -1 votes.
The vote thread:
[1]
https://lists.apache.org/thread.html/r301833ea8d93f94d02be1a65e8bc440ab2192216769f3fb02344abae%40%3Cdev.nuttx.apache.org%3E
I will now bring the vote to general@incubator.apache.org to get
approval by the IPMC.
If this vote passes also, the release is accepted and will be
published.
Thanks,
<Release Manager>
After the community vote has closed you can then request a vote by the IPMC. The email is similar to the one sent to the community, but this one needs to include a short description of the project and also a link to the community vote and the results. Here is an example:
Subject: [RESULTS][VOTE] Release Apache NuttX (Incubating) 10.0.0 [RC0]
To: general@incubator.apache.org
Hello all,
This is a call for a vote to release Apache NuttX (Incubating) version
10.1.0.
The Apache NuttX community has voted on and approved a proposal to
release Apache NuttX (Incubating) version 10.1.0.
We now kindly request the Incubator PMC members review and vote on this
incubator release.
NuttX is a real-time operating system (RTOS) with an emphasis on
standards compliance and small footprint. Scalable from 8-bit to 64-bit
microcontroller environments, the primary governing standards in NuttX
are Posix and ANSI standards. Additional standard APIs from Unix and
other common RTOS’s (such as VxWorks) are adopted for functionality not
available under these standards, or for functionality that is not
appropriate for deeply- embedded environments (such as fork()).
Because this project targets embedded systems there is more complexity
involved in the build process.
Apache NuttX community vote and result thread:
Result:
https://lists.apache.org/thread.html/rc5278798aaf12af183a2bcf9f0e771d024fd677cdb8855998afce91c%40%3Cdev.nuttx.apache.org%3E
Vote:
https://lists.apache.org/thread.html/r301833ea8d93f94d02be1a65e8bc440ab2192216769f3fb02344abae%40%3Cdev.nuttx.apache.org%3E
SCM Information:
Release tag: nuttx-10.1.0-RC0
Hash for the release incubating-nuttx tag:
<GIT HASH>
Hash for the release incubating-nuttx-apps tag:
<GIT HASH>
[1] https://dist.apache.org/repos/dist/dev/incubator/nuttx/10.1.0-RC0/
[2]
https://raw.githubusercontent.com/apache/incubator-nuttx/nuttx-10.1.0-RC0/ReleaseNotes
[3] https://www.apache.org/dev/release.html#approving-a-release
[4]
https://cwiki.apache.org/confluence/display/NUTTX/Validating+a+staged+Release
The vote will be open for at least 72 hours.
Please vote accordingly:
[ ] +1 approve
[ ] +0 no opinion
[ ] -1 disapprove with the reason
<Release Manager>
Apache NuttX
This may take longer than 72 hours to get the required votes. Once it has been approved send an email closing out the vote. Here is an example for that email:
Subject: [RESULTS][VOTE] Release Apache NuttX (Incubating) 10.0.0 [RC0]
To: general@incubator.apache.org
Hi all,
The vote to release Apache NuttX (incubating) 10.1.0-rc0 is now closed.
Thanks to those that took the time to review and vote.
The release has passed with 3 +1 (binding) votes and no 0 or -1 votes.
Binding:
+1 Justin Mclean
+1 Duo Zhang
+1 Dave Fisher
Non-Binding
+1 Nathan Hartman
Vote thread
https://lists.apache.org/thread.html/r75faed90e03c7e7a07ff79988bb0586eec224905144f34e99333e9cd%40%3Cgeneral.incubator.apache.org%3E
We will proceed with the official release of 10.1.0.
If the vote does not pass bring the feedback to the community and start the release process again with a new RC.
With the release approved you can now copy the release artifacts to the release repository. Note it no longer has an RC in the folder name.
~/nuttx/svn
❯ cp -r nuttx-dev/10.1.0-RC0 nuttx-release/10.1.0
~/nuttx/svn
❯ cd nuttx-release/
~/nuttx/svn/nuttx-release
❯ svn status
? 10.1.0
~/nuttx/svn/nuttx-release
❯ svn add 10.1.0
A 10.1.0
A (bin) 10.1.0/apache-nuttx-10.1.0-incubating.tar.gz
A (bin) 10.1.0/apache-nuttx-apps-10.1.0-incubating.tar.gz
A 10.1.0/apache-nuttx-10.1.0-incubating.tar.gz.sha512
A 10.1.0/apache-nuttx-apps-10.1.0-incubating.tar.gz.sha512
A (bin) 10.1.0/apache-nuttx-10.1.0-incubating.tar.gz.asc
A (bin) 10.1.0/apache-nuttx-apps-10.1.0-incubating.tar.gz.asc
❯ svn commit -m "Releasing apache-nuttx-10.1.0-incubating"
At this point you should see the release at https://dist.apache.org/repos/dist/release/incubator/nuttx/
Create non RC tags the same way it was done for the RC tags on both repositories
~/nuttx/wrk/nuttx on releases/10.1 [$]
❯ git checkout releases/10.1
Already on 'releases/10.1'
Your branch is up to date with 'origin/releases/10.1'.
# Make sure it is up-to-date with upstream
~/nuttx/wrk/nuttx on releases/10.1 [$]
❯ git pull
Already up to date.
# Make create the signed tag (note the -s option)
~/nuttx/wrk/nuttx on releases/10.1 [$]
❯ git tag -s nuttx-10.1.0 -m nuttx-10.1.0
# Check that botht the RC and non RC tags exist on the commit
~/nuttx/wrk/release/nuttx on releases/10.1 [$] took 4s
❯ git log -n 1
commit 16748108c503d762779545d40113825e54b75252 (HEAD -> releases/10.1, tag: nuttx-10.1.0-RC0, tag: nuttx-10.1.0, origin/releases/10.1)
Author: Dong Heng <dongheng@espressif.com>
Date: Fri Apr 9 20:03:24 2021 +0800
riscv/esp32c3: Fix heap end address
# Push the tag
~/nuttx/wrk/release/nuttx on releases/10.1 [$]
❯ git push -u origin nuttx-10.1.0
Enumerating objects: 1, done.
Counting objects: 100% (1/1), done.
Writing objects: 100% (1/1), 805 bytes | 402.00 KiB/s, done.
Total 1 (delta 0), reused 0 (delta 0), pack-reused 0
To github.com:apache/incubator-nuttx.git
* [new tag] nuttx-10.1.0 -> nuttx-10.1.0
You should be able to see the tag here https://github.com/apache/incubator-nuttx/tags and https://github.com/apache/incubator-nuttx-apps/tags
This should include the release notes and also the metadata for downloading the release. An example of this is here apache/nuttx-website#39 After 48hrs from committing to the release SVN the distribution mirrors should have synced and this can now be merged.
10min or so after the merge you should see the release here https://nuttx.apache.org/download/
Once the website shows the release you can now send the release announcement out. Here is an example of that email. Note we must wait 48hr after the SVN commit before sending this.
Subject: [ANNOUNCE] Apache NuttX 10.0.0-incubating released
To: dev@nuttx.apache.org
The Apache NuttX (incubating) project team is proud to announce
Apache NuttX 10.0.0-incubating has been released.
The release artifacts and Release Notes can be found at:
https://nuttx.apache.org/download/
https://nuttx.apache.org/releases/10.1.0/
Thanks,
<Release Manager>
on behalf of Apache NuttX PPMC