Configuration de l'interface de ligne de commande EB (EB CLI) pour gérer Elastic Beanstalk - AWS Elastic Beanstalk
Installation de la CLI EBInstallation manuelleInstaller dans virtualenvInstallation de l'interface de ligne de commande EB avec Homebrew

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Configuration de l'interface de ligne de commande EB (EB CLI) pour gérer Elastic Beanstalk

L'EB CLI est une interface de ligne de commande qui fournit des commandes interactives pour créer, mettre à jour et surveiller des environnements dans AWS Elastic Beanstalk. Le projet open source EB CLI est sur Github : aws/aws-elastic-beanstalk-cli

Après avoir installé l'interface de ligne de commande EB et configuré un répertoire de projet, vous pouvez créer des environnements via une seule commande :

$ eb create <my-beanstalk-environment>

Nous vous recommandons d'effectuer l'installation à l'aide du script d'installation. Découvrez comment procéder dansInstallation de la CLI EB avec un script de configuration (recommandé).

AWS CLI Fournit un accès direct à Elastic APIs Beanstalk de bas niveau. Bien que puissant, il est également verbeux et moins préféré à l'EB CLI. Par exemple, la création d'un environnement avec le AWS CLI nécessite les séries de commandes suivantes :

$ aws elasticbeanstalk check-dns-availability \
    --cname-prefix my-cname
$ aws elasticbeanstalk create-application-version \
    --application-name my-application \
    --version-label v1 \
    --source-bundle S3Bucket=amzn-s3-demo-bucket,S3Key=php-proxy-sample.zip
$ aws elasticbeanstalk create-environment \
    --cname-prefix my-cname \
    --application-name my-app \
    --version-label v1 \
    --environment-name my-env \
    --solution-stack-name "64bit Amazon Linux 2023 v4.5.0 running Ruby 3.4"

Installation de la CLI EB avec un script de configuration (recommandé)

Nous recommandons le script d'installation

Nous vous recommandons d'utiliser le script d'installation pour configurer l'interface de ligne de commande EB et ses dépendances et éviter les conflits potentiels avec d'autres packages Python.

Pré-requis : Git, Python et virtualenv

Pour télécharger et utiliser le script d'installation

  1. Pour cloner le référentiel.

    git clone https://github.com/aws/aws-elastic-beanstalk-cli-setup.git

  2. Installez ou mettez à niveau l'interface de ligne de commande EB.

    macOS/Linux dans Bash ou Zsh

    python ./aws-elastic-beanstalk-cli-setup/scripts/ebcli_installer.py

    Fenêtre dans PowerShell ou fenêtre de commande

    python .\aws-elastic-beanstalk-cli-setup\scripts\ebcli_installer.py

  3. Vérifiez que l'interface de ligne de commande EB est installée correctement.

    $ eb --version
EB CLI 3.21.0 (Python 3.12)

Pour obtenir des instructions d'installation complètes, consultez le aws/aws-elastic-beanstalk-cli-setupréférentiel sur GitHub.

Installation manuelle de l'interface de ligne de commande EB

Vous pouvez installer l'interface de ligne de commande EB sous Linux, macOS et Windows à l'aide pip du gestionnaire de packages pour Python qui permet l'installation, la mise à niveau et la suppression des packages Python et de leurs dépendances.

Nous recommandons le script d'installation

Nous vous recommandons d'utiliser le Installation de la CLI EB pour configurer l'interface de ligne de commande EB et éviter les conflits de dépendance.

Prérequis : une version compatible de Python doit être installée. Vous pouvez le télécharger depuis la page de téléchargement de Python sur le site Web de Python.

Pour installer l'interface de ligne de commande EB (manuellement)

  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.

    Résolution des problèmes

    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.12/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 représenté par LOCAL_PATH à la PATH variable en cours.

        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é parPROFILE_SCRIPT. 

        $ source ~/PROFILE_SCRIPT

    • Sous Windows :

      Python 3.12 — %USERPROFILE%\AppData\Roaming\Python\Python312\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.21.0 (Python 3.12)

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

Installation de l'interface de ligne de commande EB dans un environnement virtuel

Pour éviter les conflits entre exigences des versions et autres packages pip, vous pouvez installer l'interface de ligne de commande EB dans un environnement virtuel.

Pour installer l'interface de ligne de commande EB dans un environnement virtuel

  1. Tout d'abord, installez virtualenv avecpip.

    $ pip install --user virtualenv

  2. Créez un environnement virtuel.

    $ virtualenv ~/eb-ve

    L'option -p vous permet d'utiliser un exécutable Python autre que l'exécutable par défaut. 

    $ virtualenv -p /usr/bin/python3.12 ~/eb-ve

  3. Activez l’environnement virtuel.

    Linux, Unix ou macOS

    $ source ~/eb-ve/bin/activate

    Windows

    $ %USERPROFILE%\eb-ve\Scripts\activate

  4. Installation de l'interface de ligne de commande EB.

    (eb-ve)$ pip install awsebcli --upgrade

  5. Vérifiez que l'interface de ligne de commande EB est installée correctement.

    $ eb --version
EB CLI 3.23.0 (Python 3.12)

La commande deactivate vous permet de quitter l'environnement virtuel. Exécutez à nouveau la commande d'activation chaque fois que vous démarrez une nouvelle session.

Pour effectuer une mise à niveau vers la dernière version, exécutez à nouveau la commande d'installation.

(eb-ve)$ pip install awsebcli --upgrade

Installation de l'interface de ligne de commande EB avec Homebrew

La dernière version de l'interface de ligne de commande EB est généralement disponible sur Homebrew quelques jours après qu'elle s'est affichée dans pip.

Nous recommandons le script d'installation

Nous vous recommandons d'utiliser le Installation de la CLI EB pour configurer l'interface de ligne de commande EB et éviter les conflits de dépendance.

Pour installer l'interface de ligne de commande EB avec Homebrew

  1. Vérifiez que vous utilisez la dernière version de Homebrew.

    $ brew update

  2. Exécutez brew install awsebcli.

    $ brew install awsebcli

  3. Vérifiez que l'interface de ligne de commande EB est installée correctement.

    $ eb --version
EB CLI 3.21.0 (Python 3.12)