Difference between revisions of "Releasing GotCloud"
From Genome Analysis Wiki
Jump to navigationJump to search(6 intermediate revisions by 2 users not shown) | |||
Line 8: | Line 8: | ||
# I recommend creating a new directory: | # I recommend creating a new directory: | ||
#: <code> cd ~/dev</code> | #: <code> cd ~/dev</code> | ||
− | #: <code> git clone git | + | #: <code> git clone git@github.com:statgen/gotcloud.git</code> |
#: <code> cd gotcloud</code> | #: <code> cd gotcloud</code> | ||
# Build the source | # Build the source | ||
− | #: <code> cd src | + | #: <code> cd src && make && cd ..</code> |
− | |||
# Run the tests, ensure they all succeed | # Run the tests, ensure they all succeed | ||
− | #: <code> | + | #: <code> cd src && make test && cd ..</code> |
− | + | #: <code>./gotcloud test</code> | |
− | |||
− | #: <code>./gotcloud | ||
# Update the version number (if you have not already). | # Update the version number (if you have not already). | ||
#* Edit release_version.txt | #* Edit release_version.txt | ||
Line 28: | Line 25: | ||
#: <code>git checkout latest</code> | #: <code>git checkout latest</code> | ||
#: <code>git merge master</code> | #: <code>git merge master</code> | ||
+ | #: <code>git push</code> | ||
#: <code>git checkout master</code> | #: <code>git checkout master</code> | ||
− | # | + | # Create and push a release tag |
− | |||
#: <code>git tag -a gotcloud.1.XX -m 'version 1.XX'</code> | #: <code>git tag -a gotcloud.1.XX -m 'version 1.XX'</code> | ||
− | |||
#: <code> git push origin gotcloud.1.XX</code> | #: <code> git push origin gotcloud.1.XX</code> | ||
− | # Create the packages | + | # Create the debian packages |
− | + | #* Generate the packages | |
− | + | #*: <code> ./debian/makedeb.sh bin =</code> | |
− | #* Generate the packages | + | #*: <code> ./debian/makedeb.sh test =</code> |
− | #*: <code> / | ||
− | |||
− | #*: <code> | ||
# Generate the release notes on github | # Generate the release notes on github | ||
#: On github, login | #: On github, login | ||
Line 46: | Line 39: | ||
#::* Select the "Tag version" you created | #::* Select the "Tag version" you created | ||
#::* Fill in the release notes | #::* Fill in the release notes | ||
− | # Update wiki release documentation | + | # Update wiki release documentation (for full release) |
#* http://genome.sph.umich.edu/wiki/GotCloud:_Versions | #* http://genome.sph.umich.edu/wiki/GotCloud:_Versions | ||
− | # Send Email to google group | + | # Send Email to google group (for full release) |
#* gotcloud@googlegroups.com | #* gotcloud@googlegroups.com | ||
#* I usually do it from the groups site as an announcement & post on behalf of GotCloud (I may need to modify your permissions to do this) | #* I usually do it from the groups site as an announcement & post on behalf of GotCloud (I may need to modify your permissions to do this) | ||
Line 54: | Line 47: | ||
# Install on mario | # Install on mario | ||
#* In the gotcloud directory where you generated the deb files, run: | #* In the gotcloud directory where you generated the deb files, run: | ||
− | #*: <code>debian/install_gotcloud_without_root.sh 1.16 /net/mario</code> | + | #*: <code>./debian/install_gotcloud_without_root.sh 1.16 /net/mario</code> |
#* Install the latest gotcloud in the gotcloud.old directory (named by version) so someone can run a specific version | #* Install the latest gotcloud in the gotcloud.old directory (named by version) so someone can run a specific version | ||
− | #*: <code>debian/install_gotcloud_without_root.sh 1.16 /net/mario/gotcloud.old</code> | + | #*: <code>./debian/install_gotcloud_without_root.sh 1.16 /net/mario/gotcloud.old</code> |
#* Rename to the version name: | #* Rename to the version name: | ||
#*: <code>mv /net/mario/gotcloud.old/gotcloud /net/mario/gotcloud.old/gotcloud.1.XX</code> | #*: <code>mv /net/mario/gotcloud.old/gotcloud /net/mario/gotcloud.old/gotcloud.1.XX</code> | ||
# Send email to csg group to inform them of the newly installed version on the cluster and of any relevant changes | # Send email to csg group to inform them of the newly installed version on the cluster and of any relevant changes | ||
#* gotcloudUsers@umich.edu | #* gotcloudUsers@umich.edu |
Latest revision as of 22:17, 6 November 2015
Back to parent: GotCloud
Software for GotCloud is kept in a git repository on github.
We also create a Debian package and tar file for GotCloud.
To release a new version of GotCloud:
- I recommend creating a new directory:
cd ~/dev
git clone git@github.com:statgen/gotcloud.git
cd gotcloud
- Build the source
cd src && make && cd ..
- Run the tests, ensure they all succeed
cd src && make test && cd ..
./gotcloud test
- Update the version number (if you have not already).
- Edit release_version.txt
- Commit the new release number
git add release_version.txt
git commit -m "Release 1.XX"
- Push to github
git push
- Checkout latest branch and merge master & push
git checkout latest
git merge master
git push
git checkout master
- Create and push a release tag
git tag -a gotcloud.1.XX -m 'version 1.XX'
git push origin gotcloud.1.XX
- Create the debian packages
- Generate the packages
./debian/makedeb.sh bin =
./debian/makedeb.sh test =
- Generate the packages
- Generate the release notes on github
- On github, login
- Goto Tags, Select "Draft New Release"
- Select the "Tag version" you created
- Fill in the release notes
- Goto Tags, Select "Draft New Release"
- On github, login
- Update wiki release documentation (for full release)
- Send Email to google group (for full release)
- gotcloud@googlegroups.com
- I usually do it from the groups site as an announcement & post on behalf of GotCloud (I may need to modify your permissions to do this)
- Install on mario
- In the gotcloud directory where you generated the deb files, run:
./debian/install_gotcloud_without_root.sh 1.16 /net/mario
- Install the latest gotcloud in the gotcloud.old directory (named by version) so someone can run a specific version
./debian/install_gotcloud_without_root.sh 1.16 /net/mario/gotcloud.old
- Rename to the version name:
mv /net/mario/gotcloud.old/gotcloud /net/mario/gotcloud.old/gotcloud.1.XX
- In the gotcloud directory where you generated the deb files, run:
- Send email to csg group to inform them of the newly installed version on the cluster and of any relevant changes
- gotcloudUsers@umich.edu