Installation manuelle de l'interface de ligne de commande EB

Pour installer l'interface de ligne de commande EB, nous vous recommandons d'utiliser les scripts d’installation de l'interface de ligne de commande EB. Si les scripts d'installation ne sont pas compatibles avec votre environnement de développement, installez manuellement l'interface de ligne de commande EB.

La méthode de distribution principale pour l'interface de ligne de commande EB sous Linux, Windows et macOS est pip. Il s'agit d'un gestionnaire de package pour Python qui fournit un moyen simple d'installer, de mettre à niveau et de supprimer des packages Python et leurs dépendances. Pour macOS, vous pouvez également obtenir la dernière version de l'interface de ligne de commande EB avec Homebrew.

Notes de compatibilité

L'interface de la ligne de commande EB est développée en Python et nécessite Python version 3.11 ou ultérieure.

Nous vous recommandons d'utiliser les scripts d'installation de l'interface de ligne de commande EB pour installer l'interface de ligne de commande EB et ses dépendances. Si vous devez installer manuellement l'interface de ligne de commande EB, il peut être difficile de gérer les conflits de dépendance dans votre environnement de développement.

L'interface de ligne de commande EB et l'AWS Command Line Interface (AWS CLI) partagent une dépendance sur le package Python botocore. En raison d'une nouveauté dans botocorebotocore, les différentes versions de ces deux outils d'interface de ligne de commande dépendent des différentes versions de botocore.

Les dernières versions des deux interfaces de ligne de commande sont compatibles. Si vous devez utiliser une version antérieure, consultez le tableau suivant pour connaître la version compatible à utiliser.

Version de l’interface de ligne de commande EB	Version compatible de l’AWS CLI
3.14.5 ou version antérieure	1.16.9 ou version antérieure
3.14.6 ou version ultérieure	1.16.11 ou version ultérieure

Installer l'interface de ligne de commande EB

Si vous avez déjà pip et une version prise en charge de Python, utilisez la procédure suivante pour installer l'interface de ligne de commande EB.

Si vous n'avez ni Python ni pip, utilisez la procédure indiquée pour votre système d'exploitation :

• Installation de Python, de pip et de l'interface de ligne de commande EB sous Linux

• Installation de l'interface de ligne de commande EB sous macOS

• Installation de Python, de pip et de l'interface de ligne de commande EB sous Windows

Pour installer l'interface de ligne de commande EB

1. Exécutez la commande suivante .

   $ pip install awsebcli --upgrade --user

   L'option --upgrade demande à pip de mettre à niveau toutes les exigences qui sont déjà installées. L'option --user demande à pip d'installer le programme dans un sous-répertoire de votre répertoire utilisateur pour éviter la modification des bibliothèques utilisées par votre système d'exploitation.

   Note

   Si vous rencontrez des problèmes lorsque vous tentez d'installer l'interface de ligne de commande EB avec pip, vous pouvez installer l'interface de ligne de commande EB dans un environnement virtuel pour isoler l'outil et ses dépendances, ou utiliser une version de Python autre que celle que vous utilisez normalement.

2. Ajoutez le chemin d'accès au fichier exécutable à votre variable PATH :

   • Sous Linux et macOS :

     Linux : ~/.local/bin

     macOS : ~/Library/Python/3.7/bin

     Pour modifier votre variable PATH (Linux, Unix ou macOS) :

     1. Recherchez le script de profil de votre shell dans votre dossier utilisateur. Si vous n'êtes pas certain du shell utilisé, exécutez echo $SHELL.

        $ ls -a ~
        .  ..  .bash_logout  .bash_profile  .bashrc  Desktop  Documents  Downloads

        • Bash : .bash_profile, .profile ou .bash_login.

        • Zsh : .zshrc

        • Tcsh : .tcshrc, .cshrc ou .login.

     2. Ajoutez une commande d'exportation à votre script de profil. L'exemple suivant ajoute le chemin d'accès représenté par LOCAL_PATH à la variable PATH actuelle.

        export PATH=LOCAL_PATH:$PATH

     3. Chargez le script de profil décrit à la première étape dans votre session actuelle. L'exemple suivant charge le script de profil représenté par PROFILE_SCRIPT.

        $ source ~/PROFILE_SCRIPT

   • Sous Windows :

     Python 3.7 : %USERPROFILE%\AppData\Roaming\Python\Python37\Scripts

     Versions antérieures de Python : %USERPROFILE%\AppData\Roaming\Python\Scripts

     Pour modifier votre variable PATH (Windows) :

     1. Appuyez sur la touche Windows et entrez environment variables.

     2. Choisissez Modifier les variables d'environnement pour votre compte.

     3. Choisissez PATH, puis Modifier.

     4. Ajoutez des chemins d'accès dans le champ Valeur de la variable, en les séparant par des points virgules. Par exemple: C:\item1\path;C:\item2\path

     5. Choisissez OK deux fois pour appliquer les nouveaux paramètres.

     6. Fermez toutes les fenêtres d'invite de commande en cours d'exécution, puis rouvrez une fenêtre d'invite de commande.

3. Vérifiez que l'interface de ligne de commande EB est installée correctement en exécutant eb --version.

   $ eb --version
   EB CLI 3.14.8 (Python 3.7)

L'interface de ligne de commande Elastic Beanstalk est mise à jour régulièrement pour ajouter une fonctionnalité prenant en charge les dernières fonctions Elastic Beanstalk. Pour effectuez une mise à jour vers la dernière version de l'interface de ligne de commande EB, exécutez à nouveau la commande d'installation.

$ pip install awsebcli --upgrade --user

Si vous devez désinstaller l'interface de ligne de commande EB, utilisez pip uninstall.

$ pip uninstall awsebcli