Utilisation de l'interface de ligne de commande EB avec AWS CodeCommit - AWS Elastic Beanstalk
PrérequisCréation d'un CodeCommit référentiel avec l'interface de ligne de commande EBDéploiement à partir de votre CodeCommit référentielConfiguration de branches et environnements supplémentairesUtilisation d'un CodeCommit référentiel existant

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Utilisation de l'interface de ligne de commande EB avec AWS CodeCommit

Vous pouvez utiliser l'interface de ligne de commande EB pour déployer votre application directement depuis votre AWS CodeCommit référentiel. Vous pouvez ainsi télécharger uniquement vos modifications dans le référentiel lors du déploiement, au lieu de télécharger l'intégralité de votre projet. CodeCommit Vous économisez ainsi du temps et de la bande passante si vous avez un vaste projet ou une connexion Internet limitée. L'interface de ligne de commande EB effectue une transmission de type push de vos validations locales et les emploie pour créer les versions de l'application lorsque vous utilisez eb appversion, eb create ou eb deploy.

Pour déployer vos modifications, CodeCommit l'intégration nécessite que vous les validiez d'abord. Cependant, lorsque vous développez ou déboguez, vous pouvez ne pas vouloir pousser les modifications que vous n'avez pas confirmées comme opérationnelles. Vous pouvez éviter de valider vos modifications en les définissant comme intermédiaires et en utilisant eb deploy --staged (qui effectue un déploiement standard). Ou validez d'abord vos modifications sur une branche de développement ou de test, puis fusionnez-les avec votre branche principale uniquement lorsque votre code est prêt. Avec eb use, vous pouvez configurer l'interface de ligne de commande EB pour déployer vers un environnement de votre branche de développement et vers un autre environnement de votre branche principale.

Note

Certaines régions n'en proposent pas CodeCommit. L'intégration entre Elastic CodeCommit Beanstalk et Elastic ne fonctionne pas dans ces régions.

Pour plus d'informations sur les AWS services offerts dans chaque région, consultez le tableau des régions.

Prérequis

Pour l'utiliser CodeCommit AWS Elastic Beanstalk, vous avez besoin d'un dépôt Git local (que vous possédez déjà ou que vous en créez un nouveau) avec au moins un commit, une autorisation d'utilisation CodeCommit et un environnement Elastic Beanstalk dans une région compatible. CodeCommit Votre environnement et votre référentiel doivent être dans la même région.

Pour initialiser un référentiel Git

  1. Exécutez git init dans votre dossier de projet.

    ~/my-app$ git init

  2. Organisez vos fichiers de projet avec git add.

    ~/my-app$ git add .

  3. Validez les modifications avec git commit.

    ~/my-app$ git commit -m "Elastic Beanstalk application"

Création d'un CodeCommit référentiel avec l'interface de ligne de commande EB

Pour commencer CodeCommit, courez eb init. Lors de la configuration du référentiel, l'interface de ligne de commande EB vous invite CodeCommit à l'utiliser pour stocker votre code et accélérer les déploiements. Même si vous avez déjà configuré votre projet aveceb init, vous pouvez le réexécuter pour le configurer CodeCommit.

Pour créer un CodeCommit référentiel à l'aide de l'interface de ligne de commande EB

  1. Exécutez eb init dans votre dossier de projet. Lors de la configuration, l'interface de ligne de commande EB vous demande si vous CodeCommit souhaitez l'utiliser pour stocker votre code et accélérer les déploiements. Si vous avez déjà configuré votre projet aveceb init, vous pouvez toujours le réexécuter pour le configurer CodeCommit. Tapez le texte y à l'invite pour le configurer CodeCommit.

    ~/my-app$ eb init
Note: Elastic Beanstalk now supports AWS CodeCommit; a fully-managed source control service. To learn more, see Docs: https://aws.amazon.com/codecommit/
Do you wish to continue with CodeCommit? (y/n)(default is n): y

  2. Choisissez Create new Repository (Créer un nouveau référentiel).

    Select a repository
1) my-repo
2) [ Create new Repository ]
(default is 2): 2

  3. Tapez un nom de référentiel ou appuyez sur Entrée pour accepter le nom par défaut.

    Enter Repository Name
(default is "codecommit-origin"): my-app
Successfully created repository: my-app

  4. Sélectionnez une branche existante pour vos validations ou utilisez l'interface de ligne de commande EB pour créer une nouvelle branche.

    Enter Branch Name
***** Must have at least one commit to create a new branch with CodeCommit *****
(default is "mainline"): ENTER
Successfully created branch: mainline

Déploiement à partir de votre CodeCommit référentiel

Lorsque vous configurez CodeCommit avec votre référentiel EB CLI, l'EB CLI utilise le contenu du référentiel pour créer des ensembles de sources. Lorsque vous exécutez eb deploy oueb create, l'EB CLI envoie de nouveaux commits et utilise la révision HEAD de votre branche pour créer l'archive qu'elle déploie sur les EC2 instances de votre environnement.

Pour utiliser l' CodeCommit intégration avec l'interface de ligne de commande EB

  1. Créez un nouvel environnement avec eb create.

    ~/my-app$ eb create my-app-env
Starting environment deployment via CodeCommit
--- Waiting for application versions to be pre-processed ---
Finished processing application version app-ac1ea-161010_201918
Setting up default branch
Environment details for: my-app-env
  Application name: my-app
  Region: us-east-2
  Deployed Version: app-ac1ea-161010_201918
  Environment ID: e-pm5mvvkfnd
  Platform: 64bit Amazon Linux 2016.03 v2.1.6 running Java 8
  Tier: WebServer-Standard
  CNAME: UNKNOWN
  Updated: 2016-10-10 20:20:29.725000+00:00
Printing Status:
INFO: createEnvironment is starting.
...

    L'interface de ligne de commande EB utilise la dernière validation de la branche suivie pour créer la version de l'application déployée dans l'environnement.

  2. Lorsque vous avez de nouvelles validations locales, utilisez eb deploy pour pousser les validations et les déployer dans votre environnement.

    ~/my-app$ eb deploy
Starting environment deployment via CodeCommit
INFO: Environment update is starting.
INFO: Deploying new version to instance(s).
INFO: New application version was deployed to running EC2 instances.
INFO: Environment update completed successfully.

  3. Pour tester les modifications avant de les valider, utilisez l'option --staged pour déployer les modifications que vous avez ajoutées à la zone intermédiaire avec git add.

    ~/my-app$ git add new-file
~/my-app$ eb deploy --staged

    Le déploiement avec l'option --staged effectue un déploiement standard, qui ignore CodeCommit.

Configuration de branches et environnements supplémentaires

CodeCommit la configuration s'applique à une seule branche. Vous pouvez utiliser eb use et eb codesource pour configurer des branches supplémentaires ou modifier la configuration de la branche actuelle.

Pour configurer CodeCommit l'intégration avec l'interface de ligne de commande EB

  1. Pour modifier la branche distante, utilisez l'option eb use de la commande --source.

    ~/my-app$ eb use test-env --source my-app/test

  2. Pour créer une nouvelle branche et un nouvel environnement, recherchez une nouvelle branche, envoyez-la CodeCommit, créez l'environnement, puis utilisez-le eb use pour connecter la branche locale, la branche distante et l'environnement.

    ~/my-app$ git checkout -b production
~/my-app$ git push --set-upstream production
~/my-app$ eb create production-env
~/my-app$ eb use --source my-app/production production-env

  3. Pour effectuer une configuration CodeCommit interactive, utilisez eb codesource codecommit.

    ~/my-app$ eb codesource codecommit
Current CodeCommit setup:
  Repository: my-app
  Branch: test
Do you wish to continue (y/n): y

Select a repository
1) my-repo
2) my-app
3) [ Create new Repository ]
(default is 2): 2

Select a branch
1) mainline
2) test
3) [ Create new Branch with local HEAD ]
(default is 1): 1

  4. Pour désactiver CodeCommit l'intégration, utilisez eb codesource local.

    ~/my-app$ eb codesource local
Current CodeCommit setup:
  Repository: my-app
  Branch: mainline
Default set to use local sources

Utilisation d'un CodeCommit référentiel existant

Si vous possédez déjà un CodeCommit dépôt et que vous souhaitez l'utiliser avec Elastic Beanstalkeb init, exécutez-le à la racine de votre dépôt Git local.

Pour utiliser un CodeCommit référentiel existant avec l'interface de ligne de commande EB

  1. Clonez votre CodeCommit dépôt.

    ~$ git clone ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/my-app

  2. Extrayez et transmettez une branche à utiliser pour votre environnement Elastic Beanstalk.

    ~/my-app$ git checkout -b dev-env
~/my-app$ git push --set-upstream origin dev-env

  3. Exécutez eb init. Sélectionnez les mêmes région, référentiel et nom de branche que ceux que vous utilisez actuellement.

    ~/my-app$ 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): 1
...
Note: Elastic Beanstalk now supports AWS CodeCommit; a fully-managed source control service. To learn more, see Docs: https://aws.amazon.com/codecommit/
Do you wish to continue with CodeCommit? (y/n)(default is n): y

Select a repository
1) my-app
2) [ Create new Repository ]
(default is 1): 1

Select a branch
1) mainline
2) dev-env
3) [ Create new Branch with local HEAD ]
(default is 2): 2

Pour plus d'informations sur l'utilisation de eb init, consultez Configuration de l'interface de ligne de commande EB.