Comment effectuer une mise à jour vers une version plus récente d'une pile de solutions Node.js dans Elastic Beanstalk ?

Brève description

Votre mise à jour peut échouer si la version actuelle de votre nœud n'est pas prise en charge par la version de nœud de la pile de solutions vers laquelle vous effectuez une mise à niveau, c'est-à-dire la pile de solutions cible.

Si votre mise à jour échoue, vous pouvez recevoir un message d'erreur similaire à ce qui suit :

=============
"Failed Environment update activity. Reason: Configuration validation exception: Invalid option value: '4.8.4' (Namespace: 'aws:elasticbeanstalk:container:nodejs', OptionName: 'NodeVersion'): Value is not one of the allowed values: 
[4.8.7, 4.9.1, 5.12.0, 6.15.1, 6.16.0, 6.17.0, 6.17.1, 7.10.1, 8.14.0, 8.15.0, 8.15.1, 8.16.0, 8.16.1, 8.16.2, 8.17.0, 10.14.1, 10.15.0, 10.15.1, 10.15.3, 10.16.0, 10.16.1, 10.16.2, 10.16.3, 10.17.0, 10.18.0, 10.18.1, 10.19.0, 12.14.0, 12.14.1, 12.15.0, 12.16.1]".
=============

Pour résoudre ce problème, choisissez l'une des options suivantes :

• Pour créer un nouvel environnement, effectuez un déploiement bleu/vert.
• Pour utiliser votre environnement existant, effectuez une mise à jour en deux parties en suivant la procédure décrite dans la section Solution ci-dessous. Commencez par mettre à jour la version de votre nœud Node.js, puis mettez à jour votre pile de solutions.

Solution

Important : les étapes suivantes ne sont valables que pour les piles de solutions basées sur l'AMI Amazon Linux (également appelée Amazon Linux 1) abandonnée. Pour les piles de solutions basées sur Amazon Linux 2, la version du nœud peut être modifiée uniquement en créant un nouvel environnement de la pile de solutions correspondante. Pour plus d'informations sur la configuration de votre version de Node.js sur les plateformes Amazon Linux 2, consultez Spécification des dépendances Node.js avec un fichier package.json.

1. Ouvrez la console Elastic Beanstalk.
2. Dans le volet de navigation, sélectionnezEnvironments (Environnements), puis choisissez votre environnement.
3. Dans la section du volet de navigation de votre environnement, choisissez Configuration.
4. Pour la ligne Software (Logiciel) dans la colonne Category (Catégorie), choisissez Edit (Modifier).
5. Pour Node.js version (Version de Node.js), sélectionnez une version de nœud prise en charge par votre pile de solutions cible.
   Important : la version du nœud doit être prise en charge par votre pile de solutions actuelle et votre pile de solutions cible. Par exemple, si votre environnement Elastic Beanstalk s'exécute sur une pile de solutions Amazon Linux 64 bits 2018.03 v4.5.1 exécutant Node.js avec la version de nœud 8.11.3, vous pouvez effectuer une mise à niveau uniquement vers une pile de solutions cible qui prend en charge la version de nœud 8.11.3. Pour voir quelles versions de nœud sont prises en charge par chaque type de pile de solutions, consultez l'historique de la plateforme Node.js.
6. Pour mettre à niveau votre nœud vers une version ultérieure ou antérieure, choisissez Apply (Appliquer).
7. Effectuez la mise à niveau ou la rétrogradation vers la version de plateforme de votre pile de solutions cible.