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
<a name="eb-cli3"></a>

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](https://github.com/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 dans[Installation de la CLI EB avec un script de configuration (recommandé)](#eb-cli3-install).

 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é)
<a name="eb-cli3-install"></a>

**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](https://virtualenv.pypa.io/en/latest/installation.html)

**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
   ```

1. 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
   ```

1. 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 [https://github.com/aws/aws-elastic-beanstalk-cli-setup](https://github.com/aws/aws-elastic-beanstalk-cli-setup)référentiel sur GitHub.

## Installation manuelle de l'interface de ligne de commande EB
<a name="eb-cli3-install-advanced"></a>

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](#eb-cli3-install) 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](https://www.python.org/downloads/) 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](#eb-cli3-install-virtualenv) pour isoler l'outil et ses dépendances, ou utiliser une version de Python autre que celle que vous utilisez normalement.

1. 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`.

     1. Ajoutez une commande d’exportation à votre script de profil. L'exemple suivant ajoute le chemin représenté par *LOCAL\$1PATH* à la `PATH` variable en cours.

        ```
        export PATH=LOCAL_PATH:$PATH
        ```

     1. 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\$1SCRIPT*. 

        ```
        $ 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**.

     1. Choisissez **Modifier les variables d'environnement pour votre compte**.

     1. Choisissez **PATH**, puis **Modifier**.

     1. 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`

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

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

1. 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](https://docs.aws.amazon.com/elasticbeanstalk/latest/relnotes/). 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
<a name="eb-cli3-install-virtualenv"></a>

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` avec`pip`.

   ```
   $ pip install --user virtualenv
   ```

1. 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
   ```

1. Activez l’environnement virtuel.

   **Linux, Unix ou macOS**

   ```
   $ source ~/eb-ve/bin/activate
   ```

   **Windows**

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

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

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

1. 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
<a name="eb-cli3-install-osx-homebrew"></a>

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](#eb-cli3-install) 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
   ```

1. Exécutez `brew install awsebcli`.

   ```
   $ brew install awsebcli
   ```

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

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