"`. Pour spécifier le nom de fichier sans un`path`, enregistrez-le dans le dossier dans lequel vous exécutez la commande. Vous pouvez sinon spécifier le nom de fichier en fournissant le chemin d'accès complet. Les informations de configuration doivent répondre aux conditions suivantes. Au moins une des sections,**OptionSettings** ou **OptionsToRemove**, est requise. Utilisez **OptionSettings** pour ajouter ou modifier des options. Utilisez **OptionsToRemove** pour supprimer des options d'un espace de noms. Pour obtenir des exemples spécifiques, consultez la section [Exemples](#eb3-configexample) plus loin dans cette rubrique.
**Example**
*Format YAML*
```
OptionSettings:
namespace1:
option-name-1: option-value-1
option-name-2: option-value-2
...
OptionsToRemove:
namespace1:
option-name-1
option-name-2
...
```
**Example**
*Format JSON*
```
{
"OptionSettings": {
"namespace1": {
"option-name-1": "option-value-1",
"option-name-2": "option-value-2",
...
}
},
"OptionsToRemove": {
"namespace1": {
"option-name-1",
"option-name-2",
...
}
}
}
``` |
| [Options courantes](eb3-cmd-options.md) | |
## Output
Si la commande **eb config** ou **eb config *environment-name***est exécutée avec succès sans ajout d'une sous-commande ou d'une option, la commande affiche vos paramètres d'options actuels dans l'éditeur de texte que vous avez configuré en tant que variable d'environnement EDITOR. Si vous n'avez pas configuré de variable d'environnement EDITOR, l'interface de ligne de commande (CLI) EB affiche vos paramètres d'options dans votre éditeur par défaut pour les fichiers YAML.
Lorsque vous enregistrez des modifications dans le fichier et que vous fermez l'éditeur, l'environnement est mis à jour avec les paramètres d'option que vous avez enregistrés dans le fichier. La sortie suivante s'affiche pour confirmer la mise à jour de la configuration.
```
$ eb config myApp-dev
Printing Status:
2021-05-19 18:09:45 INFO Environment update is starting.
2021-05-19 18:09:55 INFO Updating environment myApp-dev's configuration settings.
2021-05-19 18:11:20 INFO Successfully deployed new configuration to environment.
```
Si la commande s'exécute avec succès avec l'option `--display`, elle affiche les paramètres de configuration de l'environnement actuel (écrit dans*stdout*).
Si la commande s'exécute avec succès avec le paramètre `get`, la commande affiche l'emplacement de la copie locale que vous avez téléchargée.
Si la commande s'exécute avec succès avec le paramètre `save`, la commande affiche l'emplacement du fichier enregistré.
## Exemples
Cette section décrit comment modifier l'éditeur de texte que vous utilisez pour afficher et modifier votre fichier de paramètres d'option.
Pour Linux et UNIX, l'exemple suivant remplace l'éditeur par vim :
```
$ export EDITOR=vim
```
Pour Linux et UNIX, l'exemple suivant remplace l'éditeur par ce qui est installé à l'emplacement `/usr/bin/kate`.
```
$ export EDITOR=/usr/bin/kate
```
Pour Windows, l'exemple suivant remplace l'éditeur par Notepad\$1\$1.
```
> set EDITOR="C:\Program Files\Notepad++\Notepad++.exe
```
Cette section fournit des exemples de la commande **eb config** lorsqu'elle est exécutée avec des sous-commandes.
L'exemple suivant supprime la configuration enregistrée nommée `app-tmp`.
```
$ eb config delete app-tmp
```
L'exemple suivant télécharge la configuration enregistrée avec le nom app-tmp depuis votre compartiment Amazon S3.
```
$ eb config get app-tmp
```
L'exemple suivant répertorie les noms des configurations enregistrées qui sont stockées dans votre compartiment Amazon S3.
```
$ eb config list
```
L'exemple suivant télécharge la copie locale de la configuration enregistrée nommée app-tmp dans votre compartiment Amazon S3.
```
$ eb config put app-tmp
```
L'exemple suivant enregistre les paramètres de configuration de l'environnement en cours d'exécution actuel. Si vous ne fournissez pas un nom à utiliser pour la configuration enregistrée, alors Elastic Beanstalk nomme le fichier de configuration en fonction du nom de l'environnement. Par exemple, un environnement nommé *tmp-dev* serait appelé `tmp-dev.cfg.yml`. Elastic Beanstalk enregistre le fichier dans le dossier `/.elasticbeanstalk/saved_configs/`.
```
$ eb config save
```
Dans l'exemple suivant, l'option `--cfg` est utilisée pour enregistrer les paramètres de configuration de l'environnement tmp-dev dans un fichier appelé `v1-app-tmp.cfg.yml`. Elastic Beanstalk enregistre le fichier dans le dossier `/.elasticbeanstalk/saved_configs/`. Si vous ne spécifiez pas un nom d'environnement, Elastic Beanstalk enregistre les paramètres de configuration de l'environnement en cours d'exécution actuel.
```
$ eb config save tmp-dev --cfg v1-app-tmp
```
Cette section fournit des exemples de commande **eb config** lorsqu'elle est exécutée sans sous-commande.
La commande suivante affiche les paramètres d'options de votre environnement actuel dans un éditeur de texte.
```
$ eb config
```
La commande suivante affiche les paramètres d'options de l'environnement *my-env* dans un éditeur de texte.
```
$ eb config my-env
```
L'exemple suivant affiche les paramètres d'options de votre environnement actuel. Il sort au format YAML car aucun format spécifique n'a été spécifié avec l'option `--format`.
```
$ eb config --display
```
L'exemple suivant met à jour les paramètres d'options de votre environnement actuel avec les spécifications du fichier nommé `example.txt`. Le fichier a un format YAML ou JSON. L'interface de ligne de commande (CLI) EB détecte automatiquement le format de fichier.
+ L'option Minsize est définie sur 1 pour l'espace de noms `aws:autoscaling:asg`.
+ La taille du lot de l'espace de noms `aws:elasticbeanstalk:command` est définie sur 30 %.
+ Il supprime le paramètre d'option *IdleTimeout: None* de l'espace de noms`AWSEBV2LoadBalancer.aws:elbv2:loadbalancer`.
```
$ eb config --update "file://example.txt"
```
**Example - nom de fichier :`example.txt` - format YAML**
```
OptionSettings:
'aws:elasticbeanstalk:command':
BatchSize: '30'
BatchSizeType: Percentage
'aws:autoscaling:asg':
MinSize: '1'
OptionsToRemove:
'AWSEBV2LoadBalancer.aws:elbv2:loadbalancer':
IdleTimeout
```
**Example - nom de fichier :`example.txt` - format JSON**
```
{
"OptionSettings": {
"aws:elasticbeanstalk:command": {
"BatchSize": "30",
"BatchSizeType": "Percentage"
},
"aws:autoscaling:asg": {
"MinSize": "1"
}
},
"OptionsToRemove": {
"AWSEBV2LoadBalancer.aws:elbv2:loadbalancer": {
"IdleTimeout"
}
}
}
```
Les exemples suivants mettent à jour les paramètres d'options de votre environnement actuel. La commande définit l'option Minsize sur 1 pour l'espace de noms `aws:autoscaling:asg`.
**Note**
Ces exemples sont spécifiques à Windows PowerShell. Ils échappent aux occurrences littérales du caractère double guillemet (`"`) en le faisant précéder d'une barre oblique (`\`). Différents systèmes d'exploitation et environnements de ligne de commande peuvent comporter des séquences d'échappement différentes. Pour cette raison, nous vous recommandons d'utiliser l'option de fichier reprise dans les exemples précédents. La spécification des options de configuration dans un fichier ne nécessite pas l'échappement de caractères et est cohérente entre différents systèmes d'exploitation.
L'exemple suivant est au format JSON. L'interface de ligne de commande (CLI) EB détecte si le format est en JSON ou YAML.
```
PS C:\Users\myUser\EB_apps\myApp-env>eb config --update '{\"OptionSettings\":{\"aws:autoscaling:asg\":{\"MaxSize\":\"1\"}}}'
```
L'exemple suivant est au format YAML. Pour saisir la chaîne YAML dans le format correct, la commande inclut l'espacement et les end-of-line retours requis dans un fichier YAML.
+ Terminez chaque ligne avec la touche « Entrée » ou « retour ».
+ Commencez la deuxième ligne par deux espaces et commencez la troisième ligne par quatre espaces.
```
PS C:\Users\myUser\EB_apps\myApp-env>eb config --update 'OptionSettings:
>> aws:autoscaling:asg:
>> MinSize: \"1\"'
```
# **eb console**
## Description
Ouvre un navigateur pour afficher le tableau de bord de configuration de l'environnement d'Elastic Beanstalk Management Console.
Si le répertoire racine contient un fichier `platform.yaml` spécifiant une plateforme personnalisée, cette commande affiche également la configuration de l'environnement de génération, telle qu'indiquée dans `platform.yaml`, dans Elastic Beanstalk Management Console.
## Syntaxe
**eb console**
**eb console *environment-name***
## Options
****
| Nom | Description |
| --- | --- |
| [Options courantes](eb3-cmd-options.md) | |
# **eb create**
## Description
Crée un environnement et y déploie une version de l'application.
**Note**
Pour utiliser **eb create** sur une application .NET, vous devez créer un package de déploiement comme décrit dans [Création d'une solution groupée source pour une application .NET](applications-sourcebundle.md#using-features.deployment.source.dotnet), puis définir la configuration de l'interface de ligne de commande (CLI) pour déployer le package sous forme d'artefact comme décrit dans [Déploiement d'un artefact à la place du dossier de projet](eb-cli3-configuration.md#eb-cli3-artifact).
Créer des environnements avec l'interface de ligne de commande (CLI) EB nécessite un [rôle de service](concepts-roles-service.md). Vous pouvez créer un rôle de service en créant un environnement dans la console Elastic Beanstalk. Si vous n'avez pas de rôle de service, l'interface de ligne de commande (CLI) EB essaie d'en créer un lorsque vous exécutez `eb create`.
Vous pouvez déployer la version de l'application à partir de différentes sources :
+ Par défaut : depuis le code source de l'application dans le répertoire de projet local.
+ À l'aide de l'option `--version` : à partir d'une version de l'application qui existe déjà dans votre application.
+ Lorsque votre projet de répertoire ne dispose pas d'un code d'application ou que vous utilisez l'option `--sample` : déployée à partir d'un exemple d'application spécifique à la plateforme de votre environnement.
## Syntaxe
**eb create**
**eb create *environment-name***
La longueur d'un nom d'environnement doit être comprise entre 4 et 40 caractères. Il ne peut contenir que des lettres, des chiffres et des traits d'union (-). Un nom d'environnement ne peut pas commencer ou se terminer par un trait d'union.
Si vous incluez un nom d'environnement dans la commande, l'interface de ligne de commande (CLI) EB ne vous invite pas à sélectionner ou créer un rôle de service.
Si vous exécutez la commande sans argument de nom d'environnement, elle s'exécute dans un flux interactif et vous invite à saisir ou sélectionner des valeurs pour certains paramètres. Dans ce flux interactif, si vous déployez un exemple d'application, l'interface de ligne de commande (CLI) EB vous demande aussi si vous souhaitez télécharger cet exemple d'application sur votre répertoire de projet local. En la téléchargeant, vous pouvez utiliser l'interface de ligne de commande (CLI) EB avec le nouvel environnement pour exécuter des opérations qui nécessitent le code de l'application, comme [**eb deploy**](eb3-deploy.md).
Certaines invites de flux interactives ne sont affichées que dans certaines conditions. Par exemple, si vous choisissez d'utiliser un équilibreur de charge Application Load Balancer et que votre compte dispose d'au moins un équilibreur de charge Application Load Balancer partageable, Elastic Beanstalk affiche une invite qui vous demande si vous souhaitez utiliser un équilibreur de charge partagé. Si aucun équilibreur de charge Application Load Balancer partageable n'existe dans votre compte, cette invite ne s'affiche pas.
## Options
Aucune de ces options n'est obligatoire. Si vous exécutez **eb create** sans spécifier d'options, l'interface de ligne de commande (CLI) EB vous invite à entrer ou à sélectionner une valeur pour chaque paramètre.
****
| Nom | Description |
| --- | --- |
| `-d` ou `--branch_default` | Définissez l'environnement en tant qu'environnement par défaut pour le référentiel actuel. |
| `--cfg` *config-name* | [Utilisez des paramètres de plateforme à partir d'une configuration enregistrée ](environment-configuration-methods-during.md#configuration-options-during-ebcli-savedconfig) dans `.elasticbeanstalk/saved_configs/` ou votre compartiment Amazon S3. Spécifiez le nom du fichier uniquement, sans l'extension `.cfg.yml`. |
| `-c` *subdomain-name* or `--cname` *subdomain-name* | Nom du sous-domaine devant préfixer l'entrée DNS CNAME qui permet d'accéder à votre site web. Type : chaîne Par défaut : le nom de l'environnement |
| `-db` ou `--database` | Attache une base de données à l'environnement. Si vous exécutez **eb create** avec l'option `--database`, mais sans les options `--database.username` et `--database.password`, l'interface de ligne de commande (CLI) EB vous invite à saisir le nom et le mot de passe de l'utilisateur principal de la base de données. |
| `-db.engine` *engine* or `--database.engine` *engine* | Le type de moteur de base de données. Si vous exécutez **eb create** avec cette option, alors l'interface de ligne de commande (CLI) EB lance l'environnement avec une base de données attachée. C'est le cas même si vous n'avez pas exécuté la commande avec l'option `--database`. Type : chaîne Valeurs valides: `mysql`, `oracle-se1`, `postgres`, `sqlserver-ex`, `sqlserver-web`, `sqlserver-se` |
| `-db.i` *instance\$1type* or `--database.instance` *instance\$1type* | Type d' EC2 instance Amazon à utiliser pour la base de données. Si vous exécutez **eb create** avec cette option, alors l'interface de ligne de commande (CLI) EB lance l'environnement avec une base de données attachée. C'est le cas même si vous n'avez pas exécuté la commande avec l'option `--database`. Type : chaîne Valeurs valides : Amazon RDS prend en charge un ensemble standard d'instances de base de données. Pour sélectionner une instance de base de données appropriée pour votre moteur de base de données, vous devez prendre en compte certaines considérations spécifiques. Pour plus d'informations, consultez [Classes d'instance de base de données](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBInstanceClass.html) dans le *Guide de l'utilisateur Amazon RDS*. |
| `-db.pass` *password* or `--database.password` *password* | Le mot de passe pour la base de données. Si vous exécutez **eb create** avec cette option, alors l'interface de ligne de commande (CLI) EB lance l'environnement avec une base de données attachée. C'est le cas même si vous n'avez pas exécuté la commande avec l'option `--database`. |
| `-db.size` *number\$1of\$1gigabytes* or `--database.size` *number\$1of\$1gigabytes* | Le nombre de gigaoctets (Go) à allouer pour le stockage de base de données. Si vous exécutez **eb create** avec cette option, alors l'interface de ligne de commande (CLI) EB lance l'environnement avec une base de données attachée. C'est le cas même si vous n'avez pas exécuté la commande avec l'option `--database`. Type : nombre Valeurs valides : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/elasticbeanstalk/latest/dg/eb3-create.html) |
| `-db.user` *username* or `--database.username` *username* | Le nom utilisateur pour la base de données. Si vous exécutez **eb create** avec cette option, alors l'interface de ligne de commande (CLI) EB lance l'environnement avec une base de données attachée même si vous n'avez pas exécuté la commande avec l'option `--database`. Si vous exécutez **eb create** avec l'option `--database`, mais sans les options `--database.username` et `--database.password`, alors l'interface de ligne de commande (CLI) EB vous invite pour le mot de passe et le nom utilisateur de base de données principale. |
| `-db.version` *version* or `--database.version` *version* | Utilisé pour spécifier la version du moteur de base de données. Si cet indicateur est présent, l'environnement se lance avec une base de données avec le numéro de version spécifié, même si l'indicateur `--database` n'est pas présent. |
| `--elb-type` *type* | [Type de l'équilibreur de charge](using-features.managing.elb.md). Type : chaîne Valeurs valides: `classic`, `application`, `network` Par défaut: `application` |
| `-es` ou `--enable-spot` | Activez les demandes d'instances Spot pour votre environnement. Pour plus d'informations, consultez [Groupe Auto Scaling](using-features.managing.as.md). Options connexes : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/elasticbeanstalk/latest/dg/eb3-create.html) |
| --env-group-suffix groupname | Le nom du groupe à ajouter au nom de l'environnement. A utiliser uniquement avec [Compose Environments](ebcli-compose.md). |
| `--envvars` | [Propriétés de l'environnement](environments-cfg-softwaresettings.md) dans une liste séparée par des virgules au format *name* =. *value* Pour connaître les limites, consultez [Configuration des propriétés de l'environnement (variables d'environnement)](environments-cfg-softwaresettings.md#environments-cfg-softwaresettings-console). |
| `-ip` *profile\$1name* or `--instance_profile` *profile\$1name* | Le profil d'instance avec le rôle IAM avec les informations d'identification de sécurité temporaires dont votre application a besoin pour accéder aux AWS ressources. |
| `-it` or `--instance-types type1[,type2 ...]` | Liste séparée par des virgules des types d' EC2 instances Amazon que vous souhaitez que votre environnement utilise. Si vous ne spécifiez pas cette option, Elastic Beanstalk fournit les types d'instance par défaut. Pour de plus amples informations, veuillez consulter [ EC2 Instances Amazon](using-features.managing.ec2.md) et [Groupe Auto Scaling](using-features.managing.as.md). L'interface de ligne de commande (CLI) EB applique uniquement cette option aux instances Spot. À moins que cette option soit utilisée avec l'option `--enable-spot`, l'interface de ligne de commande (CLI) EB l'ignore. Pour spécifier un type d'instance pour une instance à la demande, utilisez l'option `--intance-type` (pas de « s ») à la place. |
| `-i` or `--instance_type` | Le type d' EC2 instance Amazon que vous souhaitez que votre environnement utilise. Si vous ne spécifiez pas cette option, Elastic Beanstalk fournit un type d'instance par défaut. Pour plus d'informations, consultez [ EC2 Instances Amazon](using-features.managing.ec2.md). L'interface de ligne de commande (CLI) EB applique uniquement cette option aux instances à la demande. N'utilisez pas cette option avec l'option `--enable-spot`, car l'interface de ligne de commande (CLI) EB l'ignore lorsque vous le faites. Pour spécifier des types d'instances pour une instance Spot, utilisez l'option `--intance-types` (avec un « s ») à la place. |
| `-k` *key\$1name* or `--keyname` *key\$1name* | Le nom de la paire de EC2 clés Amazon à utiliser avec le client Secure Shell (SSH) pour se connecter en toute sécurité aux EC2 instances Amazon qui exécutent votre application Elastic Beanstalk. Si vous incluez cette option avec la commande **eb create**, la valeur que vous fournissez remplace n'importe quel nom de clé que vous pourriez avoir spécifié avec **eb init**. Valeurs valides : nom de clé existant enregistré auprès d'Amazon EC2 |
| `-im` *number-of-instances* or `--min-instances` *number-of-instances* | Le nombre minimum d' EC2 instances Amazon dont vous avez besoin pour votre environnement. Type : Nombre (entier) Par défaut: `1` Valeurs valides : de `1` à `10000` |
| `-ix` *number-of-instances* or `--max-instances` *number-of-instances* | Le nombre maximum d' EC2 instances Amazon que vous autorisez votre environnement à avoir. Type : Nombre (entier) Par défaut: `4` Valeurs valides : de `1` à `10000` |
| `--modules` *component-a component-b* | Une liste des environnements de composants à créer. Cela doit être utilisé uniquement avec [Compose Environments](ebcli-compose.md) (Composer des environnements). |
| `-sb` ou `--on-demand-base-capacity` | Nombre minimal d'instances à la demande que votre groupe Auto Scaling alloue avant de considérer les instances Spot à mesure que votre environnement augmente. Cette option ne peut être spécifiée qu'avec l'option `--enable-spot`. Pour plus d'informations, consultez [Groupe Auto Scaling](using-features.managing.as.md). Type : Nombre (entier) Par défaut: `0` Valeurs valables : `0` à `--max-instances` (en son absence : `MaxSize` option dans l'espace de noms [`aws:autoscaling:asg`](command-options-general.md#command-options-general-autoscalingasg)) |
| `-sp` ou `--on-demand-above-base-capacity` | Pourcentage d'instances à la demande dans le cadre de la capacité supplémentaire allouée par votre groupe Auto Scaling supérieur au nombre d'instances qui est spécifié par l'option `--on-demand-base-capacity`. Cette option ne peut être spécifiée qu'avec l'option `--enable-spot`. Pour en savoir plus, consultez [Groupe Auto Scaling](using-features.managing.as.md). Type : Nombre (entier) Par défaut : `0` pour un environnement à instance unique ; `70` pour un environnement à charge équilibrée Valeurs valides : de `0` à `100` |
| `-p` *platform-version* or `--platform` *platform-version* | La [version de la plateforme](concepts.platforms.md) à utiliser. Vous pouvez spécifier un nom de plateforme, une plateforme et une version de plateforme, une branche de plateforme, un nom de pile de solutions ou un ARN de pile de solutions. Exemples : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/elasticbeanstalk/latest/dg/eb3-create.html) Utilisez [`eb platform list`](eb3-platform.md) pour obtenir la liste des configurations disponibles. Si vous spécifiez l'option `--platform`, elle remplace la valeur fournie au cours d'`eb init`. |
| `-pr` ou `--process` | Prétraitez et validez les fichiers de configuration et le manifeste d'environnement dans le groupe source. La validation des fichiers de configuration permet d'identifier les problèmes avant de déployer la version de l'application dans un environnement. |
| `-r` *region* or `--region` *region* | AWS Région dans laquelle vous souhaitez déployer l'application. Pour obtenir la liste des valeurs que vous pouvez spécifier pour cette option, consultez [Points de terminaison et quotas AWS Elastic Beanstalk](https://docs.aws.amazon.com/general/latest/gr/elasticbeanstalk.html) dans *Références générales AWS*. |
| `--sample` | Déployez l'exemple d'application dans le nouvel environnement au lieu du code dans votre référentiel. |
| `--scale` *number-of-instances* | Démarrez avec le nombre d'instances spécifié |
| --service-role servicerole | Attribuez un rôle de service autre que celui par défaut à l'environnement. Ne saisissez pas d'ARN. Saisissez uniquement le nom du rôle. Elastic Beanstalk fait précéder le nom de rôle des valeurs correctes pour créer l'ARN en interne. |
| `-ls` *load-balancer* or `--shared-lb` *load-balancer* | Configurez l'environnement pour utiliser un équilibreur de charge partagé. Indiquez le nom ou l'ARN d'un équilibreur de charge partageable dans votre compte, un équilibreur de charge Application Load Balancer que vous avez créé explicitement, et non pas un autre environnement Elastic Beanstalk. Pour plus d'informations, consultez [Application Load Balancer partagé](environments-cfg-alb-shared.md). Exemples de paramètres : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/elasticbeanstalk/latest/dg/eb3-create.html) Vous pouvez spécifier cette option uniquement avec `--elb-type application`. Si vous spécifiez cette option et que vous ne spécifiez pas `--shared-lb`, Elastic Beanstalk crée un équilibreur de charge dédié pour l'environnement. |
| `-lp` *port* or `--shared-lb-port` *port* | Port d'écoute par défaut de l'équilibreur de charge partagé pour cet environnement. Elastic Beanstalk ajoute une règle d'écoute qui achemine tout le trafic de ce processus d'écoute vers le processus d'environnement par défaut. Pour plus d'informations, consultez [Application Load Balancer partagé](environments-cfg-alb-shared.md). Type : Nombre (entier) Par défaut: `80` Valeurs valides : entier représentant un port d'écoute de l'équilibreur de charge partagé. |
| `--single` | Créez l'environnement avec une seule EC2 instance Amazon et sans équilibreur de charge. Un environnement d'instance unique n'est pas prêt pour la production. Si l'instance devient instable lors du déploiement, ou si Elastic Beanstalk résilie l'instance lors d'une mise à jour de configuration, votre application peut être indisponible pendant un certain temps. Utilisez des environnements d'instance unique pour le développement ou les tests, ou comme environnement intermédiaire. Utilisez des environnements à charge équilibrée pour la production. |
| `-sm` ou `--spot-max-price` | Prix maximum par heure d'unité, en dollars américains, que vous êtes prêt à payer pour une instance Spot. Cette option ne peut être spécifiée qu'avec l'option `--enable-spot`. Pour en savoir plus, consultez [Groupe Auto Scaling](using-features.managing.as.md). Type : nombre (flottant) Par défaut : prix à la demande, par type d'instance. La valeur de l'option dans ce cas est `null`. Valeurs valides : de `0.001` à `20.0` Pour obtenir des recommandations concernant les options de prix maximum pour les instances Spot, consultez [l'historique des tarifs des instances Spot](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-spot-instances-history.html) dans le *guide de EC2 l'utilisateur Amazon*. |
| `--tags key1=value1[,key2=value2 ...]` | Ajouter des balises aux ressources de votre environnement. Les balises sont spécifiées sous la forme d'une liste séparée par des virgules et composée de paires `key=value`. Pour de plus amples informations, veuillez consulter [Environnements de balisage](using-features.tagging.md). |
| `-t worker` ou `--tier worker` | Créez un environnement de travail. Ignorez cette option pour créer un environnement de serveur web. |
| `--timeout` *minutes* | Définissez le nombre de minutes avant que la commande expire. |
| `--version` *version\$1label* | Spécifie la version de l'application que vous voulez voir déployée dans l'environnement à la place du code source d'application dans le répertoire du projet local. Type : chaîne Valeurs valides : une étiquette de version de l'application existante |
| `--vpc` | Configurez un VPC pour votre environnement. Lorsque vous incluez cette option, l'interface de ligne de commande (CLI) EB vous invite à entrer tous les paramètres obligatoires avant de lancer l'environnement. |
| `--vpc.dbsubnets subnet1,subnet2` | Spécifie les sous-réseaux pour les instances de base de données dans un VPC. Obligatoire lorsque `--vpc.id` est spécifié. |
| `--vpc.ec2subnets subnet1,subnet2` | Spécifie les sous-réseaux pour les EC2 instances Amazon dans un VPC. Obligatoire lorsque `--vpc.id` est spécifié. |
| `--vpc.elbpublic` | Lance votre équilibreur de charge Elastic Load Balancing dans un sous-réseau public de votre VPC. Vous ne pouvez pas spécifier cette option avec les options `--tier worker` ou `--single`. |
| `--vpc.elbsubnets subnet1,subnet2` | Spécifie des sous-réseaux pour l'équilibreur de charge Elastic Load Balancing dans un VPC. Vous ne pouvez pas spécifier cette option avec les options `--tier worker` ou `--single`. |
| `--vpc.id ID` | Lance votre environnement dans le VPC spécifié. |
| `--vpc.publicip` | Lance vos EC2 instances Amazon dans un sous-réseau public de votre VPC. Vous ne pouvez pas spécifier cette option avec l'option `--tier worker`. |
| `--vpc.securitygroups securitygroup1,securitygroup2` | Spécifie le groupe de sécurité IDs. Obligatoire lorsque `--vpc.id` est spécifié. |
| [Options courantes](eb3-cmd-options.md) | |
## Output
En cas de succès, la commande vous soumet des questions, puis renvoie le statut de l'opération de création. Si des problèmes se sont produits lors du lancement, vous pouvez utiliser l'opération [**eb events**](eb3-events.md) pour obtenir plus d'informations.
Si vous avez activé le CodeBuild support dans votre application, **eb create** affiche les informations au CodeBuild fur et à mesure de la création de votre code. Pour plus d'informations sur le CodeBuild support d'Elastic Beanstalk, consultez. [Utilisation de l'interface de ligne de commande EB avec AWS CodeBuild](eb-cli-codebuild.md)
## Exemples
L'exemple suivant crée un environnement en mode interactif.
```
$ eb create
Enter Environment Name
(default is tmp-dev): ENTER
Enter DNS CNAME prefix
(default is tmp-dev): ENTER
Select a load balancer type
1) classic
2) application
3) network
(default is 2): ENTER
Environment details for: tmp-dev
Application name: tmp
Region: us-east-2
Deployed Version: app-141029_145448
Environment ID: e-um3yfrzq22
Platform: 64bit Amazon Linux 2014.09 v1.0.9 running PHP 5.5
Tier: WebServer-Standard-1.0
CNAME: tmp-dev.elasticbeanstalk.com
Updated: 2014-10-29 21:54:51.063000+00:00
Printing Status:
...
```
L'exemple suivant crée aussi un environnement en mode interactif. Dans cet exemple, votre projet de répertoire ne dispose pas d'un code d'application. La commande déploie un exemple d'application et le télécharge dans votre répertoire de projet local.
```
$ eb create
Enter Environment Name
(default is tmp-dev): ENTER
Enter DNS CNAME prefix
(default is tmp-dev): ENTER
Select a load balancer type
1) classic
2) application
3) network
(default is 2): ENTER
NOTE: The current directory does not contain any source code. Elastic Beanstalk is launching the sample application instead.
Do you want to download the sample application into the current directory?
(Y/n): ENTER
INFO: Downloading sample application to the current directory.
INFO: Download complete.
Environment details for: tmp-dev
Application name: tmp
Region: us-east-2
Deployed Version: Sample Application
Environment ID: e-um3yfrzq22
Platform: 64bit Amazon Linux 2014.09 v1.0.9 running PHP 5.5
Tier: WebServer-Standard-1.0
CNAME: tmp-dev.elasticbeanstalk.com
Updated: 2017-11-08 21:54:51.063000+00:00
Printing Status:
...
```
La commande suivante crée un environnement sans afficher d'invites.
```
$ eb create dev-env
Creating application version archive "app-160312_014028".
Uploading test/app-160312_014028.zip to S3. This may take a while.
Upload Complete.
Application test has been created.
Environment details for: dev-env
Application name: test
Region: us-east-2
Deployed Version: app-160312_014028
Environment ID: e-6fgpkjxyyi
Platform: 64bit Amazon Linux 2015.09 v2.0.8 running PHP 5.6
Tier: WebServer-Standard
CNAME: UNKNOWN
Updated: 2016-03-12 01:40:33.614000+00:00
Printing Status:
...
```
La commande suivante crée un environnement dans un VPC personnalisé.
```
$ eb create dev-vpc --vpc.id vpc-0ce8dd99 --vpc.elbsubnets subnet-b356d7c6,subnet-02f74b0c --vpc.ec2subnets subnet-0bb7f0cd,subnet-3b6697c1 --vpc.securitygroup sg-70cff265
Creating application version archive "app-160312_014309".
Uploading test/app-160312_014309.zip to S3. This may take a while.
Upload Complete.
Environment details for: dev-vpc
Application name: test
Region: us-east-2
Deployed Version: app-160312_014309
Environment ID: e-pqkcip3mns
Platform: 64bit Amazon Linux 2015.09 v2.0.8 running Java 8
Tier: WebServer-Standard
CNAME: UNKNOWN
Updated: 2016-03-12 01:43:14.057000+00:00
Printing Status:
...
```
# **eb deploy**
## Description
Déploie le groupe source de l'application depuis le répertoire du projet initialisé vers l'application en cours d'exécution.
Si git est installé, l'interface de ligne de commande (CLI) EB utilise la commande `git archive` pour créer un fichier `.zip` à partir du contenu de la commande `git commit` la plus récente.
Cependant, quand `.ebignore` est présent dans le répertoire de votre projet, l'interface de ligne de commande (CLI) EB n'utilise pas de commandes et de sémantiques Git pour créer votre bundle de fichiers source. Autrement dit, l'interface de ligne de commande (CLI) EB ignore les fichiers spécifiés dans `.ebignore` et inclut tous les autres fichiers. Plus particulièrement, elle comprend des fichiers source non validés.
**Note**
Vous pouvez configurer l'interface de ligne de commande (CLI) EB pour déployer un artefact de votre processus de construction au lieu de créer un fichier ZIP de votre dossier de projet. Consultez [Déploiement d'un artefact à la place du dossier de projet](eb-cli3-configuration.md#eb-cli3-artifact) pour plus de détails.
## Syntaxe
**eb deploy**
**eb deploy *environment-name***
## Options
****
| Nom | Description |
| --- | --- |
| `-l` *version\$1label* or `--label` *version\$1label* | Spécifiez une étiquette à utiliser pour la version créée par l'interface de ligne de commande (CLI) EB. Si l'étiquette a déjà été utilisée, l'interface de ligne de commande (CLI) EB redéploie la version précédente avec cette étiquette. Type : chaîne |
| --env-group-suffix groupname | Nom du groupe à ajouter au nom de l'environnement. A utiliser uniquement avec [Compose Environments](ebcli-compose.md). |
| `-m` "*version\$1description*" or `--message` "*version\$1description*" | La description de la version de l'application, entourée de guillemets doubles. Type : Chaîne |
| `--modules` *component-a component-b* | Liste des composants à mettre à jour. A utiliser uniquement avec [Compose Environments](ebcli-compose.md). |
| `-p` ou `--process` | Prétraitez et validez les fichiers de configuration et le manifeste d'environnement dans le groupe source. La validation des fichiers de configuration permet d'identifier les problèmes avant de déployer la version de l'application dans un environnement. |
| `--source codecommit/repository-name/branch-name` | CodeCommit référentiel et branche. |
| `--staged` | Déployez des fichiers mis en lots dans l'index git au lieu de la validation HEAD. |
| `--timeout` *minutes* | Le nombre de minutes avant que la commande expire. |
| `--version` *version\$1label* | Une version de l'application existante à déployer. Type : chaîne |
| [Options courantes](eb3-cmd-options.md) | |
## Output
En cas de réussite, la commande renvoie l'état de l'opération `deploy`.
Si vous avez activé le CodeBuild support dans votre application, **eb deploy** affiche les informations à partir CodeBuild de la création de votre code. Pour plus d'informations sur le CodeBuild support d'Elastic Beanstalk, consultez. [Utilisation de l'interface de ligne de commande EB avec AWS CodeBuild](eb-cli-codebuild.md)
## Exemple
L'exemple suivant déploie l'application en cours.
```
$ eb deploy
2018-07-11 21:05:22 INFO: Environment update is starting.
2018-07-11 21:05:27 INFO: Deploying new version to instance(s).
2018-07-11 21:05:53 INFO: New application version was deployed to running EC2 instances.
2018-07-11 21:05:53 INFO: Environment update completed successfully.
```
# **eb events**
## Description
Renvoie les événements les plus récents pour l'environnement.
Si le répertoire racine contient un fichier `platform.yaml` spécifiant une plateforme personnalisée, cette commande renvoie également les événements les plus récents pour l'environnement de génération.
## Syntaxe
**eb events**
**eb events *environment-name***
## Options
****
| Nom | Description |
| --- | --- |
| `-f` ou `--follow` | Événements de flux. Pour annuler, appuyez sur CTRL\$1C. |
## Output
En cas de succès, la commande renvoie des événements récents.
## Exemple
L'exemple suivant renvoie les événements les plus récents.
```
$ eb events
2014-10-29 21:55:39 INFO createEnvironment is starting.
2014-10-29 21:55:40 INFO Using elasticbeanstalk-us-west-2-111122223333 as Amazon S3 storage bucket for environment data.
2014-10-29 21:55:57 INFO Created load balancer named: awseb-e-r-AWSEBLoa-NSKUOK5X6Z9J
2014-10-29 21:56:16 INFO Created security group named: awseb-e-rxgrhjr9bx-stack-AWSEBSecurityGroup-1UUHU5LZ20ZY7
2014-10-29 21:57:18 INFO Waiting for EC2 instances to launch. This may take a few minutes.
2014-10-29 21:57:18 INFO Created Auto Scaling group named: awseb-e-rxgrhjr9bx-stack-AWSEBAutoScalingGroup-1TE320ZCJ9RPD
2014-10-29 21:57:22 INFO Created Auto Scaling group policy named: arn:aws:autoscaling:us-east-2:11122223333:scalingPolicy:2cced9e6-859b-421a-be63-8ab34771155a:autoScalingGroupName/awseb-e-rxgrhjr9bx-stack-AWSEBAutoScalingGroup-1TE320ZCJ9RPD:policyName/awseb-e-rxgrhjr9bx-stack-AWSEBAutoScalingScaleUpPolicy-1I2ZSNVU4APRY
2014-10-29 21:57:22 INFO Created Auto Scaling group policy named: arn:aws:autoscaling:us-east-2:11122223333:scalingPolicy:1f08b863-bf65-415a-b584-b7fa3a69a0d5:autoScalingGroupName/awseb-e-rxgrhjr9bx-stack-AWSEBAutoScalingGroup-1TE320ZCJ9RPD:policyName/awseb-e-rxgrhjr9bx-stack-AWSEBAutoScalingScaleDownPolicy-1E3G7PZKZPSOG
2014-10-29 21:57:25 INFO Created CloudWatch alarm named: awseb-e-rxgrhjr9bx-stack-AWSEBCloudwatchAlarmLow-VF5EJ549FZBL
2014-10-29 21:57:25 INFO Created CloudWatch alarm named: awseb-e-rxgrhjr9bx-stack-AWSEBCloudwatchAlarmHigh-LA9YEW3O6WJO
2014-10-29 21:58:50 INFO Added EC2 instance 'i-c7ee492d' to Auto ScalingGroup 'awseb-e-rxgrhjr9bx-stack-AWSEBAutoScalingGroup-1TE320ZCJ9RPD'.
2014-10-29 21:58:53 INFO Successfully launched environment: tmp-dev
2014-10-29 21:59:14 INFO Environment health has been set to GREEN
2014-10-29 21:59:43 INFO Adding instance 'i-c7ee492d' to your environment.
```
# **eb health**
## Description
Renvoie l'intégrité la plus récente pour l'environnement.
Si le répertoire racine contient un fichier `platform.yaml` spécifiant une plateforme personnalisée, cette commande renvoie également l'état le plus récent pour l'environnement de génération.
## Syntaxe
**eb health**
**eb health *environment-name***
## Options
****
| Nom | Description |
| --- | --- |
| `-r` ou `--refresh` | Affichez des informations d'état de santé interactivement et mettez à jour toutes les 10 secondes à mesure que de nouvelles informations sont rapportées. |
| --mono | N'affichez pas la couleur dans le résultat. |
## Output
En cas de réussite, la commande renvoie l'intégrité récente.
## Exemple
L'exemple suivant renvoie les informations d'intégrité les plus récentes pour un environnement Linux.
```
~/project $ eb health
elasticBeanstalkExa-env Ok 2015-07-08 23:13:20
WebServer Ruby 2.1 (Puma)
total ok warning degraded severe info pending unknown
5 5 0 0 0 0 0 0
instance-id status cause health
Overall Ok
i-d581497d Ok
i-d481497c Ok
i-136e00c0 Ok
i-126e00c1 Ok
i-8b2cf575 Ok
instance-id r/sec %2xx %3xx %4xx %5xx p99 p90 p75 p50 p10 requests
Overall 671.8 100.0 0.0 0.0 0.0 0.003 0.002 0.001 0.001 0.000
i-d581497d 143.0 1430 0 0 0 0.003 0.002 0.001 0.001 0.000
i-d481497c 128.8 1288 0 0 0 0.003 0.002 0.001 0.001 0.000
i-136e00c0 125.4 1254 0 0 0 0.004 0.002 0.001 0.001 0.000
i-126e00c1 133.4 1334 0 0 0 0.003 0.002 0.001 0.001 0.000
i-8b2cf575 141.2 1412 0 0 0 0.003 0.002 0.001 0.001 0.000
instance-id type az running load 1 load 5 user% nice% system% idle% iowait% cpu
i-d581497d t2.micro 1a 12 mins 0.0 0.04 6.2 0.0 1.0 92.5 0.1
i-d481497c t2.micro 1a 12 mins 0.01 0.09 5.9 0.0 1.6 92.4 0.1
i-136e00c0 t2.micro 1b 12 mins 0.15 0.07 5.5 0.0 0.9 93.2 0.0
i-126e00c1 t2.micro 1b 12 mins 0.17 0.14 5.7 0.0 1.4 92.7 0.1
i-8b2cf575 t2.micro 1c 1 hour 0.19 0.08 6.5 0.0 1.2 92.1 0.1
instance-id status id version ago deployments
i-d581497d Deployed 1 Sample Application 12 mins
i-d481497c Deployed 1 Sample Application 12 mins
i-136e00c0 Deployed 1 Sample Application 12 mins
i-126e00c1 Deployed 1 Sample Application 12 mins
i-8b2cf575 Deployed 1 Sample Application 1 hour
```
# **eb init**
## Description
Définit les valeurs par défaut pour les applications Elastic Beanstalk créées avec l'interface de ligne de commande (CLI) EB en vous soumettant une série de questions.
**Note**
Les valeurs que vous définissez s'**eb init**appliquent au répertoire et au référentiel actuels de l'ordinateur en cours.
La commande crée une application Elastic Beanstalk dans votre compte. Pour créer un environnement Elastic Beanstalk, exécutez **[eb create](eb3-create.md)** après l'exécution de **eb init**.
## Syntaxe
**eb init**
**eb init** *application-name*
## Options
Si vous exécutez **eb init** sans spécifier l'option `--platform`, l'interface de ligne de commande (CLI) EB vous invite à entrer une valeur pour chaque paramètre.
**Note**
Pour utiliser **eb init** afin de créer une nouvelle paire de clés, l'outil `ssh-keygen` doit être installé sur votre ordinateur local et disponible à partir de la ligne de commande.
****
| Nom | Description | |
| --- | --- | --- |
| `-i` `--interactive` | Force l'interface de ligne de commande (CLI) EB à vous inviter à fournir une valeur pour chaque option de commande **eb init**. La commande `init` vous invite à fournir des valeurs pour les options de commande **eb init** qui n'ont pas une valeur (par défaut). Après la première fois que vous exécutez la commande **eb init** dans un répertoire, l'interface de ligne de commande (CLI) EB ne vous soumettra peut-être aucune options de commande. Par conséquent, utilisez l'option `--interactive` lorsque vous voulez modifier un paramètre que vous avez préalablement défini. | |
| `-k` *keyname* `--keyname` *keyname* | Le nom de la paire de EC2 clés Amazon à utiliser avec le client Secure Shell (SSH) pour se connecter en toute sécurité aux EC2 instances Amazon exécutant votre application Elastic Beanstalk. | |
| `--modules folder-1 folder-2` | Liste des répertoires enfants à initialiser. A utiliser uniquement avec [Compose Environments](ebcli-compose.md). | |
| `-p` *platform-version* `--platform` *platform-version* | La [version de la plateforme](concepts.platforms.md) à utiliser. Vous pouvez spécifier un nom de plateforme, une plateforme et une version de plateforme, une branche de plateforme, un nom de pile de solutions ou un ARN de pile de solutions. Exemples : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/elasticbeanstalk/latest/dg/eb3-init.html) Utilisez [`eb platform list`](eb3-platform.md) pour obtenir la liste des configurations disponibles. Spécifiez l'option `--platform` pour éviter la configuration interactive. Si vous spécifiez cette option, l'interface de ligne de commande (CLI) EB ne vous invite pas à saisir les valeurs d'autres options. Au lieu de cela, il est seul responsable des valeurs par défaut pour chaque option. Vous pouvez spécifier des options pour tout ce pour quoi vous ne souhaitez pas utiliser les valeurs par défaut. | |
| `--source codecommit/repository-name/branch-name` | CodeCommit référentiel et branche. | |
| `--tags key1=value1[,key2=value2 ...]` | Balisez votre application. Les balises sont spécifiées sous la forme d'une liste séparée par des virgules et composée de paires `key=value`. Pour en savoir plus, consultez [L'étiquette des applications](applications-tagging.md). |
| [Options courantes](eb3-cmd-options.md) | | |
## CodeBuild soutien
Si vous exécutez **eb init** dans un dossier contenant un fichier [buildspec.yml](https://docs.aws.amazon.com/codebuild/latest/userguide/build-spec-ref.html), Elastic Beanstalk analyse le fichier pour une entrée **eb\$1codebuild\$1settings** avec des options spécifiques à Elastic Beanstalk. Pour plus d'informations sur le CodeBuild support d'Elastic Beanstalk, consultez. [Utilisation de l'interface de ligne de commande EB avec AWS CodeBuild](eb-cli-codebuild.md)
## Output
En cas de succès, la commande vous guide à travers la mise en place d'une nouvelle application Elastic Beanstalk grâce à une série d'invites.
## Exemple
L'exemple de demande suivant initialise l'interface de ligne de commande (CLI) EB et vous invite à saisir des informations relatives à votre application. Remplacez *placeholder* le texte par vos propres valeurs.
```
$ eb init -i
Select a default region
1) us-east-1 : US East (N. Virginia)
2) us-west-1 : US West (N. California)
3) us-west-2 : US West (Oregon)
4) eu-west-1 : Europe (Ireland)
5) eu-central-1 : Europe (Frankfurt)
6) ap-south-1 : Asia Pacific (Mumbai)
7) ap-southeast-1 : Asia Pacific (Singapore)
...
(default is 3): 3
Select an application to use
1) HelloWorldApp
2) NewApp
3) [ Create new Application ]
(default is 3): 3
Enter Application Name
(default is "tmp"):
Application tmp has been created.
It appears you are using PHP. Is this correct?
(y/n): y
Select a platform branch.
1) PHP 7.2 running on 64bit Amazon Linux
2) PHP 7.1 running on 64bit Amazon Linux (Deprecated)
3) PHP 7.0 running on 64bit Amazon Linux (Deprecated)
4) PHP 5.6 running on 64bit Amazon Linux (Deprecated)
5) PHP 5.5 running on 64bit Amazon Linux (Deprecated)
6) PHP 5.4 running on 64bit Amazon Linux (Deprecated)
(default is 1): 1
Do you want to set up SSH for your instances?
(y/n): y
Select a keypair.
1) aws-eb
2) [ Create new KeyPair ]
(default is 2): 1
```
# **eb labs**
## Description
Sous-commandes de **eb labs** support work-in-progress ou de fonctionnalité expérimentale. Ces commandes peuvent être supprimées ou retravaillées dans des versions futures de l'interface de ligne de commande (CLI) EB et ne sont pas garanties pour être compatibles.
Pour une liste des descriptions et des sous-commandes disponibles, exécutez **eb labs --help**.
# **eb list**
## Description
Répertorie tous les environnements dans l'application actuelle ou tous les environnements dans toutes les applications, comme indiqué par l'option `--all`.
Si le répertoire racine contient un fichier `platform.yaml` spécifiant une plateforme personnalisée, cette commande répertorie également les environnements de génération.
## Syntaxe
**eb list**
## Options
****
| Nom | Description |
| --- | --- |
| `-a` ou `--all` | Répertorie tous les environnements de toutes les applications. |
| `-v` ou `--verbose` | Fournit des informations plus détaillées sur tous les environnements, y compris des instances. |
| [Options courantes](eb3-cmd-options.md) | |
## Output
En cas de réussite, la commande renvoie une liste de noms d'environnements dans laquelle votre environnement actuel est marqué d'un astérisque (\$1).
## Exemple 1
L'exemple suivant répertorie vos environnements et indique que tmp-dev est votre environnement par défaut.
```
$ eb list
* tmp-dev
```
## Exemple 2
L'exemple suivant répertorie vos environnements avec plus de détails.
```
$ eb list --verbose
Region: us-west-2
Application: tmp
Environments: 1
* tmp-dev : ['i-c7ee492d']
```
# **eb local**
## Description
Utilisez **eb local run** pour exécuter des conteneurs de votre application localement dans Docker. Vérifiez l'état du conteneur de l'application avec **eb local status**. Ouvrez l'application dans un navigateur web avec **eb local open**. Récupérez l'emplacement des journaux de l'application avec **eb local logs**.
**eb local setenv** et **eb local printenv** vous permettent de définir et d'afficher des variables d'environnement qui sont fournies par des conteneurs Docker que vous exécutez localement avec **eb local run**.
Vous devez exécuter toutes les commandes **eb local** dans le répertoire de projet d'une application Docker ayant fait l'objet d'une initialisation en tant que référentiel de l'interface de ligne de commande (CLI) EB en utilisant **eb init**.
**Note**
Utilisez **eb local** sur un ordinateur local exécutant les systèmes d'exploitation Linux ou macOS. La commande ne prend pas en charge Windows.
Avant d'utiliser la commande sur macOS, installez Docker pour Mac et assurez-vous que boot2docker n'est pas installé (ou n'est pas dans le chemin d'exécution). La commande **eb local** essaie d'utiliser boot2docker s'il est présent, mais ne fonctionne pas bien avec elle sur macOS.
## Syntaxe
**eb local run**
**eb local status**
**eb local open**
**eb local logs**
**eb local setenv**
**eb local printenv**
## Options
**eb local run**
****
| Nom | Description |
| --- | --- |
| `--envvars key1=value1,key2=value2` | Définit des variables d'environnement que l'interface de ligne de commande (CLI) EB va passer aux conteneurs Docker locaux. Dans des environnements multicontainer, toutes les variables sont passées à tous les conteneurs. |
| `--port hostport` | Mappe un port sur l'hôte au port exposé sur le conteneur. Si vous ne spécifiez pas cette option, l'interface de ligne de commande (CLI) EB utilise le même port sur l'hôte et sur le conteneur. Cette option fonctionne uniquement avec les applications de plateforme Docker. Elle ne s'applique pas à la plateforme multi-conteneurs Docker. |
| [Options courantes](eb3-cmd-options.md) | |
**eb local status**
**eb local open**
**eb local logs**
**eb local setenv**
**eb local printenv**
****
| Nom | Description |
| --- | --- |
| [Options courantes](eb3-cmd-options.md) | |
## Output
**eb local run**
Messages d'état de Docker. Reste actif aussi longtemps que l'application est en cours d'exécution. Appuyez sur **Ctrl\$1C** pour arrêter l'application.
**eb local status**
L'état de chaque conteneur utilisé par l'application, en cours d'exécution ou non.
**eb local open**
Ouvre l'application dans un navigateur web puis se ferme.
**eb local logs**
L'emplacement des journaux générés dans votre répertoire de projet par des applications qui s'exécutent localement sous **eb local run**.
**eb local setenv**
Aucune
**eb local printenv**
Le nom et les valeurs de variables d'environnement définies avec **eb local setenv**.
## Exemples
**eb local run**
```
~/project$ eb local run
Creating elasticbeanstalk_phpapp_1...
Creating elasticbeanstalk_nginxproxy_1...
Attaching to elasticbeanstalk_phpapp_1, elasticbeanstalk_nginxproxy_1
phpapp_1 | [23-Apr-2015 23:24:25] NOTICE: fpm is running, pid 1
phpapp_1 | [23-Apr-2015 23:24:25] NOTICE: ready to handle connections
```
**eb local status**
Affichez le statut de vos conteneurs locaux :
```
~/project$ eb local status
Platform: 64bit Amazon Linux 2014.09 v1.2.1 running Multi-container Docker 1.3.3 (Generic)
Container name: elasticbeanstalk_nginxproxy_1
Container ip: 127.0.0.1
Container running: True
Exposed host port(s): 80
Full local URL(s): 127.0.0.1:80
Container name: elasticbeanstalk_phpapp_1
Container ip: 127.0.0.1
Container running: True
Exposed host port(s): None
Full local URL(s): None
```
**eb local logs**
Affichez le chemin d'accès au journal pour le projet actuel :
```
~/project$ eb local logs
Elastic Beanstalk will write logs locally to /home/user/project/.elasticbeanstalk/logs/local.
Logs were most recently created 3 minutes ago and written to /home/user/project/.elasticbeanstalk/logs/local/150420_234011665784.
```
**eb local setenv**
Définissez des variables d'environnement à utiliser avec **eb local run**.
```
~/project$ eb local setenv PARAM1=value
```
Imprimez des variables d'environnement définies avec **eb local setenv**.
```
~/project$ eb local printenv
Environment Variables:
PARAM1=value
```
# **eb logs**
## Description
La **eb logs** commande a trois objectifs distincts : activer ou désactiver le streaming des CloudWatch journaux vers Logs, récupérer les journaux d'instance ou les journaux CloudWatch des journaux, et demander une analyse de votre environnement basée sur l'IA. Avec l'option `--cloudwatch-logs` (`-cw`), la commande active ou désactive le streaming de journaux. Avec l'option `--analyze` (`-ai`), la commande demande une analyse basée sur l'IA des journaux, des événements et de l'état de l'instance de votre environnement. Sans aucune de ces options, il récupère les journaux.
En cas de récupération des journaux, spécifiez l'option `--all` ou `--zip`, `--stream` pour récupérer les journaux complets. Si vous ne spécifiez aucune de ces options, Elastic Beanstalk récupère les journaux de queue.
La commande traite les journaux associés à l'environnement par défaut ou l'environnement spécifié. Les journaux concernés varient selon le type de conteneur. Si le répertoire racine contient un fichier `platform.yaml` spécifiant une plateforme personnalisée, cette commande traite également les journaux associés à l'environnement de génération.
Pour de plus amples informations, veuillez consulter [Utilisation d'Elastic CloudWatch Beanstalk avec Amazon Logs](AWSHowTo.cloudwatchlogs.md). Pour plus d'informations sur l'analyse basée sur l'IA, consultez. [Analyse de l'environnement basée sur l'IA](health-ai-analysis.md)
## Syntaxe
Pour activer ou désactiver le streaming des CloudWatch journaux vers Logs, procédez comme suit :
```
eb logs --cloudwatch-logs [enable | disable] [--cloudwatch-log-source instance | environment-health | all] [environment-name]
```
Pour récupérer des journaux d'instance :
```
eb logs [-all | --zip | --stream] [--cloudwatch-log-source instance] [--instance instance-id] [--log-group log-group] [environment-name]
```
Pour extraire les journaux d'intégrité de l'environnement :
```
eb logs [-all | --zip | --stream] --cloudwatch-log-source environment-health [environment-name]
```
Pour demander une analyse basée sur l'IA :
```
eb logs --analyze [environment-name]
```
## Options
****
| Nom | Description |
| --- | --- |
| `-cw [enable \| disable]` or `--cloudwatch-logs [enable \| disable]` | Active ou désactive le streaming des journaux vers CloudWatch Logs. Si aucun argument n'est fourni, le streaming de journaux est activé. Si l'option `--cloudwatch-log-source` (`-cls`) n'est pas ajoutée, le streaming des journaux d'instance est activé ou désactivé. |
| `-cls instance \| environment-health \| all` or `--cloudwatch-log-source instance \| environment-health \| all` | Spécifie la source des journaux lorsque vous travaillez avec CloudWatch des journaux. Avec la forme d'activation ou de désactivation de la commande, il s'agit des journaux pour lesquels vous pouvez activer ou désactiver le streaming CloudWatch des journaux. Avec le formulaire de récupération de la commande, il s'agit des journaux à récupérer à partir de CloudWatch Logs. Valeurs valides : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/elasticbeanstalk/latest/dg/eb3-logs.html) Significations des valeurs : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/elasticbeanstalk/latest/dg/eb3-logs.html) |
| `-a` ou `--all` | Récupère les journaux complets et les enregistre dans le répertoire `.elasticbeanstalk/logs`. |
| `-z` ou `--zip` | Récupère les journaux complets, les compresse dans un fichier `.zip`, puis enregistre le fichier dans le répertoire `.elasticbeanstalk/logs`. |
| `--stream` | Diffuse (sorties en continu) les journaux complets. Avec cette option, la commande poursuit son exécution jusqu'à ce que vous l'interrompiez (appuyez sur **Ctrl\$1C**). |
| `-i instance-id` ou `--instance instance-id` | Extrait les journaux de l'instance spécifiée uniquement. |
| `-g log-group` or `--log-group log-group` | Spécifie le groupe de CloudWatch journaux à partir duquel les journaux doivent être récupérés. L'option n'est valide que lorsque le streaming du journal d'instance vers CloudWatch Logs est activé. Si le streaming des journaux d'instance est activé et que vous ne spécifiez pas l'option `--log-group`, le groupe de journaux par défaut est l'un des suivants : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/elasticbeanstalk/latest/dg/eb3-logs.html) Pour plus d'informations sur le groupe de journaux correspondant à chaque fichier journal, consultez [Comment Elastic Beanstalk configure les journaux CloudWatch](AWSHowTo.cloudwatchlogs.md#AWSHowTo.cloudwatchlogs.loggroups). |
| `-ai` or `--analyze` | Demande une analyse basée sur l'IA des journaux, des événements et de l'état de l'instance de votre environnement. L'analyse utilise Amazon Bedrock pour identifier les causes profondes et recommander des solutions aux problèmes de santé environnementale. La commande envoie la demande, attend que l'analyse soit terminée, puis affiche les résultats. Cette option n'est pas compatible avec `--instance``--all`,`--zip`,`--log-group`, ou`--cloudwatch-logs`. Pour les prérequis et les autorisations requises, voir[Analyse de l'environnement basée sur l'IA](health-ai-analysis.md). |
| [Options courantes](eb3-cmd-options.md) | |
## Output
Par défaut, affiche les journaux directement sur le terminal. Utilise un programme de pagination pour afficher la sortie. Appuyez sur **Q** ou **q** pour quitter.
Avec `--stream`, affiche les journaux existants sur le terminal et poursuit son exécution. Appuyez sur **Ctrl\$1C** pour quitter.
Avec `--all` et `--zip`, enregistre les journaux dans des fichiers locaux et affiche l'emplacement des fichiers.
Avec`--analyze`, affiche l'analyse générée par l'IA directement dans le terminal une fois l'analyse terminée.
## Exemples
L'exemple suivant active le streaming des journaux d'instance vers CloudWatch Logs.
```
$ eb logs -cw enable
Enabling instance log streaming to CloudWatch for your environment
After the environment is updated you can view your logs by following the link:
https://console.aws.amazon.com/cloudwatch/home?region=us-east-1#logs:prefix=/aws/elasticbeanstalk/environment-name/
Printing Status:
2018-07-11 21:05:20 INFO: Environment update is starting.
2018-07-11 21:05:27 INFO: Updating environment environment-name's configuration settings.
2018-07-11 21:06:45 INFO: Successfully deployed new configuration to environment.
```
L'exemple suivant extrait les journaux d'instance dans un fichier `.zip`.
```
$ eb logs --zip
Retrieving logs...
Logs were saved to /home/workspace/environment/.elasticbeanstalk/logs/150622_173444.zip
```
L'exemple suivant demande une analyse de l'environnement basée sur l'IA.
```
$ eb logs --analyze
Analyzing environment...
No critical issues detected. Environment appears healthy.
---
Note: This analysis was generated by AI.
```
# **eb migrate**
## Description
Fait migrer les sites et applications Internet Information Services (IIS) d'un serveur Windows vers Elastic Beanstalk. La commande empaquète vos applications, préserve leurs configurations et les déploie dans un nouvel environnement Elastic Beanstalk.
Pour plus d'informations sur la migration de vos sites et applications IIS, consultez[Migration des applications IIS vers Elastic Beanstalk](dotnet-migrating-applications.md).
**Note**
Avant d'utiliser cette commande, assurez-vous que votre système répond aux exigences suivantes :
Internet Information Services (IIS) version 7.0 ou ultérieure
Web Deploy 3.6 ou version ultérieure installé
Privilèges administratifs sur le serveur Windows
AWS informations d'identification configurées avec les autorisations appropriées
Votre serveur source dispose d'un accès Internet sortant aux AWS services.
Les étapes suivantes résument le processus de migration :
1. Découvrez les sites IIS et leurs configurations.
1. Package du contenu et de la configuration de l'application.
1. Créez l'environnement et l'application Elastic Beanstalk.
1. Déployez l'application avec des paramètres préservés.
La commande crée des artefacts de migration dans un répertoire structuré, comme indiqué dans la liste suivante :
```
C:\migration_workspace\
└── .\migrations\latest\
├── upload_target.zip
└── upload_target\
├── [SiteName].zip # One ZIP per default application of IIS site
├── [SiteName-ApplicationName].zip # One ZIP per additional application
├── aws-windows-deployment-manifest.json
└── ebmigrateScripts\
├── site_installer.ps1 # Site installation scripts
├── permission_handler.ps1 # Permission management
└── other helper scripts
```
**eb migrate cleanup**À utiliser pour gérer ces artefacts.
## Syntaxe
**eb migrate *[options]***
**eb migrate explore *[options]***
**eb migrate cleanup *[options]***
Lorsqu'il est exécuté sans arguments, **eb migrate** fonctionne en mode non interactif. Pour l'exécuter en mode interactif, exécutez**eb migrate --interactive**.
La commande du mode interactif demande les informations suivantes :
+ Sélection des sites IIS à migrer
+ Noms de l'environnement et des applications
+ Sélection de la version de la plateforme
+ Type d'instance et autres options de configuration
## Sous-commandes
### explorer
La **eb migrate explore** sous-commande examine votre serveur IIS et répertorie les sites disponibles.
Utilisez cette commande pour afficher les informations suivantes :
+ Afficher tous les sites IIS sur le serveur
+ Avec`--verbose`, inspectez la configuration détaillée, y compris :
+ Liaisons et ports du site
+ Pools d'applications
+ Répertoires virtuels et leurs chemins physiques
+ Paramètres d'authentification
```
PS C:\migrations_workspace > eb migrate explore
Default Web Site
Site2
site3
router
```
```
PS C:\migrations_workspace > eb migrate explore --verbose
1: Default Web Site:
- Bindings:
- *:8083:
- Application '/':
- Application Pool: DefaultAppPool
- Enabled Protocols: http
- Virtual Directories:
- /:
- Physical Path: C:\inetpub\wwwroot
- Logon Method: ClearText
- Application '/dotnet-6-0':
- Application Pool: DefaultAppPool
- Enabled Protocols: http
- Virtual Directories:
- /:
- Physical Path: C:\inetpub\AspNetCoreWebApps\CoreWebApp-6-0
- Logon Method: ClearText
- Application '/dotnet-8-0':
- Application Pool: DefaultAppPool
- Enabled Protocols: http
- Virtual Directories:
- /:
- Physical Path: C:\inetpub\AspNetCoreWebApps\CoreWebApp-8-0
- Logon Method: ClearText
2: Site2:
- Bindings:
- *:8081:
...
```
### nettoyage
La **eb migrate cleanup** sous-commande gère les artefacts de migration à l'aide des actions suivantes :
+ Préserver la dernière migration réussie dans `./migrations/latest`
+ Suppression des anciens répertoires de migration
+ Gestion des fichiers de configuration critiques
```
PS C:\migrations_workspace > eb migrate cleanup
Are you sure you would like to cleanup older artifacts within `./migrations/`? (y/N):
```
`--force`À utiliser pour ignorer les instructions de confirmation pendant le nettoyage.
```
PS C:\migrations_workspace > eb migrate cleanup --force
```
## Options
Aucune de ces options n'est obligatoire. Si vous exécutez **eb migrate** sans aucune option, l'interface de ligne de commande EB s'exécutera en mode non interactif. Avec**eb migrate --interactive**, l'EB CLI vous invite à saisir ou à sélectionner une valeur pour les paramètres requis.
****
| Nom | Description |
| --- | --- |
| `-a` *application-name* or `--application-name` *application-name* | Nom de la nouvelle application Elastic Beanstalk. Type : Chaîne Par défaut : EBMigrated App |
| `--archive` *directory-or-zip* | Le répertoire ou le fichier ZIP contenant le code source précédemment généré par**eb migrate --archive-only**. Utilisez cette option pour déployer un package de migration créé précédemment. Exemple : `--archive .\migrations\latest\upload_target` ou `--archive .\migrations\latest\upload_target.zip` |
| `-ao` or `--archive-only` | Créez uniquement le répertoire d'archives de destination sans déploiement. Le répertoire obtenu peut être déployé manuellement à l'**eb migrate**aide de l'`archive`option, ou**eb deploy**. |
| `-c` *subdomain-name* or `--cname` *subdomain-name* | Le nom du sous-domaine devant préfixer l'entrée DNS CNAME de votre application migrée. Type : Chaîne Par défaut : le nom de l'environnement |
| `-cf` or `--copy-firewall-config` | Copiez la configuration du pare-feu du serveur source vers la destination pour tous les ports HTTP dotés de liaisons actives. Crée les règles de groupe de sécurité correspondantes dans AWS. |
| `-es` *snapshot-id* [*snapshot-id* ...] or `--ebs-snapshots` *snapshot-id* [*snapshot-id* ...] | Liste séparée par des virgules des instantanés Amazon EBS IDs à associer à l'environnement. Exemple : `--ebs-snapshots snap-1234567890abcdef0, snap-0987654321fedcba1` |
| `--encrypt-ebs-volumes` | Appliquez le chiffrement à tous les nouveaux volumes Amazon EBS. Il s'agit d'un paramètre à l'échelle du compte qui affecte toutes les futures créations de volumes Amazon EBS. |
| `-e` *environment-name* or `--environment-name` *environment-name* | Nom du nouvel environnement Elastic Beanstalk. Type : Chaîne Par défaut : EBMigrated Env Contraintes : Doit comporter entre 4 et 40 caractères. Ne peut contenir que des lettres, des chiffres et des traits d'union. Il ne peut pas commencer ni se terminer par un trait d'union. |
| `--force` | Ignorez les instructions de confirmation pendant les opérations. Lorsqu'il est utilisé avec une **cleanup** sous-commande, supprime les artefacts de migration sans confirmation. |
| `-ip` *profile-name* or `--instance-profile` *profile-name* | Profil d'instance à associer aux EC2 instances Amazon de l'environnement. S'il n'est pas spécifié, crée un profil d'instance par défaut avec les autorisations d'accès aux ressources Elastic Beanstalk. Pour de plus amples informations, veuillez consulter [Profil d'instance Elastic Beanstalk](concepts-roles-instance.md). |
| `-i` *instance-type* or `--instance-type` *instance-type* | Type d' EC2 instance Amazon pour votre environnement Elastic Beanstalk. Type : Chaîne Par défaut : c5.2xlarge Pour connaître les types d'instances disponibles, consultez les [types d' EC2 instances Amazon](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html) dans le *guide de EC2 l'utilisateur Amazon*. |
| `-in` or `--interactive` | Forcer le mode interactif pour le processus de migration. Vous invite à saisir les valeurs de configuration même lorsque des valeurs par défaut sont disponibles. |
| `-k` *key-name* or `--keyname` *key-name* | Paire de EC2 clés Amazon pour permettre l'accès RDP aux instances de l'environnement. Utile pour étudier les problèmes au niveau de l'instance qui ne sont pas visibles dans les journaux. Valeurs valides : nom de paire de clés existant enregistré auprès d'Amazon EC2 |
| `-p` *platform-version* or `--platform` *platform-version* | Runtime de la plateforme Elastic Beanstalk pour l'environnement. Si ce n'est pas spécifié, détecté automatiquement à partir de la version hôte de Windows Server. Exemple : `"64bit Windows Server 2016 v2.16.2 running IIS 10.0"` Pour obtenir la liste des versions de plate-forme disponibles, utilisez la [liste des plateformes Web](eb3-platform.md#eb3-platform-list). |
| `--remote` | Indique d'exécuter la migration en mode distant. Cette option permet l'exécution à partir d'un hôte bastion, qui se connecte au serveur cible qui contient l'application et les configurations à migrer vers Elastic Beanstalk. Exécuté depuis le serveur Bastion, `eb migrate` découvre les configurations, met en place la logique de migration sur l'hôte du bastion, puis déploie votre application dans un nouvel environnement Elastic Beanstalk. Cette option élimine le besoin d'installer l'interface de ligne de commande EB et Python sur le serveur Windows que vous devez migrer. Vous installez plutôt Python et l'EB CLI sur un hôte bastion, où vous exécutez la **eb migrate** commande avec l'`--remote`option. Utilisez l'`--target-ip`option pour spécifier l'hôte avec les configurations IIS à migrer. Doit être utilisé avec `--target-ip``--username`, et`--password`. |
| `--target-ip` *ip-address* | Adresse IP publique de la machine Windows distante qui contient les serveurs IIS à migrer. Nécessaire lors de l'utilisation`--remote`. Ne peut être spécifié que lors de l'utilisation`--remote`. |
| `--username` *username* | Nom d'utilisateur du profil utilisateur permettant d'accéder à la machine Windows distante qui contient les serveurs IIS à migrer. Nécessaire lors de l'utilisation`--remote`. Ne peut être spécifié que lors de l'utilisation`--remote`. |
| `--password` *password* | Mot de passe du profil utilisateur permettant d'accéder à la machine Windows distante qui contient les serveurs IIS à migrer. Nécessaire lors de l'utilisation`--remote`. Ne peut être spécifié que lors de l'utilisation`--remote`. |
| `-sr` *role-name* or `--service-role` *role-name* | Rôle de service IAM pour Elastic Beanstalk afin de gérer les services associés. AWS S'il n'est pas spécifié, crée un rôle de service par défaut avec les autorisations nécessaires. Pour de plus amples informations, veuillez consulter [Rôle de service Elastic Beanstalk](concepts-roles-service.md). Spécifiez uniquement le nom du rôle, pas l'ARN complet. Elastic Beanstalk crée automatiquement l'ARN complet. |
| `-s` *site-names* or `--sites` *site-names* | Liste des sites IIS à migrer séparés par des virgules. Si ce n'est pas spécifié, migre tous les sites disponibles sur le serveur. Exemple : `--sites "Default Web Site,Intranet,API"` |
| `--ssl-certificates` *certificate-arn*[,*certificate-arn* ...] | Liste séparée par des virgules des certificats SSL ACM ARNs à associer à l'Application Load Balancer. Nécessaire lors de la migration de sites avec des liaisons HTTPS. Exemple : `--ssl-certificates arn:aws:acm:region:account:certificate/certificate-id` |
| `-t key1=value1[,key2=value2 ...]` or `--tags key1=value1[,key2=value2 ...]` | Liste de `key=value` paires séparées par des virgules pour baliser les nouvelles ressources de votre environnement : environnement, application Elastic Beanstalk, version de l'application. Pour de plus amples informations, veuillez consulter [Environnements de balisage](using-features.tagging.md). |
| `--verbose` | Afficher des informations détaillées pendant le processus de migration. Lorsqu'il est utilisé avec une **explore** sous-commande, affiche les détails complets de la configuration du site. |
| `-vpc` *config-file-or-string* or `--vpc-config` *config-file-or-string* | Configuration VPC pour l'environnement, spécifiée sous forme de chemin de fichier JSON ou de chaîne JSON. La configuration doit inclure : {
"id": "vpc-1234567890abcdef0",
"publicip": "true|false",
"elbscheme": "public|private",
"ec2subnets": ["subnet-a1b2c3d4", "subnet-e5f6g7h8"],
"securitygroups": "sg-123456,sg-789012",
"elbsubnets": ["subnet-a1b2c3d4", "subnet-e5f6g7h8"]
} [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/elasticbeanstalk/latest/dg/eb3-migrate.html) *La migration ignorera tous les paramètres VPC existants de l'environnement source lorsque vous spécifiez le `--vpc-config`* *paramètre.* Lorsque vous utilisez ce paramètre, la migration utilise uniquement les paramètres VPC spécifiés dans le fichier de configuration que vous transmettez. L'utilisation de ce paramètre remplace le comportement par défaut qui consiste à découvrir la configuration VPC de l'instance source ou à utiliser le VPC par défaut. |
| [Options courantes](eb3-cmd-options.md) | |
## Output
La commande fournit des mises à jour de statut tout au long du processus de migration :
1. Détection de configuration VPC (lors de l'exécution sur une EC2 instance)
1. Progression de la génération du bundle source pour chaque site
1. État de création de l'environnement
1. Progression du déploiement
En cas de succès, affiche les détails du nouvel environnement, notamment :
+ Nom et ID de l'environnement
+ Application name (Nom de l'application)
+ Région
+ Version de la plateforme
+ Environnement CNAME
En cas de problème lors de la migration, utilisez les [**eb health**](eb3-health.md)commandes [**eb events**](eb3-events.md)et pour obtenir des informations détaillées.
## Exemples
### Utilisation de base
Migration de base en mode interactif :
```
PS C:\migrations_workspace > eb migrate
Identifying VPC configuration of this EC2 instance (i-0123456789abcdef0):
id: vpc-1234567890abcdef0
publicip: true
elbscheme: public
ec2subnets: subnet-123,subnet-456,subnet-789
securitygroups: sg-123,sg-456
elbsubnets: subnet-123,subnet-456,subnet-789
Using .\migrations\latest to contain artifacts for this migration run.
Generating source bundle for sites, applications, and virtual directories...
Default Web Site/ -> .\migrations\latest\upload_target\DefaultWebSite.zip
Creating application version
Creating environment
Environment details for: EBMigratedEnv
Application name: EBMigratedApp
Region: us-west-2
Deployed Version: app-230320_153045
Environment ID: e-abcdef1234
Platform: 64bit Windows Server 2019 v2.7.0 running IIS 10.0
Tier: WebServer-Standard-1.0
CNAME: ebmigratedenv.us-west-2.elasticbeanstalk.com
Updated: 2023-03-20 15:30:45
```
Migration de sites spécifiques avec une configuration personnalisée :
```
PS C:\migrations_workspace > eb migrate `
--sites "Default Web Site,InternalAPI" `
--application-name "CorporateApp" `
--environment-name "Production" `
--instance-type "c5.xlarge" `
--tags "Environment=Production,Team=WebOps" `
--copy-firewall-config
```
Création d'une archive de migration sans déploiement :
```
PS C:\migrations_workspace > eb migrate --archive-only
Using .\migrations\latest to contain artifacts for this migration run.
Generating source bundle for sites, applications, and virtual directories...
Default Web Site/ -> .\migrations\latest\upload_target\DefaultWebSite.zip
Generated destination archive directory at .\migrations\latest\upload_target
You can execute `eb init` and `eb create` from this directory to deploy to EB.
```
### Exemples de configuration avancée
Migration avec configuration VPC personnalisée à l'aide d'un fichier JSON :
```
PS C:\migrations_workspace > cat vpc-config.json
{
"id": "vpc-1234567890abcdef0",
"publicip": "false",
"elbscheme": "internal",
"ec2subnets": [
"subnet-private1",
"subnet-private2"
],
"securitygroups": [
"sg-app",
"sg-database",
"sg-monitoring"
],
"elbsubnets": [
"subnet-private1",
"subnet-private2"
]
}
PS C:\migrations_workspace eb migrate `
--sites "InternalAPI" `
--vpc-config vpc-config.json `
--instance-type "r5.xlarge" `
--tags "Environment=Internal,Security=High"
```
Migration de sites avec des certificats SSL et des en-têtes d'hôte :
```
PS C:\migrations_workspace > eb migrate `
--sites "SecurePortal" `
--ssl-certificates "arn:aws:acm:region:account:certificate/cert1,arn:aws:acm:region:account:certificate/cert2" `
--verbose
INFO: Detected HTTPS bindings:
- www.example.com:443
- api.example.com:443
INFO: Configuring Application Load Balancer with SSL certificates
INFO: Creating host-based routing rules:
- www.example.com -> target group 1
- api.example.com -> target group 2
```
Migration avec configuration instantanée EBS:fo
```
PS C:\migrations_workspace > eb migrate `
--sites "Default Web Site" `
--ebs-snapshots "snap-1234567890abcdef0" "snap-0987654321fedcba1" `
--encrypt-ebs-volumes
Using .\migrations\latest to contain artifacts for this migration run.
INFO: Enabling EBS encryption for all new volumes in us-west-2
INFO: Configuring environment with specified EBS snapshots
```
### Exemples de configuration de sécurité
Gestion des sites soumis à des règles de pare-feu complexes :
```
PS C:\migrations_workspace > eb migrate `
--sites "Default Web Site,ReportingService" `
--copy-firewall-config `
--verbose
INFO: Detected the following Windows Firewall rules:
- Allow Web Traffic (TCP 80, 443)
- Allow Reporting Traffic (TCP 8081)
INFO: Creating corresponding security group rules
```
Migration avec des rôles IAM personnalisés :
```
PS C:\migrations_workspace > eb migrate `
--sites "SecureApp" `
--instance-profile "CustomInstanceProfile" `
--service-role "CustomServiceRole"
```
### Exemples d'exécution à distance
Migration des applications IIS depuis un serveur Windows distant :
```
PS C:\migrations_workspace > eb migrate `
--remote `
--target-ip "192.0.2.10" `
--username "administrator" `
--password "YourPassword123" `
--application-name "RemoteApp" `
--environment-name "RemoteEnv"
INFO: Establishing SSH connection to remote host 192.0.2.10...
INFO: Connection established
INFO: Discovering IIS sites on remote host...
INFO: Found 2 sites: Default Web Site, API
INFO: Extracting site configurations...
INFO: Generating source bundle for sites, applications, and virtual directories...
Default Web Site/ -> .\migrations\latest\upload_target\DefaultWebSite.zip
API/ -> .\migrations\latest\upload_target\API.zip
Creating application version
Creating environment
Environment details for: RemoteEnv
Application name: RemoteAppstage mi
Region: us-west-2
Deployed Version: app-230320_153045
Environment ID: e-abcdef1234
Platform: 64bit Windows Server 2019 v2.7.0 running IIS 10.0
Tier: WebServer-Standard-1.0
CNAME: remoteenv.us-west-2.elasticbeanstalk.com
Updated: 2023-03-20 15:30:45
```
Migration à distance avec sélection de sites spécifiques :
```
PS C:\migrations_workspace > eb migrate `
--remote `
--target-ip "192.0.2.10" `
--username "administrator" `
--password "YourPassword123" `
--sites "API" `
--instance-type "c5.large"
```
# **eb open**
## Description
Ouvre l'URL publique de votre site web dans le navigateur par défaut.
## Syntaxe
**eb open**
**eb open *environment-name***
## Options
****
| Nom | Description |
| --- | --- |
| [Options courantes](eb3-cmd-options.md) | |
## Output
La commande **eb open** n'a pas de sortie. Au lieu de cela, elle ouvre l'application dans une fenêtre de navigateur.
# **eb platform**
## Description
Cette commande prend en charge deux espaces de travail différents :
[Plateforme](#eb3-platform-preconfigured)
Utilisez cet espace de travail pour gérer les plateformes personnalisées.
[Environnement](#eb3-platform-environment)
Utilisez cet espace de travail pour sélectionner une plateforme par défaut ou afficher des informations sur la plateforme actuelle.
Elastic Beanstalk fournit le raccourci **ebp** pour **eb platform**.
**Note**
Windows PowerShell l'utilise **ebp** comme alias de commande. Si vous exécutez l'interface de ligne de commande EB sous Windows PowerShell, utilisez la forme longue de cette commande —**eb platform**.
## Utilisation de la plateforme eb pour les plateformes personnalisées
Répertorie les versions de la plateforme actuelle et vous permet de gérer des plateformes personnalisées.
### Syntaxe
**eb platform create [*version*] [*options*]**
**eb platform delete [*version*] [*options*]**
**eb platform events [*version*] [*options*]**
**eb platform init [*platform*] [*options*]**
**eb platform list [*options*]**
**eb platform logs [*version*] [*options*]**
**eb platform status [*version*] [*options*]**
**eb platform use [*platform*] [*options*]**
### Options
****
| Nom | Description |
| --- | --- |
| `create [version] [options]` | Créer une nouvelle version de la plateforme. [En savoir plus](#eb3-platform-create). |
| `delete version [options]` | Supprimer une version de plateforme. [En savoir plus](#eb3-platform-delete). |
| `events [version] [options]` | Afficher les événements issus de la version de plateforme. [En savoir plus](#eb3-platform-events). |
| `init [platform] [options]` | Initialiser un référentiel de plateforme. [En savoir plus](#eb3-platform-init). |
| `list [options]` | Répertorier les versions de la plateforme actuelle. [En savoir plus](#eb3-platform-list). |
| `logs [version] [options]` | Afficher les journaux de l'environnement de génération pour une version de plateforme. [En savoir plus](#eb3-platform-logs). |
| `status [version] [options]` | Afficher le statut de la version de plateforme. [En savoir plus](#eb3-platform-status). |
| `use [platform] [options]` | Choisir une autre plateforme à partir de laquelle créer de nouvelles versions. [En savoir plus](#eb3-platform-use). |
| [Options courantes](eb3-cmd-options.md) | |
### Options courantes
Toutes les commandes **eb platform** contiennent les options courantes suivantes.
****
| Nom | Description |
| --- | --- |
| `-h` OR `--help` | Affiche un message d'aide, puis se ferme. |
| `--debug` | Affiche une sortie de débogage supplémentaire. |
| `--quiet` | Supprime toutes les sorties. |
| `-v` OR `--verbose` | Affiche une sortie supplémentaire. |
| `--profile PROFILE` | Utilise les informations spécifiées *PROFILE* dans vos informations d'identification. |
| `-r REGION` OU `--region REGION` | Utilisez la région*REGION*. |
| `--no-verify-ssl` | Ne vérifiez pas les certificats AWS SSL. |
### Eb platform create
Crée une nouvelle version de la plateforme et renvoie l'ARN de la nouvelle version. Si aucun environnement de génération n'est en cours d'exécution dans la région actuelle, cette commande en lance un. Les options *version* et incrément (`-M``-m`, et`-p`) s'excluent mutuellement.
#### Options
****
| Nom | Description |
| --- | --- |
| *version* | Si *version* ce n'est pas spécifié, crée une nouvelle version basée sur la plateforme la plus récente avec la version du correctif (N dans n.n.N) incrémentée. |
| `-M` OU `--major-increment` | Incrémente le numéro de version majeure (N dans N.n.n). |
| `-m` OR `--minor-increment` | Incrémente le numéro de version mineure (N dans n.N.n). |
| `-p` OR `--patch-increment` | Incrémente le numéro de version du correctif (N dans n.n.N). |
| `-i INSTANCE_TYPE` OU --type d'instance *INSTANCE\$1TYPE* | À utiliser *INSTANCE\$1TYPE* comme type d'instance, par exemple**t1.micro**. |
| `-ip INSTANCE_PROFILE` OU `--instance-profile INSTANCE_PROFILE` | *INSTANCE\$1PROFILE*À utiliser comme profil d'instance lors de la création AMIs d'une plateforme personnalisée. Si l'option `-ip` n'est pas spécifiée, crée le profil d'instance `aws-elasticbeanstalk-custom-platforme-ec2-role` et l'utilise pour la plateforme personnalisée. |
| `--tags key1=value1[,key2=value2 ...]` | Les balises sont spécifiées sous la forme d'une liste séparée par des virgules et composée de paires `key=value`. |
| `--timeout` *minutes* | Définissez le nombre de minutes avant que la commande expire. |
| `--vpc.id VPC_ID` | ID du VPC dans lequel Packer effectue la création. |
| `--vpc.subnets VPC_SUBNETS` | Sous-réseaux VPC dans lesquels Packer effectue la création. |
| `--vpc.publicip` | Associe IPs le public aux EC2 instances lancées. |
### Eb platform delete
Supprimer une version de plateforme. La version n'est pas supprimée si un environnement l'utilise.
#### Options
****
| Nom | Description |
| --- | --- |
| `version` | La version à supprimer. Cette valeur est obligatoire. |
| `--cleanup` | Supprimer toutes les versions de plateforme à l'état `Failed`. |
| `--all-platforms` | Si `--cleanup` est spécifié, supprimer toutes les versions de plateforme à l'état `Failed` pour toutes les plateformes. |
| `--force` | Ne pas demander de confirmation lors de la suppression d'une version. |
### Eb platform events
Afficher les événements issus de la version de plateforme. Si *version* tel est le cas, affichez les événements de cette version, sinon affichez les événements de la version actuelle.
#### Options
****
| Nom | Description |
| --- | --- |
| *version* | La version pour laquelle des événements sont affichés. Cette valeur est obligatoire. |
| `-f` OR `--follow` | Continuer à afficher les événements au fur et à mesure qu'ils se produisent. |
### Eb platform init
Initialiser un référentiel de plateforme.
#### Options
****
| Nom | Description |
| --- | --- |
| `platform` | Le nom de la plateforme à initialiser. Cette valeur est obligatoire, sauf si le mode interactif `-i` est activé. |
| `-i` OR `--interactive` | Utiliser le mode interactif. |
| `-k KEYNAME` OU `--keyname KEYNAME` | Le nom de EC2 clé par défaut. |
Vous pouvez exécuter cette commande dans un répertoire qui a été initialisé auparavant, mais dans ce cas, vous ne pouvez pas modifier le type de l'espace de travail.
Pour relancer l'initialisation aves d'autres options, utilisez l'option `-i`.
### Eb platform list
Répertorier les versions de la plateforme associées à un espace de travail (répertoire) ou à une région.
La commande renvoie des résultats différents en fonction du type d'espace de travail dans lequel vous l'exécutez, comme suit :
+ Dans un espace de travail de plateforme (un répertoire initialisé par `eb platform init`), la commande renvoie une liste de toutes les versions de plateforme de la plateforme personnalisée définie dans l'espace de travail. Ajoutez l'option `--verbose` ou `--all-platforms` pour obtenir une liste de toutes les versions de plateforme de toutes les plateformes personnalisées que votre compte possède dans la région associée à l'espace de travail.
+ Dans un espace de travail d'application (un répertoire initialisé par `eb init`), la commande renvoie une liste de toutes les versions de plateforme, à la fois pour les plateformes prises en charge par Elastic Beanstalk et pour les plateformes personnalisées de votre compte. La liste utilise des noms de version de plateforme courts, et certaines variantes de version de plateforme peuvent être associées. Ajoutez l'option `--verbose` pour obtenir une liste détaillée avec les noms complets et toutes les variantes répertoriées séparément.
+ Dans un répertoire non initialisé, la commande fonctionne uniquement avec l'option `--region`. Elle renvoie une liste de toutes les versions de plateforme gérées par Elastic Beanstalk prises en charge dans la région. La liste utilise des noms de version de plateforme courts, et certaines variantes de version de plateforme peuvent être associées. Ajoutez l'option `--verbose` pour obtenir une liste détaillée avec les noms complets et toutes les variantes répertoriées séparément.
#### Options
****
| Nom | Description |
| --- | --- |
| `-a` OR `--all-platforms` | Valide uniquement dans un espace de travail initialisé (un répertoire initialisé par `eb platform init` ou `eb init`). Répertorie les versions de plateforme de toutes les plateformes personnalisées associées à votre compte. |
| `-s STATUS` OU `--status STATUS` | Répertoriez uniquement les plateformes correspondantes *STATUS* : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/elasticbeanstalk/latest/dg/eb3-platform.html) |
### Eb platform logs
Afficher les journaux de l'environnement de génération pour une version de plateforme.
#### Options
****
| Nom | Description |
| --- | --- |
| `version` | La version de la plateforme pour laquelle des journaux sont affichés. Si cette option est omise, afficher les journaux de la version actuelle. |
| `--stream` | Diffusez les journaux de déploiement configurés avec CloudWatch. |
### Eb platform status
Afficher le statut de la version de plateforme.
#### Options
****
| Nom | Description |
| --- | --- |
| `version` | La version de la plateforme pour laquelle le statut est extrait. Si cette option est omise, afficher le statut de la version actuelle. |
### Eb platform use
Choisir une autre plateforme à partir de laquelle créer de nouvelles versions.
#### Options
****
| Nom | Description |
| --- | --- |
| `platform` | Spécifie *platform* comme version active pour cet espace de travail. Cette valeur est obligatoire. |
## Utilisation de la plateforme eb pour les environnements
Répertorie les plateformes prises en charge et vous permet de définir la plate-forme par défaut et la version de la plateforme à utiliser quand vous lancez un environnement. Utilisez **eb platform list** pour afficher une liste de toutes les plateformes prises en charge. Utilisez **eb platform select** pour modifier la plateforme pour votre projet. Utilisez **eb platform show** pour afficher la plateforme sélectionnée de votre projet.
### Syntaxe
**eb platform list**
**eb platform select**
**eb platform show**
### Options
****
| Nom | Description |
| --- | --- |
| `list` | Répertorier la version de la plateforme actuelle. |
| `select` | Sélectionner la plateforme par défaut. |
| `show` | Afficher des informations sur la plateforme actuelle. |
### Exemple 1
L'exemple suivant répertorie les noms de toutes les configurations pour toutes les plateformes qu'Elastic Beanstalk prend en charge.
```
$ eb platform list
docker-1.5.0
glassfish-4.0-java-7-(preconfigured-docker)
glassfish-4.1-java-8-(preconfigured-docker)
go-1.3-(preconfigured-docker)
go-1.4-(preconfigured-docker)
iis-7.5
iis-8
iis-8.5
multi-container-docker-1.3.3-(generic)
node.js
php-5.3
php-5.4
php-5.5
python
python-2.7
python-3.4
python-3.4-(preconfigured-docker)
ruby-1.9.3
ruby-2.0-(passenger-standalone)
ruby-2.0-(puma)
ruby-2.1-(passenger-standalone)
ruby-2.1-(puma)
ruby-2.2-(passenger-standalone)
ruby-2.2-(puma)
tomcat-6
tomcat-7
tomcat-7-java-6
tomcat-7-java-7
tomcat-8-java-8
```
### Exemple 2
L'exemple suivant vous invite à choisir parmi une liste de plateformes, ainsi que la version que vous souhaitez déployer pour la plateforme spécifiée.
```
$ eb platform select
Select a platform.
1) PHP
2) Node.js
3) IIS
4) Tomcat
5) Python
6) Ruby
7) Docker
8) Multi-container Docker
9) GlassFish
10) Go
(default is 1): 5
Select a platform version.
1) Python 2.7
2) Python
3) Python 3.4 (Preconfigured - Docker)
```
### Exemple 3
L'exemple suivant présente des informations sur la plateforme par défaut actuelle.
```
$ eb platform show
Current default platform: Python 2.7
New environments will be running: 64bit Amazon Linux 2014.09 v1.2.0 running Python 2.7
Platform info for environment "tmp-dev":
Current: 64bit Amazon Linux 2014.09 v1.2.0 running Python
Latest: 64bit Amazon Linux 2014.09 v1.2.0 running Python
```
# **eb printenv**
## Description
Affiche toutes les propriétés de l'environnement dans la fenêtre de commande.
## Syntaxe
**eb printenv**
**eb printenv *environment-name***
## Options
****
| Nom | Description |
| --- | --- |
| [Options courantes](eb3-cmd-options.md) | |
## Output
En cas de réussite, la commande renvoie l'état de l'opération `printenv`.
## Exemple
L'exemple suivant affiche les propriétés de l'environnement pour l'environnement spécifié.
```
$ eb printenv
Environment Variables:
PARAM1 = Value1
```
# **eb restore**
## Description
Reconstruit un environnement suspendu, en créant un nouvel environnement avec le même nom, le même ID et la même configuration. Le nom de l'environnement, le nom de domaine et la version de l'application doivent être disponibles pour que la reconstruction réussisse.
## Syntaxe
**eb restore**
**eb restore *environment\$1id***
## Options
****
| Nom | Description |
| --- | --- |
| [Options courantes](eb3-cmd-options.md) | |
## Output
L'interface de ligne de commande (CLI) EB affiche une liste d'environnements suspendus qui sont disponibles pour être restaurés.
## Exemple
```
$ eb restore
Select a terminated environment to restore
# Name ID Application Version Date Terminated Ago
3 gamma e-s7mimej8e9 app-77e3-161213_211138 2016/12/14 20:32 PST 13 mins
2 beta e-sj28uu2wia app-77e3-161213_211125 2016/12/14 20:32 PST 13 mins
1 alpha e-gia8mphu6q app-77e3-161213_211109 2016/12/14 16:21 PST 4 hours
(Commands: Quit, Restore, ▼ ▲)
Selected environment alpha
Application: scorekeep
Description: Environment created from the EB CLI using "eb create"
CNAME: alpha.h23tbtbm92.us-east-2.elasticbeanstalk.com
Version: app-77e3-161213_211109
Platform: 64bit Amazon Linux 2016.03 v2.1.6 running Java 8
Terminated: 2016/12/14 16:21 PST
Restore this environment? [y/n]: y
2018-07-11 21:04:20 INFO: restoreEnvironment is starting.
2018-07-11 21:04:39 INFO: Created security group named: sg-e2443f72
...
```
# **eb scale**
## Description
Adapte l'environnement pour qu'il s'exécute toujours sur un certain nombre d'instances, en définissant à la fois les nombres minimal et maximal d'instances sur le nombre spécifié.
## Syntaxe
**eb scale *number-of-instances***
**eb scale *number-of-instances* *environment-name***
## Options
****
| Nom | Description |
| --- | --- |
| --timeout | Le nombre de minutes avant que la commande expire. |
| [Options courantes](eb3-cmd-options.md) | |
## Output
En cas de réussite, la commande met à jour les nombres minimal et maximal d'instances à exécuter sur le nombre spécifié.
## Exemple
L'exemple suivant définit le nombre d'instances sur 2.
```
$ eb scale 2
2018-07-11 21:05:22 INFO: Environment update is starting.
2018-07-11 21:05:27 INFO: Updating environment tmp-dev's configuration settings.
2018-07-11 21:08:53 INFO: Added EC2 instance 'i-5fce3d53' to Auto Scaling Group 'awseb-e-2cpfjbra9a-stack-AWSEBAutoScalingGroup-7AXY7U13ZQ6E'.
2018-07-11 21:08:58 INFO: Successfully deployed new configuration to environment.
2018-07-11 21:08:59 INFO: Environment update completed successfully.
```
# **eb setenv**
## Description
Définit les [propriétés d'environnement](environments-cfg-softwaresettings.md) pour l'environnement par défaut.
## Syntaxe
**eb setenv *key*=*value***
Vous pouvez inclure autant de propriétés que vous voulez, mais la taille totale de toutes les propriétés ne peut pas dépasser 4 096 octets. Vous pouvez supprimer une variable en laissant la valeur vierge. Pour connaître les limites, consultez [Configuration des propriétés de l'environnement (variables d'environnement)](environments-cfg-softwaresettings.md#environments-cfg-softwaresettings-console).
**Note**
Si `value` contient un [caractère spécial](http://tldp.org/LDP/abs/html/special-chars.html)`\`, vous devez l'échapper en le faisant précéder d'un caractère .
## Options
****
| Nom | Description |
| --- | --- |
| --timeout | Le nombre de minutes avant que la commande expire. |
| [Options courantes](eb3-cmd-options.md) | |
## Output
En cas de réussite, la commande affiche que la mise à jour de l'environnement a abouti.
## Exemple
L'exemple suivant définit la variable d'environnement ExampleVar.
```
$ eb setenv ExampleVar=ExampleValue
2018-07-11 21:05:25 INFO: Environment update is starting.
2018-07-11 21:05:29 INFO: Updating environment tmp-dev's configuration settings.
2018-07-11 21:06:50 INFO: Successfully deployed new configuration to environment.
2018-07-11 21:06:51 INFO: Environment update completed successfully.
```
La commande suivante définit plusieurs propriétés d'environnement. Elle ajoute la propriété de l'environnement nommée `foo` et définit sa valeur sur `bar`, modifie la valeur de la propriété `JDBC_CONNECTION_STRING` et supprime les propriétés `PARAM4` et `PARAM5`.
```
$ eb setenv foo=bar JDBC_CONNECTION_STRING=hello PARAM4= PARAM5=
```
# **eb ssh**
## Description
**Note**
Cette commande ne fonctionne pas avec des environnements exécutant des instances Windows Server.
Connectez-vous à une EC2 instance Amazon Linux dans votre environnement à l'aide de Secure Shell (SSH). Si un environnement comporte plusieurs instances en cours d'exécution, l'interface de ligne de commande (CLI) EB vous invite à spécifier à quelle instance vous souhaitez vous connecter. Pour utiliser cette commande, SSH doit être installé sur votre ordinateur local et disponible à partir de la ligne de commande. Les fichiers de clé privée doivent se trouver dans un dossier nommé `.ssh` sous votre répertoire utilisateur, et les EC2 instances de votre environnement doivent avoir des adresses IP publiques.
Si le répertoire racine contient un fichier `platform.yaml` spécifiant une plateforme personnalisée, cette commande se connecte également à des instances dans l'environnement personnalisé.
**Clés SSH**
Si vous n'avez pas déjà configuré SSH, vous pouvez utiliser l'interface de ligne de commande (CLI) EB pour créer une clé lorsque vous exécutez **eb init**. Si vous avez déjà exécuté **eb init**, exécutez-le à nouveau avec l'option `--interactive` et sélectionnez **Yes (Oui)** et **Create New Keypair (Créer une nouvelle paire de clés)** lorsque vous êtes invité à configurer SSH. Les clés créées au cours de ce processus sont stockées dans le dossier approprié par l'interface de ligne de commande (CLI) EB.
Cette commande ouvre temporairement le port 22 dans le groupe de sécurité de votre environnement pour le trafic entrant à partir de 0.0.0.0/0 (toutes les adresses IP) si aucune règle pour le port 22 n'est déjà en place. Si vous avez configuré le groupe de sécurité de votre environnement pour ouvrir le port 22 sur une plage CIDR limitée pour une sécurité accrue, l'interface de ligne de commande (CLI) EB respectera ce paramètre et renoncez à toutes modifications apportées au groupe de sécurité. Pour substituer ce comportement et forcer l'interface de ligne de commande (CLI) EB à ouvrir le port 22 à tout trafic entrant, utilisez l'option `--force`.
Consultez [EC2 groupes de sécurité](using-features.managing.ec2.console.md#using-features.managing.ec2.securitygroups) pour obtenir des informations sur la configuration du groupe de sécurité de votre environnement.
## Syntaxe
**eb ssh**
**eb ssh *environment-name***
## Options
****
| Nom | Description |
| --- | --- |
| `-i` ou `--instance` | Spécifie l'ID d'instance de l'instance à laquelle vous vous connectez. Nous vous recommandons d'utiliser cette option. |
| `-n` ou `--number` | Spécifiez l'instance à laquelle se connecter à l'aide d'un chiffre. |
| `-o` ou `--keep_open` | Laissez le port 22 ouvert sur le groupe de sécurité à la fin de la session SSH. |
| `--command` | Exécutez une commande shell sur l'instance spécifiée au lieu de démarrer une session SSH. |
| `--custom` | Spécifiez une commande SSH à utiliser au lieu de « ssh -i keyfile ». N'incluez pas d'utilisateur distant ni de nom d'hôte. |
| `--setup` | Modifiez la paire de clés attribuée aux instances de l'environnement (requiert le remplacement des instances). |
| `--force` | Ouvrez le port 22 au trafic entrant à partir de 0.0.0.0/0 dans le groupe de sécurité de l'environnement, même si le groupe de sécurité est déjà configuré pour SSH. Utilisez cette option si le groupe de sécurité de votre environnement est configuré pour ouvrir le port 22 à une plage CIDR limitée qui n'inclut pas l'adresse IP à partir de laquelle vous essayez de vous connecter. |
| `--timeout` *minutes* | Définissez le nombre de minutes avant que la commande expire. Peut être utilisé uniquement avec l'argument `--setup`. |
| [Options courantes](eb3-cmd-options.md) | |
## Output
En cas de réussite, la commande ouvre une connexion SSH sur l'instance.
## Exemple
L'exemple suivant vous connecte à l'environnement spécifié.
```
$ eb ssh
Select an instance to ssh into
1) i-96133799
2) i-5931e053
(default is 1): 1
INFO: Attempting to open port 22.
INFO: SSH port 22 open.
The authenticity of host '54.191.45.125 (54.191.45.125)' can't be established.
RSA key fingerprint is ee:69:62:df:90:f7:63:af:52:7c:80:60:1b:3b:51:a9.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added '54.191.45.125' (RSA) to the list of known hosts.
__| __|_ )
_| ( / Amazon Linux AMI
___|\___|___|
https://aws.amazon.com/amazon-linux-ami/2014.09-release-notes/
No packages needed for security; 1 packages available
Run "sudo yum update" to apply all updates.
[ec2-user@ip-172-31-8-185 ~]$ ls
[ec2-user@ip-172-31-8-185 ~]$ exit
logout
Connection to 54.191.45.125 closed.
INFO: Closed port 22 on ec2 instance security group
```
# **eb status**
## Description
Fournit des informations sur l'état de l'environnement.
Si le répertoire racine contient un fichier `platform.yaml` spécifiant une plateforme personnalisée, cette commande fournit également des informations sur l'environnement de génération.
## Syntaxe
**eb status**
**eb status *environment-name***
## Options
****
| Nom | Description |
| --- | --- |
| `-v` ou `--verbose` | Fournit plus d'informations sur les instances individuelles, telles que leur statut avec l'équilibreur de charge Elastic Load Balancing. |
| [Options courantes](eb3-cmd-options.md) | |
## Output
En cas de réussite, la commande renvoie les informations suivantes sur l'environnement :
+ Nom de l'environnement
+ Nom de l'application
+ Version de l'application déployée
+ ID de l'environnement
+ Plateforme
+ Niveau de l'environnement
+ CNAME
+ Heure de dernière mise à jour de l'environnement
+ État
+ Santé
Si vous utilisez le mode détaillé, l'interface de ligne de commande EB vous indique également le nombre d'instances Amazon EC2 en cours d'exécution.
## Exemple
L'exemple suivant affiche l'état du tmp-dev de l'environnement.
```
$ eb status
Environment details for: tmp-dev
Application name: tmp
Region: us-west-2
Deployed Version: None
Environment ID: e-2cpfjbra9a
Platform: 64bit Amazon Linux 2014.09 v1.0.9 running PHP 5.5
Tier: WebServer-Standard-1.0
CNAME: tmp-dev.elasticbeanstalk.com
Updated: 2014-10-29 21:37:19.050000+00:00
Status: Launching
Health: Grey
```
# **eb swap**
## Description
Echange le CNAME de l'environnement avec le CNAME d'un autre environnement (par exemple, pour éviter des temps d'arrêt lorsque vous mettez à jour la version de votre application).
**Note**
Si vous avez plus de deux environnements, vous êtes invité à sélectionner dans une liste d'environnements le nom de l'environnement qui utilise actuellement le CNAME que vous souhaitez. Pour supprimer cela, vous pouvez spécifier le nom de l'environnement à utiliser en incluant l'option `-n` lorsque vous exécutez la commande.
## Syntaxe
**eb swap**
**eb swap *environment-name***
**Note**
*environment-name*Il s'agit de l'environnement pour lequel vous souhaitez un CNAME différent. Si vous ne le spécifiez pas *environment-name* en tant que paramètre de ligne de commande lors de l'exécution**eb swap**, l'interface de ligne de commande EB met à jour le CNAME de l'environnement par défaut.
## Options
****
| Nom | Description |
| --- | --- |
| `-n` or `--destination_name` | Spécifie le nom de l'environnement avec lequel vous souhaitez échanger CNAMEs. Si vous exécutez **eb swap** sans cette option, alors l'interface de ligne de commande (CLI) EB vous invite à choisir dans une liste de vos environnements. |
| [Options courantes](eb3-cmd-options.md) | |
## Output
En cas de réussite, la commande renvoie l'état de l'opération `swap`.
## Exemples
L'exemple suivant échange le tmp-dev de l'environnement avec live-env.
```
$ eb swap
Select an environment to swap with.
1) staging-dev
2) live-env
(default is 1): 2
2018-07-11 21:05:25 INFO: swapEnvironmentCNAMEs is starting.
2018-07-11 21:05:26 INFO: Swapping CNAMEs for environments 'tmp-dev' and 'live-env'.
2018-07-11 21:05:30 INFO: 'tmp-dev.elasticbeanstalk.com' now points to 'awseb-e-j-AWSEBLoa-M7U21VXNLWHN-487871449.us-west-2.elb.amazonaws.com'.
2018-07-11 21:05:30 INFO: Completed swapping CNAMEs for environments 'tmp-dev' and 'live-env'.
```
L'exemple suivant échange le tmp-dev de l'environnement avec le live-env de l'environnement mais ne vous invite pas à entrer ou à sélectionner une valeur pour aucun paramètre.
```
$ eb swap tmp-dev --destination_name live-env
2018-07-11 21:18:12 INFO: swapEnvironmentCNAMEs is starting.
2018-07-11 21:18:13 INFO: Swapping CNAMEs for environments 'tmp-dev' and 'live-env'.
2018-07-11 21:18:17 INFO: 'tmp-dev.elasticbeanstalk.com' now points to 'awseb-e-j-AWSEBLoa-M7U21VXNLWHN-487871449.us-west-2.elb.amazonaws.com'.
2018-07-11 21:18:17 INFO: Completed swapping CNAMEs for environments 'tmp-dev' and 'live-env'.
```
# **eb tags**
## Description
Ajoutez, supprimez, mettez à jour et listez des balises d'une ressource Elastic Beanstalk.
Pour de plus amples informations sur le balisage des ressources dans Elastic Beanstalk, veuillez consulter [Étiquette des ressources d'application Elastic Beanstalk](applications-tagging-resources.md).
## Syntaxe
**eb tags [*environment-name*] [--resource *ARN*] -l \$1 --list**
**eb tags [*environment-name*] [--resource *ARN*] -a \$1 --add *key1*=*value1*[,*key2*=*value2* ...]**
**eb tags [*environment-name*] [--resource *ARN*] -u \$1 --update *key1*=*value1*[,*key2*=*value2* ...]**
**eb tags [*environment-name*] [--resource *ARN*] -d \$1 --delete *key1*[,*key2* ...]**
Vous pouvez combiner les options de sous-commande `--add`, `--update` et `--delete` en une seule commande. Au moins l'une d'elles est obligatoire. Vous ne pouvez pas combiner n'importe laquelle des trois options de sous-commande avec `--list`.
Sans tous les arguments supplémentaires, tous ces commandes répertorient ou modifient les balises de l'environnement par défaut dans le répertoire actuel de l'application. Avec un *environment-name* argument, les commandes répertorient ou modifient les balises de cet environnement. Avec l'option `--resource`, les commandes listent ou modifient les balises de n'importe quelle ressource Elastic Beanstalk – une application, un environnement, une version d'application, une configuration enregistrée, ou une version de plateforme personnalisée. Spécifiez la ressource par son Amazon Resource Name (ARN).
## Options
Aucune de ces options n'est obligatoire. Si vous exécutez **eb create** sans aucune option, vous êtes invité à saisir ou à sélectionner une valeur pour chaque paramètre.
****
| Nom | Description |
| --- | --- |
| `-l` ou `--list` | Liste tous les balises qui sont actuellement appliquées à la ressource. |
| `-a key1=value1[,key2=value2 ...]` ou `--add key1=value1[,key2=value2 ...]` | Appliquez de nouvelles balises à la ressource. Spécifiez les balises sous la forme d'une liste séparée par des virgules et composée de paires `key=value`. Vous ne pouvez pas spécifier les clés de balises existantes. Valeurs valides : consultez [Balisage de ressources ](applications-tagging-resources.md). |
| `-u key1=value1[,key2=value2 ...]` ou `--update key1=value1[,key2=value2 ...]` | Mettez à jour les valeurs des balises de ressources existantes. Spécifiez les balises sous la forme d'une liste séparée par des virgules et composée de paires `key=value`. Vous devez spécifier les clés de balises existantes. Valeurs valides : consultez [Balisage de ressources ](applications-tagging-resources.md). |
| `-d key1[,key2 ...]` ou `--delete key1[,key2 ...]` | Supprimez des balises de ressources existantes. Spécifiez les balises sous la forme d'une liste de clés séparées par des virgules. Vous devez spécifier les clés de balises existantes. Valeurs valides : consultez [Balisage de ressources ](applications-tagging-resources.md). |
| `-r` *region* or `--region` *region* | L' Région AWS endroit dans lequel se trouve votre ressource. Par défaut : la région configuré par défaut. Pour obtenir la liste des valeurs que vous pouvez spécifier pour cette option, consultez [Points de terminaison et quotas AWS Elastic Beanstalk](https://docs.aws.amazon.com/general/latest/gr/elasticbeanstalk.html) dans *Références générales AWS*. |
| `--resource ARN` | L'ARN de la ressource que la commande modifie ou pour laquelle elle répertorie les balises. Si elle n'est pas spécifiée, la commande fait référence à l'environnement spécifié (par défaut) de l'application du répertoire actuel. Valeurs valides : voir l'une des sous-rubriques [Balisage de ressources ](applications-tagging-resources.md) qui est spécifique à la ressource qui vous intéresse. Ces rubriques montrent comment l'ARN de la ressource est construit et expliquent comment obtenir une liste de ces ressources ARNs qui existent pour votre application ou votre compte. |
## Output
L'option de sous-commande `--list` affiche la liste des balises de la ressource. La sortie montre à la fois les balises qu'Elastic Beanstalk applique par défaut et vos balises personnalisées.
```
$ eb tags --list
Showing tags for environment 'MyApp-env':
Key Value
Name MyApp-env
elasticbeanstalk:environment-id e-63cmxwjaut
elasticbeanstalk:environment-name MyApp-env
mytag tagvalue
tag2 2nd value
```
Les options de sous-commande `--add`, `--update` et `--delete`, lorsqu'elles aboutissent, n'ont pas de sortie. Vous pouvez ajouter l'option `--verbose` pour voir la sortie détaillée de l'activité de la commande.
```
$ eb tags --verbose --update "mytag=tag value"
Updated Tags:
Key Value
mytag tag value
```
## Exemples
La commande suivante ajoute une balise avec succès avec la clé `tag1` et la valeur `value1` à l'environnement par défaut de l’application, et, dans le même temps, supprime la balise `tag2`.
```
$ eb tags --add tag1=value1 --delete tag2
```
La commande suivante ajoute une balise avec succès à une configuration enregistrée au sein d'une application.
```
$ eb tags --add tag1=value1 \
--resource "arn:aws:elasticbeanstalk:us-east-2:my-account-id:configurationtemplate/my-app/my-template"
```
La commande suivante échoue, car elle essaie de mettre à jour une balise inexistante.
```
$ eb tags --update tag3=newval
ERROR: Tags with the following keys can't be updated because they don't exist:
tag3
```
La commande suivante échoue, car elle essaie de mettre à jour et de supprimer la même clé.
```
$ eb tags --update mytag=newval --delete mytag
ERROR: A tag with the key 'mytag' is specified for both '--delete' and '--update'. Each tag can be either deleted or updated in a single operation.
```
# **eb terminate**
## Description
Met fin à l'environnement en cours d'exécution afin que vous n'ayez pas à payer de frais pour les ressources non utilisées AWS .
Via l'option `--all`, supprime l'application sur laquelle le répertoire actuel a été initialisé à l'aide de [**eb init**](eb3-init.md). La commande met fin à tous les environnements de l'application. Elle résilie également les [versions d'application](applications-versions.md) et les [configurations enregistrées](environment-configuration-savedconfig.md) de l'application, puis supprime l'application.
Si le répertoire racine contient un fichier `platform.yaml` spécifiant une plateforme personnalisée, cette commande met hors service l'environnement personnalisé en cours d'exécution.
**Note**
Vous pouvez toujours lancer un nouvel environnement en utilisant la même version ultérieurement.
Si vous possédez des données d'un environnement que vous souhaitez conserver, définissez la stratégie de suppression de base de données sur `Retain` avant de résilier l'environnement. Cela permet de maintenir la base de données opérationnelle en dehors d'Elastic Beanstalk. Tous les environnements Elastic Beanstalk doivent ensuite s'y connecter en tant que base de données externe. Si vous souhaitez sauvegarder les données sans maintenir la base de données opérationnelle, définissez la stratégie de suppression pour qu'elle prenne un instantané de la base de données avant de résilier l'environnement. Pour de plus amples informations, consultez [Cycle de vie de base de données](using-features.managing.db.md#environments-cfg-rds-lifecycle) dans le chapitre *Configuration des environnements* de ce guide.
**Important**
Si vous résiliez un environnement, vous devez également supprimer tous les mappages CNAME que vous avez créés, car d'autres clients peuvent réutiliser un nom d'hôte disponible. Veillez à supprimer les enregistrements DNS qui pointent vers votre environnement résilié, afin d'éviter toute *entrée DNS en suspens*. Une entrée DNS bloquée peut exposer le trafic Internet destiné à votre domaine à des failles de sécurité. Elle peut également présenter d'autres risques.
Pour de plus amples informations, veuillez consulter [Protection contre les enregistrements de délégation suspendus dans Route 53](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/protection-from-dangling-dns.html) dans le *manuel du développeur Amazon Route 53*. Vous pouvez également en savoir plus sur le blocage des entrées DNS dans [Enhanced Domain Protections for Amazon CloudFront Requests sur](https://aws.amazon.com/blogs/security/enhanced-domain-protections-for-amazon-cloudfront-requests/) le *blog sur la AWS sécurité*.
## Syntaxe
**eb terminate**
**eb terminate *environment-name***
## Options
****
| Nom | Description |
| --- | --- |
| `--all` | Met fin à tous les environnements dans l'application, suspend les [versions d'application](applications-versions.md) et les [configurations enregistrées](environment-configuration-savedconfig.md) de l'application, puis supprime l'application. |
| `--force` | Résilie l'environnement sans demande de confirmation. |
| `--ignore-links` | Résilie l'environnement même s'il existe des environnements dépendants qui y sont liés. Consultez [Compose Environments](ebcli-compose.md). |
| `--timeout` | Le nombre de minutes avant que la commande expire. |
## Output
En cas de réussite, la commande renvoie l'état de l'opération `terminate`.
## Exemple
L'exemple de demande suivant résilie le tmp-dev DE l'environnement.
```
$ eb terminate
The environment "tmp-dev" and all associated instances will be terminated.
To confirm, type the environment name: tmp-dev
2018-07-11 21:05:25 INFO: terminateEnvironment is starting.
2018-07-11 21:05:40 INFO: Deleted CloudWatch alarm named: awseb-e-2cpfjbra9a-stack-AWSEBCloudwatchAlarmHigh-16V08YOF2KQ7U
2018-07-11 21:05:41 INFO: Deleted CloudWatch alarm named: awseb-e-2cpfjbra9a-stack-AWSEBCloudwatchAlarmLow-6ZAWH9F20P7C
2018-07-11 21:06:42 INFO: Deleted Auto Scaling group policy named: arn:aws:autoscaling:us-east-2:11122223333:scalingPolicy:5d7d3e6b-d59b-47c5-b102-3e11fe3047be:autoScalingGroupName/awseb-e-2cpfjbra9a-stack-AWSEBAutoScalingGroup-7AXY7U13ZQ6E:policyName/awseb-e-2cpfjbra9a-stack-AWSEBAutoSca
lingScaleUpPolicy-1876U27JEC34J
2018-07-11 21:06:43 INFO: Deleted Auto Scaling group policy named: arn:aws:autoscaling:us-east-2:11122223333:scalingPolicy:29c6e7c7-7ac8-46fc-91f5-cfabb65b985b:autoScalingGroupName/awseb-e-2cpfjbra9a-stack-AWSEBAutoScalingGroup-7AXY7U13ZQ6E:policyName/awseb-e-2cpfjbra9a-stack-AWSEBAutoSca
lingScaleDownPolicy-SL4LHODMOMU
2018-07-11 21:06:48 INFO: Waiting for EC2 instances to terminate. This may take a few minutes.
2018-07-11 21:08:55 INFO: Deleted Auto Scaling group named: awseb-e-2cpfjbra9a-stack-AWSEBAutoScalingGroup-7AXY7U13ZQ6E
2018-07-11 21:09:10 INFO: Deleted security group named: awseb-e-2cpfjbra9a-stack-AWSEBSecurityGroup-XT4YYGFL7I99
2018-07-11 21:09:40 INFO: Deleted load balancer named: awseb-e-2-AWSEBLoa-AK6RRYFQVV3S
2018-07-11 21:09:42 INFO: Deleting SNS topic for environment tmp-dev.
2018-07-11 21:09:52 INFO: terminateEnvironment completed successfully.
```
# **eb upgrade**
## Description
Met à niveau la plateforme de votre environnement vers la version la plus récente de la plateforme sur laquelle il est actuellement en cours d'exécution.
Si le répertoire racine contient un fichier `platform.yaml` spécifiant une plateforme personnalisée, cette commande met à niveau l'environnement sur la version la plus récente de la plateforme personnalisée sur laquelle il est actuellement en cours d'exécution.
## Syntaxe
**eb upgrade**
**eb upgrade *environment-name***
## Options
****
| Nom | Description |
| --- | --- |
| `--force` | Met à niveau sans requérir que vous confirmiez le nom de l'environnement avant de commencer le processus de mise à niveau. |
| `--noroll` | Met à jour toutes les instances sans utiliser de mises à jour propagées pour maintenir certaines instances en service lors de la mise à niveau. |
| [Options courantes](eb3-cmd-options.md) | |
## Output
La commande offre une présentation de la modification et vous invite à confirmer la mise à niveau en tapant le nom de l'environnement. En cas de réussite, votre environnement est mis à jour, puis lancé avec la version la plus récente de la plateforme.
## Exemple
L'exemple suivant met à niveau la version actuelle de la plateforme de l'environnement spécifié vers la version de la plateforme la plus récente.
```
$ eb upgrade
Current platform: 64bit Amazon Linux 2014.09 v1.0.9 running Python 2.7
Latest platform: 64bit Amazon Linux 2014.09 v1.2.0 running Python 2.7
WARNING: This operation replaces your instances with minimal or zero downtime. You may cancel the upgrade after it has started by typing "eb abort".
You can also change your platform version by typing "eb clone" and then "eb swap".
To continue, type the environment name:
```
# **eb use**
## Description
Définit l'environnement spécifié en tant qu'environnement par défaut.
Lors de l'utilisation de Git, **eb use** définit l'environnement par défaut pour la branche actuelle. Exécutez cette commande une fois dans chaque branche que vous souhaitez déployer sur Elastic Beanstalk.
## Syntaxe
**eb use *environment-name***
## Options
****
| Nom | Description |
| --- | --- |
| `--source codecommit/repository-name/branch-name` | CodeCommit référentiel et branche. |
| `-r region` `--region region` | Modifiez la région dans laquelle vous créez les environnements. |
| [Options courantes](eb3-cmd-options.md) | |