azure-node-tuneup

Give your Node Azure Website a tuneup by choosing any node or npm version. Tuneup will download the selected versions dynamically during deployment.

Features

• Very easy to use.
• Supports both new and existing Azure Websites.
• Supports ANY available node or npm version.
• Can be configured through package.json or via app settings in the portal / cli.

How to use

Install tuneup

npm install tuneup -g

• In the root folder of your app that you will deploy, run tuneup: tuneup.
• Create your website i.e. azure site create --git
• Add all files for your project i.e. git add .
• Select your node / npm version (see version selection below)
• Commit your files git commit -am "first commit"
• Push to Azure git push azure master.
  • The first time you push you will notice it installs nodist, a node version manager for windows.
  • After the initial install it will then download the specified node/npm version.
  • On successive pushes it will not download newer versions unless you update the selected versions.

Note: For npm future deployments will be much faster if you specify a specific version rather than using a semver i.e. "1.8.x".

Version selection

Several options are available for specifying your selected node and npm version.

Using package.json

By default when you run tuneup it will update your package.json (or create one it it does not exist) with an engines entry containing a default node and npm version.

"engines": {
  "node": "0.10.15",
  "npm": "1.3.5"
}

You can override the default by using the --node and --npm parameters. See `tuneup --help' for more.

In order to update the version, you can modify package.json and push again to git. Before doing that first do an `azure site restart' in your app folder to ensure that

Setting version in the portal

You can set specify versions in the Windows Azure portal by adding the settings NODE_VERSION and NPM_VERSION on the configure tab as show below.

Make sure you click "Save" on the bottom to have the settings change take effect.

If the app is already deployed, you can make the version change take effect immediately within the portal by redeploying your last deployment. To do that head to the "Deployments" tab, select your most recent deployment and then click "Redeploy" on the bottom.

Check the logs after deployment is completed to see if any errors occured.

Setting a version via the CLI

If you are using the azure-cli, you can also select a version and apply from the shell using azure site config

azure site config add NODE_VERSION=0.10.x
azure site config add NPM_VERSION=1.2.x

Next to apply the changes redeploy your app. First list the deployments.

azure site deployment list

The output will be as follows listing each commit that has been deployed.

info:    Executing command site deployment list
+ Enumerating deployments
data:    Time                 Commit id   Status   Author       Message
data:    -------------------  ----------  -------  -----------  ------------
data:    2013-05-12 23:37:49  f925d413dc  Active   Glenn Block  updated
data:    2013-05-12 23:23:42  9c5bf8ec17  Success  Glenn Block  updated

Next redeploy the last commit.

azure site deployment redeploy f925d413dc

Which will give you a result similar to the following.

info:    Executing command site deployment redeploy
Web site name: gbnodever
Reploy deployment with f925d413dc id?  (y/n) y
+ Redeploying deployment
+ Enumerating deployments
data:    Time                 Commit id   Status   Author       Message
data:    -------------------  ----------  -------  -----------  ------------
data:    2013-05-13 00:53:57  f925d413dc  Active   Glenn Block  updated
data:    2013-05-12 23:23:42  9c5bf8ec17  Success  Glenn Block  updated
info:    site deployment redeploy command OK

Regardless of which method you use, when you deploy, the selected npm version and node version will be used.

If you check your app, you should see that it will be running the selected node version.

A note on space

• Nodist takes up about 10 meg
• Each node version that is installed takes up approx 5 meg of storage.
• npm takes up about 25 megs total (including it's dependencies).

License

Apache 2: http://www.apache.org/licenses/LICENSE-2.0.html