Utilisation de l'interface de ligne de commande EB avec Git

L'interface de ligne de commande EB s'intègre dans Git. Cette section explique comment utiliser Git avec l'interface de ligne de commande EB.

Pour installer Git et initialiser votre référentiel Git

1. Téléchargez la version la plus récente de Git sur le site http://git-scm.com.

2. Initialisez votre référentiel Git en saisissant la chaîne suivante :

   ~/eb$ git init

   L'interface de ligne de commande EB reconnaît désormais que votre application est configurée avec Git.

3. Si vous n'avez pas encore exécuté eb init, faites-le maintenant :

   ~/eb$ eb init

Associer des environnements Elastic Beanstalk à des branches Git

Vous pouvez associer un environnement différent à chaque branche de votre code. Lorsque vous procédez à l'extraction d'une branche, les modifications sont déployées pour l'environnement associé. Vous pouvez par exemple saisir les informations suivantes pour associer votre environnement de production à votre branche principale, et un environnement de développement distinct à une branche de développement :

~/eb$ git checkout mainline
~/eb$ eb use prod
~/eb$ git checkout develop
~/eb$ eb use dev

Déploiement des modifications

Par défaut, l'interface de ligne de commande EB déploie la dernière validation (commit) dans la branche actuelle, en utilisant respectivement l'ID de commit et le message comme libellé de version et comme description. Si vous souhaitez effectuer un déploiement dans votre environnement sans validation, vous pouvez utiliser l'option --staged afin de déployer les modifications qui ont été ajoutées à la zone de transit.

Pour déployer les modifications sans validation

1. Ajoutez les fichiers nouveaux et modifiés à la zone de transit :

   ~/eb$ git add .

2. Déployez les modifications indexées avec eb deploy :

   ~/eb$ eb deploy --staged

Si vous avez configuré l'interface de ligne de commande EB pour déployer un artefact et que vous ne le validez pas dans le référentiel git, utilisez l'option --staged pour déployer la dernière version.

Utilisation des sous-modules Git

Certains projets de code tirent parti des sous-modules Git, des référentiels dans le référentiel de niveau supérieur. Lorsque vous déployez votre code à l'aide de eb create ou de eb deploy, l'interface de commande EB peut inclure des sous-modules dans le fichier zip de la version de l'application et les charger avec le reste du code.

Vous pouvez contrôler l'inclusion de sous-modules à l'aide de l'option include_git_submodules dans la section global du fichier de configuration de l'interface de ligne de commande EB, le fichier .elasticbeanstalk/config.yml dans votre dossier de projet.

Pour inclure des sous-modules, définissez cette option sur true :

global:
  include_git_submodules: true

Lorsque l'option include_git_submodules est manquante ou définie sur false, l'interface de ligne de commande EB n'inclut pas de sous-modules dans le fichier zip chargé.

Consultez Git Tools - Submodules pour obtenir plus d'informations sur les sous-modules Git.

Comportement par défaut

Lorsque vous exécutez eb init pour configurer votre projet, l'interface de ligne de commande EB ajoute l'option include_git_submodules et la définit sur true. De cette manière, tous les sous-modules de votre projet sont inclus dans vos déploiements.

L'interface de ligne de commande EB n'a pas toujours pris en charge l'inclusion de sous-modules. Pour éviter toute modification accidentelle ou indésirable aux projets qui existaient avant l'ajout de la prise en charge des sous-modules, l'interface de ligne de commande EB n'inclut pas les sous-modules pour lesquels l'option include_git_submodules est manquante. Si vous disposez d'un tel projet et que vous souhaitez inclure des sous-modules dans vos déploiements, ajoutez l'option et définissez-la sur true, comme expliqué dans cette section.

Comportement CodeCommit

L'intégration d'Elastic Beanstalk avec CodeCommit ne prend pas en charge les sous-modules pour le moment. Si vous avez activé votre environnement afin de l'intégrer à CodeCommit, les sous-modules ne sont pas inclus dans vos déploiements.

Affectation de balises Git à votre version de l'application

Vous pouvez utiliser une balise Git comme libellé de version afin d'identifier la version d'application en cours d'exécution dans votre environnement. Par exemple, saisissez la chaîne suivante :

~/eb$ git tag -a v1.0 -m "My version 1.0"