Configuration de l'interface de ligne de commande EB

Une fois l'installation de l'interface de ligne de commande EB effectuée, vous êtes prêt à configurer votre répertoire de projet et l'interface de ligne de commande EB en exécutant eb init.

L'exemple suivant illustre les étapes de configuration à suivre lorsque vous exécutez eb init pour la première fois dans un dossier de projet nommé eb.

Pour initialiser un projet d'interface de ligne de commande EB

1. Tout d'abord, l'interface de ligne de commande EB vous invite à sélectionner une région. Saisissez le numéro qui correspond à la région que vous souhaitez utiliser, puis appuyez sur Entrée.

   ~/eb $ eb init
   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

2. Ensuite, fournissez votre clé d'accès et votre clé secrète pour que l'interface de ligne de commande EB puisse gérer les ressources à votre place. Les clés d'accès sont créées dans la console AWS Identity and Access Management. Si vous n'avez pas de clés, consultez Comment puis-je obtenir les informations d'identification de sécurité ? dans le manuel Référence générale d'Amazon Web Services.

   You have not yet set up your credentials or your credentials are incorrect.
   You must provide your credentials.
   (aws-access-id): AKIAJOUAASEXAMPLE
   (aws-secret-key): 5ZRIrtTM4ciIAvd4EXAMPLEDtm+PiPSzpoK

3. Dans Elastic Beanstalk, une application est une ressource qui contient un ensemble de versions d'application (source), d'environnements et de configurations enregistrées, qui sont associés à une application web unique. Chaque fois que vous déployez votre code source dans Elastic Beanstalk via l'interface de ligne de commande EB, une nouvelle version d'application est créée et ajoutée à la liste.

   Select an application to use
   1) [ Create new Application ]
   (default is 1): 1

4. Le nom de l'application par défaut correspond au nom du dossier dans lequel vous exécutez eb init. Saisissez un nom décrivant votre projet.

   Enter Application Name
   (default is "eb"): eb
   Application eb has been created.

5. Sélectionnez une plateforme qui correspond à l'infrastructure ou au langage dans lequel votre application web est développée. Si vous n'avez pas encore commencé à développer votre application, choisissez la plateforme qui vous intéresse. Vous saurez bientôt comment lancer un exemple d'application et vous pourrez modifier ce paramètre ultérieurement.

   Select a platform.
   1) Node.js
   2) PHP
   3) Python
   4) Ruby
   5) Tomcat
   6) IIS
   7) Docker
   8) Multi-container Docker
   9) GlassFish
   10) Go
   11) Java
   (default is 1): 1

6. Choisissez yes (oui) pour attribuer une paire de clés SSH aux instances de votre environnement Elastic Beanstalk. Cela vous permet de vous connecter directement à des fins de dépannage.

   Do you want to set up SSH for your instances?
   (y/n): y

7. Choisissez une paire de clés existante ou créez-en une. 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. L'interface de ligne de commande EB enregistre la nouvelle paire de clés avec Amazon EC2 et stocke la clé privée localement dans un dossier nommé .ssh, inclus dans votre répertoire utilisateur.

   Select a keypair.
   1) [ Create new KeyPair ]
   (default is 1): 1

Votre interface de ligne de commande EB est maintenant configurée et prête à être utilisée. Veuillez consulter Gestion des environnements Elastic Beanstalk avec l'interface de ligne de commande EB pour obtenir des instructions sur la création et l'utilisation d'un environnement Elastic Beanstalk.

Utilisation d'un fichier .ebignore pour ignorer des fichiers

Vous pouvez donner instruction à l'interface de ligne de commande EB d'ignorer certains fichiers du répertoire de votre projet en ajoutant le fichier .ebignore au répertoire. Ce fichier fonctionne comme un fichier .gitignore. Lorsque vous déployez le répertoire de votre projet dans Elastic Beanstalk et que vous créez une nouvelle version d'application, l'interface de ligne de commande EB n'inclut pas les fichiers spécifiés par .ebignore dans le bundle source qu'elle crée.

Si .ebignore n'est pas présent, mais qu'il existe .gitignore, l'interface de ligne de commande EB ignore les fichiers spécifiés dans .gitignore. Si .ebignore est présent, l'interface de ligne de commande EB ne lit pas .gitignore.

Quand .ebignore est présent, l'interface de ligne de commande EB n'utilise pas de commandes 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

Dans Windows, si vous ajoutez .ebignore, l'interface de ligne de commande EB suit les liens symboliques et inclut le fichier lié lors de la création d'un bundle de fichiers source. Il s'agit d'un problème connu, qui sera corrigé lors d'une future mise à jour.

Utilisation de profils nommés

Si vous stockez vos informations d'identification sous la forme d'un profil nommé dans un fichier credentials ou config, vous pouvez utiliser l'option --profile pour spécifier explicitement un profil. Par exemple, la commande suivante crée une nouvelle application à l'aide du profil user2.

$ eb init --profile user2

Vous pouvez également modifier le profil par défaut en définissant la variable d'environnement AWS_EB_PROFILE. Lorsque cette variable est définie, l'interface de ligne de commande EB lit les informations d'identification à partir du profil spécifié au lieu de default ou eb-cli.

Linux, macOS ou Unix

$ export AWS_EB_PROFILE=user2

Windows

> set AWS_EB_PROFILE=user2

Déploiement d'un artefact à la place du dossier de projet

Vous pouvez demander à l'interface de ligne de commande EB de déployer un fichier ZIP ou WAR que vous générez dans le cadre d'un processus de création distinct en ajoutant les lignes suivantes à .elasticbeanstalk/config.yml dans votre dossier de projet.

deploy:
  artifact: path/to/buildartifact.zip

Si vous configurez l'interface de ligne de commande EB dans votre référentiel Git, et ne validez pas l'artefact dans la source, utilisez l'option --staged pour déployer la version la plus récente.

~/eb$ eb deploy --staged

Configuration des paramètres et des priorités

L'interface de ligne de commande EB utilise une chaîne fournisseur pour rechercher les informations d'identification AWS dans un certain nombre d'emplacements différents, y compris les variables d'environnement système ou utilisateur et les fichiers de configuration locaux AWS.

L'interface de ligne de commande EB recherche les informations d'identification et les paramètres de configuration dans l'ordre suivant :

1. Options de ligne de commande – Spécifiez un profil nommé avec --profile pour remplacer les paramètres par défaut.

2. Variables d'environnement – AWS_ACCESS_KEY_ID et AWS_SECRET_ACCESS_KEY.

3. Fichier d'informations d'identification AWS – Situé dans ~/.aws/credentials sous Linux et OS X, ou dans C:\Users\USERNAME\.aws\credentials sous Windows. Ce fichier peut contenir plusieurs profils nommés en plus d'un profil par défaut.

4. Fichier de configuration de l'AWS CLI – situé dans ~/.aws/config sous Linux et OS X ou dans C:\Users\USERNAME\.aws\config sous Windows. Ce fichier peut contenir un profil par défaut, des profils nommés, ainsi que des paramètres de configuration spécifiques à uneAWS CLI pour chacun.

5. Fichier de configuration existant de l'interface de ligne de commande EB – Situé dans ~/.elasticbeanstalk/config sous Linux et OS X ou dans C:\Users\USERNAME\.elasticbeanstalk\config sous Windows.

6. Informations d'identification du profil d'instance – Ces informations d'identification peuvent être utilisées sur les instances Amazon EC2 avec un rôle d'instance attribué et elles sont fournies via le service de métadonnées Amazon EC2. Le profil d'instance doit avoir l'autorisation d'utiliser Elastic Beanstalk.

Si le fichier d'informations d'identification contient un profil nommé « eb-cli », l'interface de ligne de commande EB le privilégie par rapport au profil par défaut. Si aucun profil n'est trouvé, ou si le profil trouvé n'est pas autorisé à utiliser –, l'interface de ligne de commande EB vous invite à saisir les clés.

Métadonnées de l'instance

Pour utiliser l'interface de ligne de commande EB à partir d'une instance Amazon EC2, créez un rôle ayant accès aux ressources nécessaires et attribuez ce rôle à l'instance lorsqu'elle est lancée. Lancez l'instance et installez l'interface de ligne de commande EB avec pip.

~$ sudo pip install awsebcli

pip est pré-installé sur Amazon Linux.

L'interface de ligne de commande EB lit les informations d'identification à partir des métadonnées de l'instance. Pour de plus amples informations, veuillez consulter Octroi d'autorisations d'accès aux ressources AWS pour les applications qui s'exécutent sur des instances Amazon EC2 dans le Guide de l'utilisateur IAM.