Cómo instalar asdf para gestionar múltiples versiones de tiempo de ejecución de lenguajes de programación en Ubuntu 22.04

Introducción

asdf es una herramienta de interfaz de línea de comandos, o CLI, para gestionar diferentes versiones de tiempo de ejecución en varios lenguajes de programación. Unifica todos los tiempos de ejecución bajo un archivo de configuración y utiliza una estructura de complementos para gestionar todo con una sola herramienta. Como ejemplo, puedes instalar Node.js, pero luego tener asdf como un repositorio central de complementos con cada complemento mantenido oficialmente o por contribuyentes de la comunidad.

En este tutorial, instalarás el núcleo de asdf y el complemento de Node.js con dependencias de compilación, que es lo mínimo requerido para la funcionalidad. Luego, instalarás Node.js y gestionarás la versión que deseas utilizar, dependiendo de tu alcance deseado.

Prerrequisitos

• Un servidor Ubuntu 22.04, configurado según nuestra guía de configuración inicial del servidor para Ubuntu 22.04, con un usuario no root con privilegios de sudo y un firewall habilitado.

Paso 1 — Instalación del núcleo de asdf

asdf depende de la instalación de un núcleo que, por sí solo, no tiene funcionalidad. El núcleo de asdf se basa en complementos separados que son específicos para un lenguaje de programación o programa determinado. Comúnmente, se utiliza para instalar y gestionar múltiples versiones de un lenguaje de programación dado. Se recomienda que descargues el núcleo de asdf con git, que viene instalado con Ubuntu 22.04. Para obtener la última versión de asdf, clona la última rama del repositorio de asdf:

git clone https://github.com/asdf-vm/asdf.git ~/.asdf --branch v0.10.2

asdf requiere una instalación única dependiendo de la combinación de tipo de shell y método con el que se descargó. Por defecto, Ubuntu utiliza Bash para su shell, que utiliza el archivo ~/.bashrc para la configuración y personalización. Para habilitar el uso del comando asdf, tendrás que añadir la siguiente línea:

echo ". $HOME/.asdf/asdf.sh" >> ~/.bashrc

A continuación, asegúrate de que tus cambios se apliquen a tu sesión actual:

source ~/.bashrc

Con el núcleo instalado, ahora puedes instalar el complemento.

Paso 2: Instalar el complemento asdf Node.js y las dependencias de compilación

Instalar el complemento para Node.js en asdf no es lo mismo que instalar Node.js por sí mismo. Eso ocurrirá en el próximo paso. Como se mencionó anteriormente, los requisitos mínimos para una configuración asdf utilizable son el núcleo de asdf y al menos un complemento. Una vez que instales este complemento, podrás usarlo para instalar el tiempo de ejecución que maneja.

Cada complemento de asdf se mantiene por separado. Algunos son mantenidos por el equipo central de asdf, pero la mayoría son mantenidos por la comunidad. Cada complemento de asdf tiene su propio repositorio y dependencias que deben instalarse. Debes verificar cada repositorio de complementos, como con el repositorio del complemento Node.js. Este complemento en particular está oficialmente mantenido por el equipo de asdf.

Para instalar el complemento, utiliza el siguiente comando asdf plugin add:

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

Para este complemento de Node.js, las dependencias se mencionan en la sección “Uso” de su archivo “README”. Dentro de esa sección, las dependencias explícitas están vinculadas en la sección de los repositorios oficiales de Node.js sobre la construcción de Node.js. Esto debe hacerse manualmente porque asdf es una solución dirigida a múltiples sistemas operativos, cada uno con sus propias dependencias y métodos únicos para instalarlas. Esto también puede variar de un complemento a otro. Para este complemento en Ubuntu, es necesario instalar estas dependencias. Comience actualizando el índice de origen de su apt:

sudo apt update

Luego, puede instalar las dependencias requeridas:

sudo apt install python3 g++ make python3-pip

Para este complemento de Node.js, dependiendo de la versión que necesite instalar, elige entre binarios precompilados o compila binarios desde el origen. Si elige una versión que requiere compilación desde el origen, se requieren las dependencias mencionadas anteriormente.

Con el complemento instalado con éxito, a continuación, puede instalar Node.js.

Paso 3 — Instalación de Node.js

Puede instalar varias versiones de Node.js, eligiendo entre la última o cualquier versión especificada. Para instalar la última versión de Node.js, ingrese lo siguiente:

asdf install nodejs latest

Output
Trying to update node-build... ok
Downloading node-v18.10.0-linux-x64.tar.gz...
-> https://nodejs.org/dist/v18.10.0/node-v18.10.0-linux-x64.tar.gz
Installing node-v18.10.0-linux-x64...
Installed node-v18.10.0-linux-x64 to /home/sammy/.asdf/installs/nodejs/18.10.0

Instalar la última versión es un atajo proporcionado por asdf, no es una versión especial. asdf identifica y hace cumplir las versiones por sus números exactos. Para instalar una versión específica de Node.js, ingresa lo siguiente:

asdf install nodejs 16.16.0

Output
Trying to update node-build... ok
Downloading node-v16.16.0-linux-x64.tar.gz...
-> https://nodejs.org/dist/v16.16.0/node-v16.16.0-linux-x64.tar.gz
Installing node-v16.16.0-linux-x64...
Installed node-v16.16.0-linux-x64 to /home/sammy/.asdf/installs/nodejs/16.16.0

Con estas dos versiones instaladas, puedes verificar todas las versiones que tienes con lo siguiente:

asdf list nodejs

Output
  16.16.0
  18.10.0

Además, si alguna vez deseas eliminar una versión, puedes usar el comando uninstall con un objetivo de versión específico:

asdf uninstall nodejs 16.16.0

Ahora que Node.js está instalado, puedes elegir la versión que deseas activar.

Paso 4 — Elegir la Versión Activa de Node.js

asdf puede establecer la versión de Node.js en tres niveles diferentes: local, global y shell. Si solo quieres establecer la versión de Node.js para el directorio de trabajo de tu proyecto, ejecuta lo siguiente:

asdf local nodejs latest

Establecer la versión actual a nivel global actúa a nivel de usuario para tu sistema:

asdf global nodejs latest

Si solo deseas establecer la versión para la sesión actual de la terminal, ingresa lo siguiente:

asdf shell nodejs latest

Ahora tienes una instalación completa de Node.js usando asdf, con la capacidad de cambiar a la versión que necesitas en el ámbito que desees.

Conclusión

En este tutorial, instalaste el núcleo de asdf, el complemento de Node.js para asdf y luego Node.js en sí mismo. asdf permite instalar múltiples versiones de un entorno de ejecución, y puedes elegir la versión en diferentes niveles de alcance, desde global hasta el directorio de trabajo del proyecto. Si estás interesado en una instalación convencional de Node.js, consulta nuestro tutorial sobre cómo instalar Node.js en Ubuntu 22.04.