Updated November 17, 2018

The following is the process for finalizing a new release of Cucumber Linux.

The first part of the release process differs depending on whether you are releasing from a build server of a bootstrap server. If you are completing a Cucumber Linux from Scratch build, then you are releasing from a bootstrap server. Otherwise, you are releasing from a build server.

Start out by following the steps in the appropriate section. Once you have completed, follow the steps in the “Mutual Steps” section to complete the release.

1. Update the information in ports/distribution-release to reflect the new release version
2. Rebuild the lsb-info package.
3. Add an entry to the changelog stating that the new version is released.

1. On the staging server:
   1. Log in as the staging user (user by default).
   2. If this is a new staging server, then run the following commands to install the staging server buildtools (substitute the version number of Cucumber Linux you are building in for “x.y”): cd && git clone https://github.com/cucumberlinux/buildtools.git && cd buildtools && make install-staging-server VERSION=x.y.
   3. Ensure that all the necessary directories are present by running the following command: /opt/buildtools/initserv_create_directories
2. On the bootstrap server:
   1. Ensure you are in the chroot environment.
   2. Run the following commands to install the bootstrap server buildtools (substitute the version number of Cucumber Linux you are building in for “x.y”): cd && git clone https://github.com/cucumberlinux/buildtools.git && cd buildtools && make install-bootstrap-server VERSION=x.y
   3. Run a script to create the contents.bz2, file-list, updates and CHANGELOG files: cd /opt/packages/cucumber && /opt/buildtools/create_metadata_files
   4. Edit the /opt/buildtools/config file and set the STAGING_SERVER variable to the appropriate value.
   5. Upload the /opt/packages/cucumber directory to the staging server by running the following script: /opt/buildtools/upload_packages
   6. On only one bootstrap server (i.e. the bootstrap server for one and only one architecture), upload the /usr/ports directory to the staging server by running the following script: /opt/buildtools/upload_ports
3. Build the updated installer ISO.
   1. On the bootstrap server
      1. Clone the repository https://github.com/cucumberlinux/installer.
      2. Run VERSION=x.y ./build-iso.sh, substituting the version number of Cucumber Linux you are building in for “x.y”.
      3. Upload the .iso file from /tmp on the bootstrap server to ~/cucumber/cucumber-x.y/ISOs/ on the staging server.

The remaining steps must be performed regardless of which type of server you are releasing from. These steps are identical regardless of which type of server you are releasing from and should all be performed on the staging server.

1. Create the verification files for the ISO images:
   1. Cd to ~/cucumber/cucumber-x.y/ISOs/
   2. Calculate the SHA256 checksums.
   3. Sign the ISO images with GPG.
2. Make a copy of the rolling source tree and save it to ~/cucumber_releases/.
3. Upload the new ISO files to Sourceforge.
4. Make an announcement on the website and update the download page.
5. Send an email to the announcement mailing list
   1. Also CC the development mailing list.