Release Process

Make a separate branch named after the release. Merge in org/testing.

Update Version Numbers in the Code

Update the version number on each of these files:

• VERSION
• README
• RELEASE
• debian/appscale_install_functions.sh
• AppController/lib/helperfunctions.rb (change VER_NUM)
• lib/constants.py

Do the same for the tools, changing these files:

• README
• lib/local_state.py (change APPSCALE_VERSION)

EC2 Image

Make an EC2 image with AppScale on it. To do that, first start up a clean Ubuntu Lucid VM by running ec2-run-instances -n 1 -k yourkeyname ami-c7b202ae. Make sure your default security group has port 22 open for ssh, and then log into it when it boots up as the ubuntu user. Then build AppScale in the usual fashion, from your new branches (here, shatterednirvana has pushed branches named 1.6.3):

NOTE: There is now a script available for this build process found in appscale/build_script.sh

apt-get install -y git-core  # installs git
git clone git://github.com/AppScale/appscale.git
cd appscale
git fetch origin 1.6.3
git checkout -b 1.6.3 origin/1.6.3
cd debian
bash appscale_build.sh # this takes about 45 minutes as of 1.6.3

And then build the tools as usual:

cd
git clone git://github.com/AppScale/appscale-tools.git
cd appscale-tools
git fetch origin 1.6.3
git checkout -b 1.6.3 origin/1.6.3
cd debian
bash appscale_build.sh # should be less than a minute as of 1.6.3

Log out of your image, make it into an EBS-backed image, and make it public:

ec2-create-image -n "appscale-1.6.3" <instance_id> # returns an AMI
ec2-modify-image-attribute <ami_id> --launch-permission -a all

And then you're good to go! Wait for the image to become available before you try to use it though. You can check with ec2-describe-instances:

Image not ready:

outer-haven:~ cgb$ ec2-describe-images -o self | grep ami-52912a3b
IMAGE   ami-52912a3b    userid/appscale1.6.3      userid    pending private         x86_64  machine aki-6a0cf803                    ebs     paravirtual     xen

Image is ready:

outer-haven:~ cgb$ ec2-describe-images -o self | grep ami-52912a3b
IMAGE   ami-52912a3b    userid/appscale1.6.3      userid    available       private         x86_64  machine aki-6a0cf803                    ebs     paravirtual     xen

Version Tags

Send a pull request for appscale and appscale-tools to merge in the testing branch with the master branch. Once it's accepted, do a git fetch org && git tag 1.X.Y && git push org --tags on both appscale and appscale-tools.

Also update the appscale-bootstrap app with the new version number once the release has gone live.

Update the "Fast Start" page on http://www.appscale.com/whyappscale with the new AMI.

Update the appscale-filehosting app (the Downloads page) in templates/index.html (search for {% if app_metadatum["version"] != "1.7.0" %}), bump the version number there, and update the app on App Engine.