Comment installer asdf pour gérer plusieurs versions d’exécution de langages de programmation sur Ubuntu 22.04

Introduction

asdf est un outil d’interface en ligne de commande, ou outil CLI, pour gérer différentes versions d’exécution à travers plusieurs langages de programmation. Il unifie toutes les versions d’exécution sous un seul fichier de configuration, et utilise une structure de plugin pour gérer tout avec un seul outil. Par exemple, vous pouvez installer Node.js, mais ensuite avoir asdf comme un dépôt central de plugins avec chaque plugin étant maintenu soit officiellement soit par des contributeurs de la communauté.

Dans ce tutoriel, vous installerez le noyau asdf et le plugin Node.js avec les dépendances de construction, ce qui est le minimum requis pour la fonctionnalité. Ensuite, vous installerez Node.js et gérerez la version que vous souhaitez utiliser, en fonction de votre portée désirée.

Prérequis

• Un serveur Ubuntu 22.04, configuré selon notre guide de configuration initiale du serveur pour Ubuntu 22.04, avec un utilisateur non-root avec des privilèges sudo et un pare-feu activé.

Étape 1 — Installation du noyau asdf

asdf repose sur l’installation d’un noyau qui, seul, n’a pas de fonctionnalité. Le noyau asdf repose sur des plugins séparés qui sont spécifiques à un langage de programmation ou à un programme donné. Le plus souvent, il est utilisé pour installer et gérer plusieurs versions d’un langage de programmation donné. Il est recommandé de télécharger le noyau asdf avec git, qui est installé avec Ubuntu 22.04. Pour obtenir la dernière version de asdf, clonez la dernière branche du référentiel asdf :

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

asdf nécessite une installation unique en fonction de la combinaison du type de shell et de la méthode de téléchargement. Par défaut, Ubuntu utilise Bash pour son shell, qui utilise le fichier ~/.bashrc pour la configuration et la personnalisation. Pour activer l’utilisation de la commande asdf, vous devrez ajouter la ligne suivante :

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

Ensuite, assurez-vous que vos modifications sont appliquées à votre session en cours :

source ~/.bashrc

Avec le noyau installé, vous pouvez maintenant installer le plugin.

Étape 2 — Installation du plugin Node.js asdf et des dépendances de construction

L’installation du plugin pour Node.js pour asdf n’est pas la même que l’installation de Node.js seul. Cela se fera à l’étape suivante. Comme mentionné précédemment, les exigences minimales pour une configuration asdf utilisable sont le noyau asdf et au moins un plugin. Une fois ce plugin installé, vous pouvez l’utiliser pour installer le runtime qu’il gère.

Chaque plugin asdf est maintenu séparément. Certains sont maintenus par l’équipe centrale asdf, mais la plupart sont maintenus par la communauté. Chaque plugin asdf a son propre référentiel et ses propres dépendances qui doivent être installées. Vous devez vérifier chaque référentiel de plugin, comme avec le référentiel du plugin Node.js . Ce plugin en particulier est officiellement maintenu par l’équipe asdf.

Pour installer le plugin, utilisez la commande asdf plugin add suivante:

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

Pour ce plugin Node.js, les dépendances sont mentionnées dans la section « Utilisation » de leur fichier « README ». À l’intérieur de cette section, les dépendances explicites sont liées à la section des référentiels officiels Node.js sur la construction de Node.js. Cela doit être fait manuellement car asdf est une solution destinée à plusieurs systèmes d’exploitation, chacun ayant ses propres dépendances uniques et ses méthodes d’installation. Cela peut également varier d’un plugin à l’autre. Pour ce plugin sur Ubuntu, vous devez installer ces dépendances. Commencez par mettre à jour l’index de votre source apt:

sudo apt update

Ensuite, vous pouvez installer les dépendances requises :

sudo apt install python3 g++ make python3-pip

Pour ce plugin Node.js, en fonction de la version que vous devez installer, il choisit soit des binaires précompilés, soit compile des binaires à partir de la source. Si vous choisissez une version qui nécessite une compilation à partir de la source, les dépendances susmentionnées sont nécessaires.

Avec le plugin installé avec succès, vous pouvez ensuite installer Node.js.

Étape 3 — Installation de Node.js

Vous pouvez installer plusieurs versions de Node.js, en choisissant parmi les dernières ou des versions spécifiées. Pour installer la dernière version de Node.js, saisissez ce qui suit :

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

Installer la version latest est un raccourci fourni par asdf, ce n’est pas une version spéciale. asdf identifie et impose les versions par leurs numéros exacts. Pour installer une version spécifique de Node.js, saisissez ce qui suit :

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

Avec ces deux versions installées, vous pouvez vérifier toutes les versions que vous avez avec ce qui suit :

asdf list nodejs

Output
  16.16.0
  18.10.0

De plus, si vous souhaitez supprimer une version à tout moment, vous pouvez utiliser la commande uninstall avec une version spécifique :

asdf uninstall nodejs 16.16.0

Maintenant que Node.js est installé, vous pouvez choisir la version que vous souhaitez activer.

Étape 4 — Choix de la version active de Node.js

asdf peut définir la version de Node.js à trois niveaux différents : local, global et shell. Si vous souhaitez uniquement définir la version de Node.js pour le répertoire de travail de votre projet, exécutez ce qui suit :

asdf local nodejs latest

Définir la version actuelle au niveau global agit au niveau de l’utilisateur pour votre système :

asdf global nodejs latest

Si vous souhaitez uniquement définir la version pour la session shell en cours, saisissez ce qui suit :

asdf shell nodejs latest

Maintenant, vous avez une installation complète de Node.js en utilisant asdf, avec la possibilité de passer à la version dont vous avez besoin dans la portée que vous souhaitez.

Conclusion

Dans ce tutoriel, vous avez installé le noyau asdf, le plugin Node.js asdf, puis Node.js lui-même. asdf permet d’installer plusieurs versions d’un runtime, et vous pouvez choisir la version à différents niveaux de portée, de manière globale jusqu’au répertoire de projet en cours. Si vous êtes intéressé par une installation conventionnelle de Node.js, consultez notre tutoriel sur comment installer Node.js sur Ubuntu 22.04.