Front end release management

This is our official process for releasing new versions of code-gov-front-end.

Table of contents

1. Principles
2. Versioning
3. Release process
   1. Git workflow
   2. Publishing a new release

Principles

1. Follow well-established versioning practices
2. Provide detailed notes for each release
3. Encourage contributions and thank contributors for their hard work

Versioning

See Version Control for more information about semantic versioning and what constitutes a release

Release process

Git workflow

See Git Workflow for more information about how to create new branches and suggest changes to @code.gov/* repositories

Publishing a new release

⚠️ In these docs, {{ version }} should always be replaced with the semantic version number, i.e. 1.2.1 ⚠️

Create the release branch

• Determine if the version is a patch (#.#.#), minor (#.#.0), or major (#.0.0) version

• Branch off master and use the branch name format release-{{ version }}:

         git pull origin master
         git checkout -b release-{{ version }} origin/master
  

Example > git checkout -b release-0.0.7 origin/master

---

This is being refactored because of new Federalist release packaging. Updates coming soon! In order to deploy, the .env file will need to be edited to include the API key for production branch and/or staging.

Get started

• Close all running processes in the terminal.
• Publish new versions of any other components that have changed. If any other components listed at the top of Component Release Management have changed since the last release of code-gov-front-end, follow the instructions in Component Release Management to publish new versions to npm and update the package.json of code-gov-front-end with the new version numbers.
• Generate a new sitemap. Go through the “Setup instructions” and “Generating a new sitemap.xml” sections in the README of code-gov-site-map-generator to generate a new sitemap.xml file and merge it into the master branch of that repo. Then follow the instructions in Component Release Management to publish a new version of code-gov-site-map-generator to npm. Once the new version has been published, update the version number for code-gov-site-map-generator in the package.json of code-gov-front-end and run npm install to update the package-lock.json. Commit the changes.
• Update the filters on the browse projects and open task pages. Go through the “Setup instructions” and “Generating new filters” sections in the README of code-gov-data to generate the filter options for the browse projects page and the open tasks page.
• If you haven't created a branch for this release in code-gov-front-end yet, create the branch following the branching instructions for releases
• In code-gov-front-end, run npm run update-data. This will copy the new versions of repos.json and tasks.json that were just generated (as well as the schema.json) from the code-gov-data remote repository into your local code-gov-front-end repository. Run git status to see what change were made. If there were changes, then commit those changes to the release branch.
• Run npm install to download the new components. Commit any changes.

---

Test the release

Test all of the latest updates and release to staging.

• Follow the testing instructions to test the branch. Merge changes into Staging.
• After Staging passes all tests, create a PR and merge into Master to make sure both branches are in sync for future changes. (Note: Master should be the most recent code for the site.)
• When Federalist is done building the site, you can view the updates to staging.
• Visit staging to verify any changes you made.

Note: If you get the following error:

fatal: Could not read from remote repository.

Please make sure you have the correct access rights
and the repository exists.

    at ChildProcess.<anonymous> (/Users/josephcastle/Desktop/Development/DevCode/code-gov-front-end/node_modules/gh-pages/lib/git.js:42:16)
    at ChildProcess.emit (events.js:200:13)
    at maybeClose (internal/child_process.js:1021:16)
    at Process.ChildProcess._handle.onexit (internal/child_process.js:283:5) {
  code: 128,
  message: 'Cloning into ' +
    "'node_mod

Follow the Generating a new SSH key and adding it to the ssh-agent(https://help.github.com/en/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent) instructions.

Version the release with npm

npm version will increment the version number semantically in package.json and commit the changes to git. Versions will be tagged on the master branch. See the npm publish documentation for additional options.

• For prerelease releases: Run npm version prerelease --no-tag.
• For patch releases: Run npm version patch --no-tag.
• For minor releases: Run npm version minor --no-tag.
• For major releases: Run npm version major --no-tag.

This bumps the version number in package.json and commits that change. It should echo back the new version number to your terminal command line. git log should show that new commit.

• Regenerate the dependency_license.json file by running the script npm run licenses. Commit the changes.

---

Deploy the release

• Push the version branch up to GitHub
• Merge release-{{ version }} back in to the master branch
• Run git checkout master and git pull origin master to update your local repository
• From master, execute CODE_GOV_RELATIVE_DIR='/dist/federalist-prod' CODE_GOV_BRANCH='federalist-prod' CODE_GOV_API_KEY='OC457325hyT6DpFm5HBBZ1i8SR6gtp5U2CdqtHZQ' npm run deploy-to-production to publish federalist-prod and deploy to production
• Wait for the deployment success message in your terminal
• Check that Federalist deployed the new release's site

---

Publish the release on npm

• Run npm publish to release the package to the npm directory
• Check that the new release was published to npm

If you get the following error then run npm login to authenticate to npm.

 npm ERR! publish Failed PUT 401  
 npm ERR! code E401  
 npm ERR! You must be logged in to publish packages.

---

Create the release in GitHub

• In GitHub releases select the release draft notes you had previously started or Draft a new release. Use the template provided from the wiki.
• Add the tag: v{{ version }}
• Use target: master
• Add release notes to the body
• Have at least one team member review the release notes
• Select Publish release

---

Publicize the release

• Post a message in the #code-gov-team Slack channel linking to the release.
• Post a message in the #code-gov-partners Slack channel linking to the release. Pin the message to the channel.
• Post a message to the [email protected] listserv.

---

Setup the next draft release notes

• Click "Draft a new release" from the Releases page
• Set the target to master
• Add the title [unreleased]
• Save draft

---