--- title: "How to create a release" kind: doc --- ## How to create a release This guide will walk you through the process of creating a release candidate. Once the release candidate has passed a successful vote you can then [publish the release](/docs/committers/HowToPublish/) ### Preparing the Release 1. Create a branch from TRUNK to branches/N.x where N is the version you are attempting to release. For instance, 0.5.x or 1.2.x. 1. Check out the new branch locally. 1. Update Version Info: 1. configure.ac's [thrift] variable to the version you are releasing 1. update language related files that contain version info, see [How To Version](/docs/committers/HowToVersion/) 1. commit these change 1. Generate the contents of the CHANGES file. 1. Run ./bootstrap.sh && ./configure 1. Run "make dist". This should produce thrift-[version].tar.gz in the root of your project. 1. Change the name of thrift-[version].tar.gz to thrift-[version]-rc[release candidate num].tar.gz. The release candidate numbers should start at zero. 1. Sign the tarball: gpg -ba [tarball.tar.gz] > [tarball.tar.gz].asc 1. Compute the sha1 and md5 hashes of the tarball: sha1 [tarball.tar.gz] > [tarball.tar.gz].sha1 && md5 [tarball.tar.gz] > [tarball.tar.gz].md5 1. Copy the tarball, signature, and hashes to somewhere public. Recommended place is release managers people.apache.org:~/public_html folder 1. Write an email to thrift-dev mailing list with the following information: 1. The SVN branch that contains the code you're releasing 1. The link to download the tarball and signature 1. The md5 and or sha1 hashes 1. Language formally proposing that the tarball be accepted as the release at such-and-such version 1. After this vote has been open for 72 hours, check if it has passed. 1. If the vote has passed, congratulations, you have a valid release. Now you are ready to [publish the release](/docs/committers/HowToPublish/) ### Creating a binary version of thrift compiler for Windows 1. unpack release tarball: tar -xzf thrift-[version].tar.gz ; cd thrift-[version]/ 1. cross compile using i586-mingw32msvc 1. sh contrib/mingw-cross-compile.sh 1. cp thrift.exe thrift-[version].exe 1. Sign the exe: gpg -ba [thrift-[version].exe] > [thrift-[version].exe].asc 1. Compute the sha1 and md5 hashes of the tarball: sha1 [thrift-[version].exe] > [thrift-[version].exe].sha1 && md5 [thrift-[version].exe] > [thrift-[version].exe].md5