chef/cookbooks/nodejs/migration.md

Migration Guide

This release is a breaking migration from recipes and node attributes to custom resources.

What Changed

The cookbook no longer exposes nodejs::default, nodejs::install, nodejs::repo, nodejs::npm, nodejs::npm_packages, or the install-method recipes. The attributes/ directory was removed. Configure Node.js through resource properties instead of node['nodejs'] attributes.

Recipe to Resource Mapping

Before	After
include_recipe 'nodejs::default'	nodejs_install 'nodejs' plus optional nodejs_npm_packages
include_recipe 'nodejs::repo'	nodejs_repository 'nodesource'
include_recipe 'nodejs::nodejs_from_package'	nodejs_install 'nodejs' do install_method 'package' end
include_recipe 'nodejs::nodejs_from_binary'	nodejs_install 'nodejs' do install_method 'binary' end
include_recipe 'nodejs::nodejs_from_source'	nodejs_install 'nodejs' do install_method 'source' end
include_recipe 'nodejs::nodejs_from_chocolatey'	nodejs_install 'nodejs' do install_method 'chocolatey' end
include_recipe 'nodejs::npm'	nodejs_npm_install 'npm'
node['nodejs']['npm_packages']	nodejs_npm_packages 'packages'

Examples

Install Node.js from NodeSource packages:

nodejs_install 'nodejs' do
  install_method 'package'
  version '24.15.0'
end

Install packages that used to be configured with node['nodejs']['npm_packages']:

nodejs_npm_packages 'application packages' do
  packages [
    { name: 'express' },
    { name: 'socket.io', version: '4.8.1' },
  ]
end

The nodejs_npm alias still works for the npm_package resource, but it no longer auto-includes any Node.js or npm recipes. Install Node.js first:

nodejs_install 'nodejs'

nodejs_npm 'express'

See test/cookbooks/test/recipes/ for runnable migration examples used by Kitchen.