Changes

From Genome Analysis Wiki
Jump to navigationJump to search

Releasing GotCloud (view source)

Revision as of 22:17, 6 November 2015

285 bytes removed ,  22:17, 6 November 2015
no edit summary
Line 1: Line 1:  
Back to parent: [[GotCloud]]
 
Back to parent: [[GotCloud]]
   −
Software for GotCloud is kept in a got repository on github (eventually).
+
Software for GotCloud is kept in a '''git''' repository on '''github'''.
−
This document describes how we create the Debian and Redhat packages used with GotCloud.
     −
'''Get the software''' (in this case from our local repository):
+
We also create a Debian package and tar file for GotCloud.
−
<code>
  −
  '''git clone ....git/gotcloud gotcloud'''
  −
  Cloning into 'gotcloud'...
  −
  done.
  −
  '''ls gotcloud'''
  −
  bin/  debian/  INSTALL.txt  README  scripts/  test/
  −
</code>
     −
'''Build the Packages'''
+
To release a new version of GotCloud:
−
Debian binaries
+
# I recommend creating a new directory:
−
<code>
+
#: <code> cd ~/dev</code>
−
  '''cd gotcloud'''
+
#: <code> git clone git@github.com:statgen/gotcloud.git</code>
−
  '''debian/makedeb.sh bin'''
+
#: <code> cd gotcloud</code>
−
  dpkg-buildpackage: export CFLAGS from dpkg-buildflags (origin: vendor): -g -O2 -fstack-protector --param=ssp-buffer-size=4 -Wformat -Wformat-security
+
# Build the source
−
  dpkg-buildpackage: export CPPFLAGS from dpkg-buildflags (origin: vendor): -D_FORTIFY_SOURCE=2
+
#: <code> cd src && make && cd ..</code>
−
  dpkg-buildpackage: export CXXFLAGS from dpkg-buildflags (origin: vendor): -g -O2 -fstack-protector --param=ssp-buffer-size=4 -Wformat -Wformat-security
+
# Run the tests, ensure they all succeed
−
  dpkg-buildpackage: export FFLAGS from dpkg-buildflags (origin: vendor): -g -O2
+
#: <code> cd src && make test && cd ..</code>
−
  dpkg-buildpackage: export LDFLAGS from dpkg-buildflags (origin: vendor): -Wl,-Bsymbolic-functions -Wl,-z,relro
+
#: <code>./gotcloud test</code>
−
  dpkg-buildpackage: source package gotcloud-bin
+
# Update the version number (if you have not already).
−
  dpkg-buildpackage: source version 1.0
+
#* Edit release_version.txt
−
  dpkg-buildpackage: source changed by Mary Kate Trost <mktrost@umich.edu>
+
#* Commit the new release number
−
  dpkg-buildpackage: host architecture amd64
+
#*: <code>git add release_version.txt</code>
−
  rm -rf files substvars tmp debian/errs
+
#*: <code>git commit -m "Release 1.XX"</code>
−
  echo "Generate package: cd gotcloud-bin; dpkg-buildpackage -b -us -uc -rfakeroot"
+
#* Push to github
−
  Generate package: cd gotcloud-bin; dpkg-buildpackage -b -us -uc -rfakeroot
+
#*: <code>git push</code>
−
  rm -rf debian/tmp debian/errs
+
# Checkout latest branch and merge master & push
−
  install -d debian/tmp/DEBIAN
+
#: <code>git checkout latest</code>
−
  cp debian/control debian/postinst debian/tmp/DEBIAN
+
#: <code>git merge master</code>
−
  install -d debian/tmp/usr/share/doc/gotcloud-bin_1.0
+
#: <code>git push</code>
−
  cp debian/changelog debian/tmp/usr/share/doc/gotcloud-bin_1.0
+
#: <code>git checkout master</code>
−
  cp README    debian/tmp/usr/share/doc/gotcloud-bin_1.0/README
+
# Create and push a release tag
−
  gzip -9      debian/tmp/usr/share/doc/gotcloud-bin_1.0/*
+
#: <code>git tag -a gotcloud.1.XX -m 'version 1.XX'</code>
−
  cp debian/copyright debian/tmp/usr/share/doc/gotcloud-bin_1.0
+
#: <code> git push origin gotcloud.1.XX</code>
−
  mkdir -p debian/tmp/usr/local/gotcloud
+
# Create the debian packages
−
  cp -rp bin scripts  debian/tmp/usr/local/gotcloud
+
#* Generate the packages
−
  test -z "" || mv debian/tmp/usr/local/gotcloud/rpmbin/* debian/tmp/usr/local/gotcloud/bin
+
#*: <code> ./debian/makedeb.sh bin =</code>
−
  test -z "" || rm -rf debian/tmp/usr/local/gotcloud/rpmbin
+
#*: <code> ./debian/makedeb.sh test =</code>
−
  chmod 755 debian/tmp/usr/local/gotcloud/bin/* debian/tmp/usr/local/gotcloud/scripts/*
+
# Generate the release notes on github
−
  dpkg-gencontrol -isp
+
#: On github, login
−
  chown -R root.root debian/tmp
+
#::Goto Tags, Select "Draft New Release"
−
  chmod -R o-s,go=u,go-ws debian/tmp
+
#::* Select the "Tag version" you created
−
  dpkg --build debian/tmp .
+
#::* Fill in the release notes
−
  dpkg-deb: building package `gotcloud-bin' in `./gotcloud-bin_1.0_amd64.deb'.
+
# Update wiki release documentation (for full release)
−
  rm -rf tmp
+
#* http://genome.sph.umich.edu/wiki/GotCloud:_Versions
−
  ''Package file now in /home/tpg/dev/gotcloud''
+
# Send Email to google group (for full release)
−
  ''-rw-r--r-- 1 tpg tpg 3366722 Dec  4 13:55 gotcloud-bin_1.0_amd64.deb''
+
#* gotcloud@googlegroups.com
−
</code>
+
#* 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)
−
 
+
#** https://groups.google.com/forum/?hl=en#!forum/gotcloud
−
Debian test
+
# Install on mario
−
<code>
+
#* In the gotcloud directory where you generated the deb files, run:
−
</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
−
Redhat binary RPM
+
#*: <code>./debian/install_gotcloud_without_root.sh 1.16 /net/mario/gotcloud.old</code>
−
<code>
+
#* Rename to the version name:
−
</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
−
Redhat test RPM
+
#* gotcloudUsers@umich.edu
−
<code>
  −
</code>
 
Pjvh
61

edits

Retrieved from "http://genome.sph.umich.edu/wiki/Special:MobileDiff/6018...13895"

Navigation menu