Verwenden der EB CLI mit Git

Die EB CLI bietet Integration in Git. In diesem Abschnitt finden Sie eine Übersicht über die Verwendung von Git mit der EB CLI.

So installieren Sie Git und initialisieren Ihr Git-Repository

1. Laden Sie die neueste Version von Git unter http://git-scm.com herunter.

2. Initialisieren Sie Ihr Git-Repository, indem Sie den folgenden Befehl eingeben:

   ~/eb$ git init

   EB CLI wird nun erkennen, dass Ihre Anwendung mit Git eingerichtet wurde.

3. Wenn Sie eb init noch nicht ausgeführt haben, tun Sie dies jetzt:

   ~/eb$ eb init

Zuordnen von Git-Verzweigungen zu Elastic Beanstalk-Umgebungen

Sie können jede Verzweigung Ihres Codes einer anderen Umgebung zuordnen. Wenn Sie eine Verzweigung abschließen, werden Änderungen für die zugeordnete Umgebung bereitgestellt. Sie können beispielsweise Folgendes eingeben, um Ihre Produktionsumgebung Ihrem Mainline-Zweig, und eine separate Entwicklungsumgebung Ihrer Entwicklungsverzweigung zuzuordnen:

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

Bereitstellen von Änderungen

Standardmäßig stellt die EB CLI den neuesten Commit in der aktuellen Verzweigung bereit, wobei die Commit-ID und Nachricht als die Bezeichnung bzw. Beschreibung der Anwendungsversion verwendet wird. Wenn Sie ohne Commit in Ihrer Umgebung bereitstellen möchten, können Sie die --staged-Option verwenden, um Änderungen bereitzustellen, die zum Staging-Bereich hinzugefügt wurden.

So stellen Sie Änderungen ohne Commit bereit

1. Fügen Sie neue und geänderte Dateien zum Staging-Bereich hinzu:

   ~/eb$ git add .

2. Bereitstellen von zwischengespeicherten Änderungen mit eb deploy:

   ~/eb$ eb deploy --staged

Wenn Sie die EB CLI so konfiguriert haben, dass ein Artefakt bereitgestellt wird, und Sie das Artefakt nicht in Ihrem git-Repository bereitstellen, verwenden Sie die --staged-Option zur Bereitstellung des neuesten Builds.

Verwenden von Git-Submodulen

Einige Code-Projekte profitieren davon, dass sie Git-Submodul-Repositorys innerhalb des Top-Level-Repository haben. Wenn Sie Ihren Code mithilfe von eb create oder eb deploy bereitstellen, kann die EB CLI Submodule in die ZIP-Datei der Anwendungsversion einfügen und sie mit den Rest des Codes hochladen.

Sie können die Einbeziehung von Submodulen kontrollieren, indem Sie die Option include_git_submodules im Abschnitt global der EB CLI-Konfigurationsdatei .elasticbeanstalk/config.yml in Ihrem Projektordner verwenden.

Um die Submodule einzubeziehen, legen Sie diese Option auf true fest:

global:
  include_git_submodules: true

Wenn die Option include_git_submodules fehlt oder auf false festgelegt ist, bezieht EB CLI keine Submodule in die hochgeladene ZIP-Datei ein.

Weitere Informationen über Git-Submodule finden Sie unter Git Tools - Submodules.

Standardverhalten

Wenn Sie eb init zum Konfigurieren Ihres Projekts ausführen, fügt die EB CLI die Option include_git_submodules hinzu und legt sie auf true fest. Auf diese Weise wird sichergestellt, dass alle Submodule, die Sie in Ihrem Projekt haben, in Ihre Bereitstellungen einbezogen werden.

Die EB CLI hat die Einbeziehung von Submodulen nicht immer unterstützt. Um eine versehentliche und unerwünschte Änderung an vorher bereits vorhandenen Projekten zu verhindern, haben wir Submodul-Support hinzugefügt. Die EB CLI bezieht keine Submodule ein, wenn die Option include_git_submodules fehlt. Wenn Sie eines dieser vorhandenen Projekte haben und Sie Submodule in Ihren Bereitstellungen einbeziehen möchten, fügen Sie die Option hinzu und legen Sie sie auf true fest, wie in diesem Abschnitt erklärt.

CodeCommit-Verhalten

Die Integration von Elastic Beanstalk mit CodeCommit unterstützt derzeit keine Submodule. Wenn Sie Ihre Umgebung für die Integration mit CodeCommit aktiviert haben, werden Submodule nicht in Ihren Bereitstellungen einbezogen.

Zuweisen von Git-Tags zu Ihrer Anwendungsversion

Sie können ein Git-Tag als Versionsbezeichnung verwenden, um zu identifizieren, welche Anwendungsversion in Ihrer Umgebung ausgeführt wird. Geben Sie zum Beispiel Folgendes ein:

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