Release Procedure

Official vtigercrm releases will be made available only by the process documented on this page. Other release scenarios, such as variants of the codebase for community testing should be maintained as repository branches, documented in RepositoryBranching.

Release Procedure Objectives

The release procedure is documented and adhered to for several reasons, including:

  • Can be undertaken by any developer so authorized by the vtigercrm team
  • Is repeatable across releases
  • Has a predictable output of release files
  • Packagers can rely on predictable download URLs
  • Emergency releases are no more or less work than regular releases
  • Community and packagers know where to look for release notification

Release Procedure Output

The release process always results in exactly three files and one subversion tag, as described in Canonical Name Forms (ReleaseNaming)

  1. Unix Archive Name: vtigercrm-x.y.z[-][suffix#].tar.gz
  2. Windows Archive Name: vtigercrm-x.y.z[-][suffix#].zip
  3. Windows Installer Name: vtigercrm-x.y.z[-][suffix#].exe
  4. Subversion Tag Name: /vtigercrm/tags/x.y.z[-][suffix#]

Release Procedure Steps

  1. Prepare one repository branch (which can include vtigercrm/trunk) to be configured exactly as the release files.
  2. Use svn export to create a filesystem copy of this branch containing no .svn control information.
  3. Test configuration of your exported codebase, unaltered, to evaluate your satisfaction
  4. Make necessary changes with svn commits, do not post-process svn exported codebase.
  5. Repeat from step 1, until no packaging defects can be found.
  6. (to be continued...)