Ensure Node.js version is consistent on Azure services and devops pipelines

Photo by Markus Spiske on Unsplash

I got caught out with Microsoft recently setting the default version of Node.js from 12 to 14 on Azure pipelines linux build agent images (ubuntu-latest). Here are some tips for ensuring Node.js versions are set correctly in some of the popular Azure PaaS offerings.

In your package.json

You should ensure that the versions of Node.js you know that your code works with are specified to npm.

This is achieved using the engines section in your package.json.

{ "engines": { "node": "12.x" } }

A mistake I made here was that I only has a greater than requirement. So when Node.js 14 came along it broke on of the packages in my project. This was tricky to figure out, but if I had set the engines to also have a max version, npm would have highlighted that issue immediately.

Note, this will just warn you if the version of Node.js being used doesn't match. That would be enough to highlight an issue in the deploy or build log.

If you want you can also set npm config set engine-strict true in your npm config and now your scripts will fail to start or operate if the Node.js versions don't match.

In Azure Pipelines tasks

There is a task that you can add to a job that tells Azure Pipelines which version of Node.js to use. I had this on one job but not all of them. Make sure that you put this task on all of your jobs because each one runs on a different environment.

  - deployment: DevDeploy
    displayName: MyDevDeploy
    environment: my-dev-environment
      vmImage: ubuntu-latest
            - task: NodeTool@0
                versionSpec: "12.x"
              displayName: "Ensure node version available"

In App Services

If you use Azure App Service for hosting you should tell it the correct version of Node.js to use. You can do this in the gui for app services.

App services Node.js configuration


There can be difficult to find bugs in your npm packages caused by Azure upgrading the default version of Node.js in build agents and on any of their PaaS systems. You can mitigate it by specifying the exact versions your code is designed to work with.

Hope that helps!