Node

Para el uso de node utilizamos el manejador de versiones nodenv y algunos plugins. Siempre usamos la versión LTS, poniendo la major en el archivo .node-version. Es decir, se debe preferir escribir 10 en vez de 10.12.1.

Nodenv es realmente un clone de rbenv pero para node, por lo que funciona muy parecido. Toda la información de la sección de ruby aplica para node.

OSX

Instalación

# Instalar nodenv y node-build
brew install nodenv node-build

TAPS

Taps son repositorios de donde brew puede buscar aplicaciones. Brew viene con el tap homebrew-core incluido, pero se puede agregar más. En este caso tuvimos que agregar el tap de nodenv para poder instalar los plugins de nodenv con brew.

Agregar tap de nodenv

brew tap nodenv/nodenv

Agregar plugins para nodenv

brew install nodenv-vars nodenv-aliases

Luego debes cargar nodenv en tu shell para que puedas acceder a las diferentes versiones. Para esto debes agregar la siguiente linea en tu .bash_profile o .zshrc dependiendo del shell que uses. Hay dos formas de hacerlo:

1. Ejecutar el siguiente, que agrega automáticamente la línea necesaria:

   • Si usas .bash_profile

     echo 'eval "$(nodenv init -)"' >> ~/.bash_profile

   • Si usas .zshrc

     echo 'eval "$(nodenv init -)"' >> ~/.zshrc

2. Abrir .bash_profile o .zshrc y agregar la linea en el archivo usando el editor de preferencia:

   eval "$(nodenv init -)"

3. Instalar yarn (npm install -g yarn o https://github.com/pine/nodenv-yarn-install para no tener que instalarlo a mano con cada versión de node)

Windows

Para instalar nodenv con WSL2, sigue las instrucciones de Linux y en el paso 2 preocupate de usar el comando especial para WSL.

Linux

Las instrucciones para instalar nodenv se obtuvieron del repositorio oficial por si tienes alguna duda.

1. Clonar nodenv

   git clone https://github.com/nodenv/nodenv.git ~/.nodenv

2. Agrega ~/.nodenv/bin a tu $PATH para usar los comando en la shell.

   • Si usas bash:

     echo 'export PATH="$HOME/.nodenv/bin:$PATH"' >> ~/.bash_profile

   • Si usas Zsh:

     echo 'export PATH="$HOME/.nodenv/bin:$PATH"' >> ~/.zshrc

   • Si usas Windows con WSL:

     echo 'export PATH="$HOME/.nodenv/bin:$PATH"' >> ~/.bashrc

3. Configura nodenv en tu shell

~/.nodenv/bin/nodenv init

Te deberá aparecer un mensaje similar a este, que se hará en el siguiente paso:

# Load nodenv automatically by appending
# the following to ~/.bashrc:
eval "$(nodenv init -)"

1. Añade ~/.nodenv/bin a $PATH

   • En Ubuntu 20.04 y WSL2:

     $ echo 'export PATH="$HOME/.nodenv/bin:$PATH"' >> ~/.bashrc

   • En bash:w

     $ echo 'export PATH="$HOME/.nodenv/bin:$PATH"' >> ~/.bash_profile

   • En Zsh:

     $ echo 'export PATH="$HOME/.nodenv/bin:$PATH"' >> ~/.zshrc

   • En Fish shell:

     $ set -Ux fish_user_paths $HOME/.nodenv/bin $fish_user_paths

2. Instalar node build

   # https://github.com/nodenv/node-build#installation
   # macOS
   $ brew install node-build
   
   # Cualquiera de las 2 opciones siguientes debería servir para Ubuntu 20.04+ y WSL2
   # As a nodenv plugin
   $ mkdir -p "$(nodenv root)"/plugins
   $ git clone https://github.com/nodenv/node-build.git "$(nodenv root)"/plugins/node-build
   
   # As a standalone program
   $ git clone https://github.com/nodenv/node-build.git
   $ PREFIX=/usr/local ./node-build/install.sh

3. Reinicia tu shell para que se apliquen todos los cambios.

4. Verifica que nodenv se instaló correctamente con el siguiente script llamado nodenv-doctor:

   curl -fsSL https://github.com/nodenv/nodenv-installer/raw/master/bin/nodenv-doctor | bash

   Con este script deberías ver algo así:

   

   Si se encuentra algún error de instalación, refiere a la documentación oficial.

5. Instalar plugins necesarios (es posible que ya se te hayan instalado algunos)

   • nodenv-vars:

      mkdir -p $(nodenv root)/plugins
      cd $(nodenv root)/plugins
      git clone https://github.com/nodenv/nodenv-vars.git

   • nodenv-aliases:

     git clone https://github.com/nodenv/nodenv-aliases.git $(nodenv root)/plugins/nodenv-aliases

   • node-build:

     mkdir -p "$(nodenv root)"/plugins
     git clone https://github.com/nodenv/node-build.git "$(nodenv root)"/plugins/node-build

   • Instalar yarn (npm install -g yarn o https://github.com/pine/nodenv-yarn-install para no tener que instalarlo a mano con cada versión de node)

Instalando versiones de node

Para instalar nuevas versiones de node:

# Actualizar las versiones de node disponibles para instalar
cd $(nodenv root)/plugins/node-build && git pull
# o en OSX
brew upgrade node-build

# Listar todos las versiones disponibles para instalar
nodenv install --list

# Instalar una version en particular
nodenv install 12.19.1

# Establecer una version global de node
nodenv global 12.19.1