Instalar node:cómo instalar múltiples versiones con asdf-nodejs y comprobar rutas

En este post, vamos a echar un vistazo rápido al entorno de desarrollo JavaScript y resumir la mejor manera de instalar node, npm, e incluso yarn. En particular, vamos a utilizar un gestor de versiones para instalar node, que es una gran manera de prepararse para las muchas versiones de node que puede utilizar en el futuro.

1. Entendiendo el entorno de desarrollo JavaScript

JavaScript (JS para abreviar) fue creado como un lenguaje para añadir funcionalidad dinámica a HTML en los navegadores web. Como tal, el código JS sólo podía ejecutarse dentro de un navegador web.

Pero en 2009, Ryan Dahl lanzó un tiempo de ejecución de JS llamado node.js, basado en el motor V8 del navegador Chrome. Ahora era posible ejecutar JS fuera de un navegador web.

Con node como trampolín, JS se convirtió rápidamente en un lenguaje de uso generalizado. En particular, su sintaxis simple, potente rendimiento asíncrono, estructura de bucle de eventos, y vastas bibliotecas apoyadas por la comunidad lo han convertido en un favorito de los desarrolladores en todas las plataformas, no sólo la Web. El desarrollo de JS comienza con la instalación de node en cualquier plataforma. Al igual que el desarrollo Java comienza con la instalación del JDK.

La forma más sencilla de instalar node es descargar el archivo instalador desde el sitio web oficial y ejecutarlo. Sin embargo, este método requiere que pases por un engorroso proceso de instalación si necesitas varias versiones de node. Para solucionar este problema, existen varios gestores de versiones que pueden ayudarte a instalar y cambiar entre diferentes versiones de JS.

El gestor de versiones que utilizaremos es asdf-nodejs.

2. asdf-nodejs

asdf-nodejs es un plugin que permite a asdf gestionar node.js. Podemos instalar varios plugins de lenguajes y herramientas de desarrollo en asdf, permitiéndonos controlar la versión de casi cualquier lenguaje y herramienta con un solo programa. Ver el post de asdf para más información.

asdf-nodejs es uno de los cuatro plugins que son mantenidos oficialmente por el equipo de asdf. Así que puedes usarlo con confianza. Los siguientes pasos asumen que has instalado y configurado ASDF usando el post anterior.

3. Instalando el plugin asdf-nodejs

Todo lo que sigue es lo mismo para MacOS y Windows. Abre el terminal que utilices en cada SO y escribe el siguiente comando para añadir el plugin.

asdf plugin add nodejs https://github.com/asdf-vm/asdf-nodejs.git

Si no aparece ningún mensaje de error, se ha instalado correctamente. Para verificar que el plugin funciona, escribe el siguiente comando, que listará todas las versiones de nodos que puedes instalar.

asdf list all nodejs

Resultado de la ejecución:

Como puedes ver, obtendrás un montón de versiones de nodos. Si necesitas una versión específica, comprueba si está disponible para su instalación. Si no, puedes instalar la última versión Long-Term Support (LTS) para el servicio que estás desplegando, o la última versión Current.

Realice una instalación ligera, ya que puede cambiar fácilmente de versión si se encuentra con problemas de compatibilidad de bibliotecas.

Como se muestra arriba, también puedes usar el comando asdf list all nodejs [cadena_especifica] para listar sólo las versiones que contengan una cadena específica.

4. Instalar el último nodo con asdf-nodejs

Una vez que hayas decidido qué versión de nodejs instalar, vamos a instalarla. Yo voy a instalar la versión LTS. Como muestra el comando list all, las últimas versiones LTS de node tienen sus propios nombres en clave. Los últimos nombres de código LTS se pueden encontrar en el archivo CHANGELOG.md en el github de nodejs (opens in a new tab) o en el archivo CODENAMES.md (opens in a new tab).

El comando para instalar node es

asdf install nodejs [nombre_versión]

Para [nombre_versión], puede introducir cualquier nombre de código para el gancho de versión exacto. También puede especificar lts o latest para instalar la última versión LTS o la versión actual, respectivamente.

Tras la instalación, ejecuta el siguiente comando para comprobar qué versión tienes instalada en tu máquina.

asdf list nodejs

Resultado de la ejecución:

5. Comprobar la ruta de instalación de node js

Las diferentes versiones de node instaladas por asdf-nodejs están todas almacenadas dentro de ~/.asdf/installs/nodejs. También puede obtener la ruta de instalación de una versión específica con el siguiente comando.

asdf where nodejs [nombre_versión]

Resultado de la ejecución:

Usando el comando ls -al, puedo ver que si instalé con un nombre en clave, instalará la versión correcta y creará un enlace apuntando a ella.

6. Ajustar a la versión de nodo instalada

Ahora que has descargado e instalado node, necesitas configurar tu máquina para usar la versión de node que has instalado. asdf-nodejs te permite configurar el nodo deseado en tres áreas

• Usar en el shell actual
• Usar en el directorio actual
• Usar en cualquier parte de este ordenador

Si se establecen los tres ámbitos, tienen la máxima prioridad, en este orden: shell, directorio y global.

6.1. Activar en el shell actual

Para activar sólo en el shell actual, el comando es

asdf shell nodejs [nombre_versión]

En este caso, si cierra el intérprete de órdenes saliendo del terminal actualmente abierto, se restablecerán los ajustes.

El resultado de la ejecución:

Comprobar la versión del nodo tras la reejecución del shell:

En el ejemplo anterior, se puede ver que la versión 19 de nodo que se utilizó originalmente en la máquina se cambió a 18 por el comando asdf shell. Después de eso, cuando se volvió a abrir el terminal y se abrió un nuevo shell, se inicializaron las configuraciones.

6.2. Utilización en el directorio actual

He aquí cómo establecer la versión de nodo utilizada en el directorio actual. Esto puede ser muy útil si utilizas diferentes versiones en diferentes proyectos, ya que cargará automáticamente la versión que establezcas. El comando es el siguiente

asdf local nodejs [nombre_versión]

Comprobémoslo con un ejemplo.

Resultado de la ejecución:

Hemos creado un directorio llamado node-test y hemos utilizado el comando para habilitar la versión 18 de node. El nodo utilizado por el directorio padre es la versión 19. Sin embargo, si entras en el directorio node-test, verás que cambia automáticamente a la versión 18 que estableciste.

6.3. Habilitar en toda la máquina

Finalmente, podemos habilitarlo en toda la máquina. El comando es el siguiente

asdf global nodejs [nombre_versión]

De nuevo, comprobémoslo con un ejemplo.

El resultado de la ejecución:

Originalmente estaba configurado con la versión 19, y cuando escribimos el comando asdf list nodejs, aparecía con el prefijo *. Entonces lo cambié a la versión LTS con el comando global, y puedes ver que ha cambiado a esa versión. Si vuelves a cambiar a 19 con el mismo comando, cambiará normalmente.

7. Verificar la ruta al archivo ejecutable node.js configurado

Como referencia, la ruta al ejecutable de node configurado con asdf es siempre ~/.asdf/shims/node. ASDF ejecuta la versión configurada de NODE utilizando una técnica comúnmente conocida como shim. La ruta se muestra a continuación.

which node

Resultado de la ejecución:

8. Instalar npm

8.1. Comprobar versión de npm

npm, el gestor de paquetes más popular utilizado por node, se instala con node cuando se instala. Diferentes versiones de node instalan diferentes versiones de npm, y los paquetes que instalan se gestionan de forma diferente. Si cambias tu versión de node y luego compruebas la versión con el comando npm --version, verás que diferentes versiones de node tienen diferentes versiones de npm.

Resultado de la ejecución:

8.2. Comprobación de la ruta de instalación de npm

La ruta del ejecutable npm instalado es ~/.asdf/shims/npm, y la ruta real instalada es ~/.asdf/installs/nodejs/[nombre_version]/lib/node_modules/npm/bin/npm-cli.js.

Verificar ruta de instalación npm](/images/js/env/asdf-node/13.webp)

8.3.. Verificar la ruta de instalación de npx

La ruta del ejecutable npm instalado es ~/.asdf/shims/npx, y la ruta real instalada es ~/.asdf/installs/nodejs/[version_name]/lib/node_modules/npm/bin/npx-cli.js.

9. Instalar yarn

Junto con npm, yarn, uno de los gestores de paquetes JS más populares, también puede instalarse fácilmente usando asdf. Sin embargo, yarn siempre instala node primero, por lo que instalarlo con asdf hará que tengas que reinstalar node. Por lo tanto, recomendamos instalarlo como un paquete global usando npm para cada versión de node.

Con node instalado globalmente, escribe el siguiente comando.

npm install --global yarn

Resultado de la ejecución:

Si la instalación se completa con éxito, compruebe la lista de paquetes con el siguiente comando.

npm list --global

El resultado de la ejecución:

9.1. Comprobación de la versión de yarn

Por último, comprueba el resultado del comando de comprobación de la versión de yarn.

yarn --version

Resultado de la ejecución:

10. Conclusión

asdf-nodejs es una de las mejores formas de instalar node, npm y yarn. En particular, la capacidad de especificar una versión de node en una carpeta específica y la capacidad de cambiar fácilmente la versión que está utilizando en su máquina es algo que creo que voy a utilizar mucho en el futuro. Espero que este post te ayude a empezar con el desarrollo JS de forma rápida y sencilla.