Best way to handle node version and manage node dependencies?

[devjk1]

Deployer v8.0.5 using Laravel recipe

I have two questions.

1. What is the best way to set the node_version that is used during provision:node?
   I have tried to set the node_version in the host and with a before hook to v24.15.0 but the node_version seems to be stuck on lts v18.19.1

2. What is the recommended way to manage node dependencies? What is the best way to install a package manager like npm? Should we hook into the default provision?
   Any help or examples would be greatly appreciated.
   Thank you for your time.

<?php
namespace Deployer;

use Dotenv\Dotenv;

require 'recipe/laravel.php';
require 'contrib/npm.php';

$dotenv = Dotenv::createImmutable(__DIR__);
$dotenv->load();
// Config
add('shared_files', []);
add('shared_dirs', []);
add('writable_dirs', []);

// Hosts
$branch = 'feature/add-deployer';
host($_ENV['APP_URL'])
    ->set('domain', $_ENV['APP_URL'])
    ->set('deploy_path', $_ENV['REMOTE_DEPLOY_PATH'])
    ->set('remote_user', $_ENV['REMOTE_USERNAME'])
    ->set('sudo_password', $_ENV['REMOTE_PASSWORD'])
    ->set('db_type', $_ENV['DB_CONNECTION'])
    ->set('db_name', $_ENV['DB_DATABASE'])
    ->set('db_user', $_ENV['DB_USERNAME'])
    ->set('db_password', $_ENV['DB_PASSWORD'])
    ->set('php_version', $_ENV['PHP_VERSION'])
    ->set('node_version', $_ENV['NODE_VERSION'])
    ->set('branch', $branch);

// Tasks
task('set:node_version', function () {
    currentHost()->set('node_version', $_ENV['NODE_VERSION']);
});
task('build', function () {
    cd('{{release_path}}');
    run('node -v');
    run('npm install');
    run('npm run prod');
});

// Hooks
before('provision:node', 'set:node_version');
after('deploy:update_code', 'build');
after('deploy:failed', 'deploy:unlock');

[antonmedv]

Yes, for node versions we have to refactor the provision recipe.

[antonmedv]

2. What is the recommended way to manage node dependencies?

What kind of deps? Why not just in package.json?

[devjk1]

Hey anton, I worded my question poorly. I meant to ask what is the best way to install a package manager like npm? When I tried running the build task, the server would error saying npm is not installed.

task('build', function () {
    cd('{{release_path}}');
    run('npm install');
    run('npm run prod');
});

I thought npm would already be installed in the provision task, but maybe I need to run something like this after provision?

task('app.provision:npm', function () {
    run('apt install -y npm', env: ['DEBIAN_FRONTEND' => 'noninteractive']);
});
after('provision', 'app.provision:npm');

[antonmedv]

I see. I think this is a provision bug. I will have to take a look.