Upgrading Node version.md

Upgrading Node Version

When NodeJs is updated it is worth noting it needs to be updated in a few places.

Selecting the new version

There are a couple of considerations to consider when selecting a Node version to upgrade to:

• The version must be supported by the latest release of the CloudFoundry Node buildpack.
• The version must have a Cypress docker image associated with it, and appear in the list of Cypress image tags.

If both of these criteria are not met, it will not be possible to build the new dependency image locally and it will not be possible to proceed with the upgrade.

Steps to follow for an upgrade

1. Update manifest.yml to use the latest buildpack release
2. Install and set your local nvm to use the chosen Node version

nvm install VERSION
nvm use VERSION

3. Update the engines in package.json and install the dependencies with npm ci.
4. Update the version used in Dockerfile.dependencies, then create/upload a new version of the dependency image (use the instructions from the Docker readme). Ensure that the Dockerfile is using the image you created or CircleCI will not be able to run most of the tests.
5. Update the engines in test/sandbox/package.json and install the dependencies with npm ci.
6. Update the node versions used in the below files:
   • test/sandbox/Dockerfile
   • Step two of the native readme
7. Run the unit tests to check the app npm run test:unit, and then start the app npm run develop and do some quick smoke tests to ensure the app works
8. Commit your changes, push the branch and then create a Draft PR to get the tests running
9. Deploy the branch to the UAT environment so we can test the buildpack.
10. Once the tests pass and the deployment works, mark the PR as ready for review
11. Switch back the Node version so you can carry on with other tickets whilst waiting for the PR to be approved and merged ;-)
12. Once the PR has been merged, do a release to production to finish the process.