Skip to content

Creating a Release from Staging to Pre Prod

tjamesmac edited this page Apr 8, 2020 · 6 revisions

When enough features have been developed and passed Product Owner approval, a release should be made to our Pre-Production environment. This tutorial will describe the steps necessary to do this.

Before beginning to attempt a release, always seek approval from the reigning authority within the team.

Step 1: Create a new milestone

  1. Navigate to the issues page within the eq-author-app Github repository;
  2. Click "Milestones", found beside "Labels" and adjacent to the green "New issue" button;
  3. Click "New milestone", the green button found in the top-right corner of the screen;
  4. Give the milestone a title, this should be the version of the release.

If you're unsure on what version the release should be, ask the Tech Lead, Delivery Manager or Product Owner within the team.

  1. Optionally, you can give the milestone a due date. We don't usually, so you can leave this blank;
  2. Optionally, you can give the milestone a description. Here, you could write any notable features that were added within this release;
  3. Click "Create milestone, the green button in the bottom-right corner of the screen.

Step 2: Tag relevant pull requests with the new milestone

  1. Navigate to the pull requests page within the eq-author-app Github repository;
  2. Change the filter to show closed pull requests, by clicking on "Closed" beside "Open" on the pull request filter options;
  3. Select the pull requests you wish to include within the release, by clicking the checkbox beside the pull request title;
  4. Give the selected pull requests the milestone you created earlier, by clicking on the "Milestone" dropdown beside the "Mark as", "Label" and "Assign" dropdown options along the pull request list heading;

Step 3: Create a new release

  1. Navigate to the code page within the eq-author-app Github repository;
  2. Click releases, found along the navigation bar featuring "commits", "branches", "environments" and "contributors";
  3. Click "Draft a new release" in the top-right corner of the screen;
  4. Give your release a tag, which should match the title of the milestone you created earlier;

This does not link the release to the milestone, but rather ensures consistency between releases and milestone versioning. The release will publish everything within the master branch of the repository.

  1. Give the release a title, which should match the title of the milestone you created earlier;
  2. Provide a link to the milestone you created earlier within the description;
  3. Click "Publish release", the green button in the bottom-left of the screen.
Clone this wiki locally