Releasing GotCloud - Revision history

Pjvh at 02:17, 7 November 2015

2015-11-07T02:17:47Z

← Older revision		Revision as of 22:17, 6 November 2015
Line 11:		Line 11:
	#: <code> cd gotcloud</code>		#: <code> cd gotcloud</code>
	# Build the source		# Build the source
	#: <code> cd src~~</code>~~		#: <code> cd src && make && cd ..</code>
	~~#: <code>~~ make</code>
	# Run the tests, ensure they all succeed		# Run the tests, ensure they all succeed
	#: <code>~~./gotcloud align --~~test ~~testDir</code>~~		#: <code> cd src && make test && cd ..</code>
	~~#: <code>~~.~~/gotcloud snpcall --test testDir</code>~~		#: <code>./gotcloud test</code>
	~~#: <code>~~.~~/gotcloud ldrefine --test testDir~~</code>
	#: <code>./gotcloud ~~indel --~~test ~~testDir~~</code>
	# 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

Pjvh at 07:53, 29 October 2015

2015-10-29T07:53:53Z

← Older revision		Revision as of 03:53, 29 October 2015
Line 35:		Line 35:
	# Create the debian packages		# Create the debian packages
	#* Generate the packages		#* Generate the packages
	#*: <code> debian/makedeb.sh bin =</code>		#*: <code> ./debian/makedeb.sh bin =</code>
	#*: <code> debian/makedeb.sh test =</code>		#*: <code> ./debian/makedeb.sh test =</code>
	# Generate the release notes on github		# Generate the release notes on github
	#: On github, login		#: On github, login
Line 50:		Line 50:
	# 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

Pjvh at 07:40, 29 October 2015

2015-10-29T07:40:31Z

← Older revision		Revision as of 03:40, 29 October 2015
Line 29:		Line 29:
	#: <code>git merge master</code>		#: <code>git merge master</code>
	#: <code>git push</code>		#: <code>git push</code>
			#: <code>git checkout master</code>
	# Create and push a release tag		# 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>

Pjvh at 07:38, 29 October 2015

2015-10-29T07:38:56Z

← Older revision		Revision as of 03:38, 29 October 2015
Line 29:		Line 29:
	#: <code>git merge master</code>		#: <code>git merge master</code>
	#: <code>git push</code>		#: <code>git push</code>
	# Create a release tag		# 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>
	~~# Push tag~~
	#: <code> git push origin gotcloud.1.XX</code>		#: <code> git push origin gotcloud.1.XX</code>
	# Create the debian packages		# Create the debian packages

Pjvh at 07:34, 29 October 2015

2015-10-29T07:34:48Z

← Older revision		Revision as of 03:34, 29 October 2015
Line 28:		Line 28:
	#: <code>git checkout latest</code>		#: <code>git checkout latest</code>
	#: <code>git merge master</code>		#: <code>git merge master</code>
	~~#: <code>git checkout master</code>~~
	#: <code>git push</code>		#: <code>git push</code>
	# Create a release tag		# Create a release tag

Pjvh at 07:29, 29 October 2015

2015-10-29T07:29:05Z

← Older revision		Revision as of 03:29, 29 October 2015
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~~://~~github.com/statgen/gotcloud.git</code>		#: <code> git clone git@github.com:statgen/gotcloud.git</code>
	#: <code> cd gotcloud</code>		#: <code> cd gotcloud</code>
	# Build the source		# Build the source

Mktrost at 03:00, 29 October 2015

2015-10-29T03:00:38Z

← Older revision		Revision as of 23:00, 28 October 2015
Line 34:		Line 34:
	# Push tag		# Push tag
	#: <code> git push origin gotcloud.1.XX</code>		#: <code> git push origin gotcloud.1.XX</code>
	# Create the packages ~~(debian and tar)~~		# Create the debian packages
	~~#* cd to one directory above gotcloud~~		#* Generate the packages
	~~#*: <code> cd ..</code>~~		#*: <code> debian/makedeb.sh bin =</code>
	#* Generate the packages ~~& copy to ftp://share.sph.umich.edu/gotcloud/ (all done for you by the script)~~		#*: <code> debian/makedeb.sh test =</code>
	#*: <code> /~~net/wonderland/home/mktrost/gc-admin/genDebs~~.sh</code>
	~~#* at prompt, enter:~~
	#*: <code>y</code>
	# Generate the release notes on github		# Generate the release notes on github
	#: On github, login		#: On github, login
Line 46:		Line 43:
	#::* 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)

Mktrost at 19:15, 26 February 2015

2015-02-26T19:15:22Z

← Older revision		Revision as of 15:15, 26 February 2015
Line 58:		Line 58:
	#*: <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/~~gotcoud~~.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

Mktrost at 19:14, 26 February 2015

2015-02-26T19:14:40Z

← Older revision		Revision as of 15:14, 26 February 2015
Line 43:		Line 43:
	# Generate the release notes on github		# Generate the release notes on github
	#: On github, login		#: On github, login
	#::Goto Tags, Select "Draft New Release"		#::Goto Tags, Select "Draft New Release"
			#::* Select the "Tag version" you created
			#::* Fill in the release notes
	# Update wiki release documentation		# Update wiki release documentation
	#* http://genome.sph.umich.edu/wiki/GotCloud:_Versions		#* http://genome.sph.umich.edu/wiki/GotCloud:_Versions
Line 51:		Line 53:
	#** https://groups.google.com/forum/?hl=en#!forum/gotcloud		#** https://groups.google.com/forum/?hl=en#!forum/gotcloud
	# Install on mario		# Install on mario
			#* In the gotcloud directory where you generated the deb files, run:
			#*: <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
			#*: <code>debian/install_gotcloud_without_root.sh 1.16 /net/mario/gotcloud.old</code>
			#* Rename to the version name:
			#*: <code>mv /net/mario/gotcloud.old/gotcloud /net/mario/gotcoud.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

Mktrost at 22:28, 25 February 2015

2015-02-25T22:28:27Z

← Older revision		Revision as of 18:28, 25 February 2015
Line 2:		Line 2:

	Software for GotCloud is kept in a '''git''' repository on '''github'''.		Software for GotCloud is kept in a '''git''' repository on '''github'''.
	~~This document describes how we create the Debian package and tar file for GotCloud.~~

	~~'''Get the software''' (in this case from github):~~		We also create a Debian package and tar file for GotCloud.
	~~<code>~~
	~~cd ~/dev~~
	~~'''git clone git://github~~.~~com/statgen/gotcloud.git'''~~
	~~Cloning into 'gotcloud'...~~
	~~done.~~
	~~'''ls gotcloud'''~~
	~~bin/ Copyrights/ debian/ gotcloud INSTALL.txt README release_version.txt scripts src test~~
	~~</code>~~

	~~'''Build the Source'''~~		To release a new version of GotCloud:
	<code>		# I recommend creating a new directory:
			#: <code> cd ~/dev</code>
	~~'''~~cd ~/dev/gotcloud/~~src'''~~		#: <code> git clone git://github.com/statgen/gotcloud.git</code>
	~~'''make'''~~		#: <code> cd gotcloud</code>
	</code>		# Build the source
			#: <code> cd src</code>
	~~'''~~Build the ~~Packages'''~~		#: <code> make</code>
			# Run the tests, ensure they all succeed
	~~Debian binaries DEB, TAR file~~		#: <code>./gotcloud align --test testDir</code>
	<code>		#: <code>./gotcloud snpcall --test testDir</code>
	~~'''~~cd ~/~~dev~~/~~gotcloud'''~~		#: <code>./gotcloud ldrefine --test testDir</code>
	~~'''debian/makedeb.sh bin =''' (or in place of '=' use a version number)~~		#: <code>./gotcloud indel --test testDir</code>
	~~Making binaries in src~~. ~~First time this will take a couple of minutes~~		# Update the version number (if you have not already).
	~~Binaries created as necessary~~		#* Edit release_version.txt
	~~dpkg~~-~~buildpackage: export CFLAGS from dpkg~~-~~buildflags (origin: vendor):~~		#* Commit the new release number
	~~[lines deleted]~~		#*: <code>git add release_version.txt</code>
	~~dpkg-deb~~: ~~building package `gotcloud-bin' in `~~./gotcloud-~~bin_1.06_amd64.deb'.~~		#*: <code>git commit -m "Release 1.XX"</code>
	~~Debian package file created~~		#* Push to github
	~~-rw~~-~~r--r-- 1 tpg tpg 7933560 May 20 08:28~~ /~~home/tpg/dev/gotcloud/gotcloud-bin_1.06_amd64.deb~~		#*: <code>git push</code>
	~~Creating tar file for 'bin'~~		# Checkout latest branch and merge master & push
	~~Tar file created~~		#: <code>git checkout latest</code>
	~~-rw-r--r-- 1 tpg tpg 7983521 May 20 08~~:~~28 /home/tpg/dev/gotcloud~~/gotcloud-~~bin_1.06.tar.gz~~		#: <code>git merge master</code>
	</code>		#: <code>git checkout master</code>
			#: <code>git push</code>
	~~Debian test DEB, TAR file~~		# Create a release tag
	<code>		#: <code>git tag -a gotcloud.1.XX -m 'version 1.XX'</code>
	~~'''cd ~~~/~~dev~~/~~gotcloud'''~~		# Push tag
	~~'''debian/makedeb.sh test =''' (or in place of '=' use a~~ version number)		#: <code> git push origin gotcloud.1.XX</code>
	~~#################################################~~############		# Create the packages (debian and tar)
	# ~~Creating the 'test' package takes~~ a ~~pretty long time. Patience grasshopper~~...		#* cd to one directory above gotcloud
	~~###########################################################~~##		#*: <code> cd ..</code>
	~~dpkg-buildpackage~~: ~~export CFLAGS from dpkg-buildflags (~~origin~~: vendor): .~~..		#* Generate the packages & copy to ftp://share.sph.umich.edu/gotcloud/ (all done for you by the script)
	~~[lines deleted]~~		#*: <code> /net/wonderland/home/mktrost/gc-admin/genDebs.sh</code>
	~~dpkg-deb~~: ~~building package `gotcloud-test' in `~~./~~gotcloud-test_1.06_amd64.deb'.~~		#* at prompt, enter:
	~~Debian package file created~~		#*: <code>y</code>
	~~-rw-r--r-- 1 tpg tpg 382184656 May 20 08~~:41 /~~home~~/~~tpg/dev~~/gotcloud/~~gotcloud-test_1.06_amd64.deb~~		# Generate the release notes on github
	~~Creating tar file~~ for ~~'test'~~		#: On github, login
	~~Tar file created~~		#::Goto Tags, Select "Draft New Release"
	~~-rw-r--r-- 1 tpg tpg 383138926 May 20 08~~:42 /~~home~~/~~tpg~~/~~dev~~/~~gotcloud~~/~~gotcloud~~-~~test~~		# Update wiki release documentation
	</code>		#* http://genome.sph.umich.edu/wiki/GotCloud:_Versions
			# Send Email to google group
	~~Make these available via FTP~~:		#* 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)
	<code>		#** https://groups.google.com/forum/?hl=en#!forum/gotcloud
	~~'''cd ~~~/~~dev/gotcloud'''~~		# Install on mario
	~~'''ls -la .deb .tar.gz'''~~		# Send email to csg group to inform them of the newly installed version on the cluster and of any relevant changes
	~~-rw-r--r-- 1 tpg tpg 7933560 May 20 08~~:~~28 gotcloud-bin_1.06_amd64.deb~~		#* gotcloudUsers@umich.edu
	~~-rw-r--r-- 1 tpg tpg 7983521 May 20 08~~:~~28 gotcloud-bin_1.06.tar.gz~~
	~~-rw-r--r-- 1 tpg tpg 382184656 May 20 08:41 gotcloud-test_1.06_amd64.deb~~
	~~-rw-r--r-- 1 tpg tpg 383138926 May 20 08~~:~~42 gotcloud-test_1~~.06.~~tar~~.gz

	~~'''scp~~ ~~.deb .tar.gz~~ gotcloud@~~share~~.~~sph~~.~~umich~~.~~edu'''~~
	</~~code>~~

	~~This makes~~ the ~~Debian packages~~ and ~~tar files available to outsiders using anonymous FTP (or wget)~~.