Configuration de votre machine de développement pour une utilisation avec Elastic Beanstalk

Cette page vous montre comment configurer votre machine locale pour le développement d'une application AWS Elastic Beanstalk. Elle couvre la structure des dossiers, le contrôle de la source et les outils CLI.

Création d'un dossier de projet

Créez un dossier pour votre projet. Vous pouvez stocker ce dossier dans n'importe quel emplacement sur votre disque local à condition d'être autorisé à le lire et à y écrire. La création d'un dossier dans votre dossier d'utilisateur est acceptable. Si vous prévoyez de travailler sur plusieurs applications, créez vos dossiers de projet au sein d'un autre dossier nommé workspace ou projects, par exemple, pour que tout soit correctement organisé :

workspace/
|-- my-first-app
`-- my-second-app

Le contenu de votre dossier de projet varie en fonction de l'infrastructure ou du conteneur web utilisé par votre application.

Note

Évitez les dossiers et les chemins d'accès avec des apostrophes (') ou des guillemets (") dans le nom du dossier ou n'importe quel élément de chemin. Certaines commandes Elastic Beanstalk échouent lorsqu'elles sont exécutées au sein d'un dossier avec l'un de ces caractères dans le nom.

Configuration du contrôle de code source

Configurez le contrôle de code source pour vous protéger contre la suppression accidentelle de fichiers ou de code dans votre dossier de projet, et pour pouvoir annuler les modifications qui entraînent l'interruption de votre projet.

Si vous ne disposez pas d'un système de contrôle de code source, envisagez d'utiliser Git, un outil gratuit et facile à utiliser qui s'intègre parfaitement dans l'interface de ligne de commande (CLI) Elastic Beanstalk. Visitez la page d'accueil Git pour installer Git.

Suivez les instructions figurant sur le site Web de Git pour installer et configurer Git, puis exécutez git init dans votre dossier de projet afin de configurer un référentiel local :

~/workspace/my-first-app$ git init
Initialized empty Git repository in /home/local/username/workspace/my-first-app/.git/

Lorsque vous ajoutez du contenu à votre dossier de projet et mettez à jour le contenu, validez les modifications dans votre référentiel Git :

~/workspace/my-first-app$ git add default.jsp
~/workspace/my-first-app$ git commit -m "add default JSP"

Chaque fois que vous effectuez un commit (validation), vous créez un instantané de votre projet que vous pouvez restaurer par la suite en cas de problème. Pour plus d'informations sur les commandes et les processus Git, consultez la documentation Git.

Configuration d'un référentiel distant

Que se passe-t-il en cas de plantage de votre disque dur ou si vous souhaitez travailler sur votre projet à partir d'un autre ordinateur ? Pour sauvegarder votre code source en ligne et y accéder depuis n'importe quel ordinateur, configurez un référentiel distant dans lequel vous pouvez transférer vos commits.

AWS CodeCommitvous permet de créer un référentiel privé dans le cloud AWS. CodeCommit est gratuit dans l' offre gratuite AWS pour un maximum de cinq utilisateursAWS Identity and Access Management (IAM) de votre compte. Pour obtenir des informations sur la tarification, veuillez consulter la tarification relative à AWS CodeCommit.

Pour obtenir des instructions sur la configuration, veuillez consulter le Guide de l'utilisateur AWSCodeCommit.

Pour stocker votre code de projet en ligne, vous pouvez également utiliser GitHub, une autre solution très appréciée. Elle vous permet de créer gratuitement un référentiel en ligne public et elle prend également en charge les référentiels privés sur la base d'un forfait mensuel. Pour vous inscrire à GitHub, accédez à github.com.

Une fois que vous avez créé un référentiel distant pour votre projet, associez-le à votre référentiel local via git remote add :

~/workspace/my-first-app$ git remote add origin ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/my-repo

Installation de l'interface de ligne de commande EB

Utilisez l'interface de ligne de commande EB pour gérer vos environnements Elastic Beanstalk et surveiller leur état via la ligne de commande. Pour obtenir des instructions d'installation, consultez Installation de l'interface de ligne de commande EB.

Par défaut, l'interface de ligne de commande EB regroupe tous les éléments dans votre dossier de projet et les télécharge dans Elastic Beanstalk sous la forme d'un bundle de fichiers source. Si vous utilisez conjointement Git et l'interface de ligne de commande EB, vous pouvez éviter que les fichiers de classes générés ne soient validés dans la source grâce à .gitignore et éviter que les fichiers sources ne soient déployés grâce à .ebignore.

Vous pouvez également configurer l'interface de ligne de commande EB pour déployer un artefact de build (un fichier WAR ou ZIP) au lieu du contenu de votre dossier de projet.

Installation de l’AWS CLI

L'AWS Command Line Interface (AWS CLI) est un client unifié pour les services AWS qui fournit des commandes pour toutes les opérations d'API publiques. Ces commandes étant d'un niveau inférieur à celles fournies par l'interface de ligne de commande EB, le nombre de commandes requises pour effectuer une opération avec l'AWS CLI est généralement plus élevé. En revanche, l'AWS Command Line Interface vous permet de travailler avec n'importe quelle application ou environnement exécuté dans votre compte, sans avoir à configurer un référentiel sur votre ordinateur local. Utilisez l'AWS CLI pour créer des scripts qui simplifient ou automatisent les tâches opérationnelles.

Pour plus d'informations sur les services pris en charge et pour télécharger leAWS Command Line Interface, reportez-vous à la sectionAWS Command Line Interface.