Konfigurieren der EB CLI

Nach der Installation der EB CLI können Sie Ihr Projektverzeichnis und EB CLI konfigurieren, indem Sie eb init ausführen.

Das folgende Beispiel zeigt die Konfigurationsschritte, wenn eb init zum ersten Mal in einem Projektordner mit dem Namen eb ausgeführt wird.

So initialisieren Sie ein EB CLI-Projekt

1. Zunächst werden Sie von der EB CLI aufgefordert, eine Region auszuwählen. Geben Sie die Zahl für die Region ein, die Sie verwenden möchten, und drücken Sie dann die Eingabetaste.

   ~/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. Geben Sie dann Ihren Zugriffsschlüssel und geheimen Schlüssel an, sodass die EB CLI Ressourcen für Sie verwalten kann. Zugriffsschlüssel werden in der AWS Identity and Access Management Konsole erstellt. Wenn Sie keine Schlüssel haben, finden Sie weitere Informationen unter Wie erhalte ich Sicherheitsanmeldeinformationen? im Allgemeine Amazon Web Services-Referenz.

   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. Eine Anwendung in Elastic Beanstalk ist eine Ressource mit einer Reihe von Anwendungsversionen (Quelle), Umgebungen und gespeicherten Konfigurationen, die einer einzelnen Webanwendung zugeordnet sind. Jedes Mal, wenn Sie Ihren Quellcode mit der EB CLI in Elastic Beanstalk bereitstellen, wird eine neue Anwendungsversion erstellt und der Liste hinzugefügt.

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

4. Der Standard-Anwendungsname ist der Name des Ordners, in dem Sie eb init ausführen. Geben Sie einen beliebigen Namen ein, der Ihr Projekt beschreibt.

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

5. Wählen Sie eine Plattform, die mit der Sprache oder dem Framework, in der bzw. in dem Ihre Webanwendung entwickelt wurde, übereinstimmt. Wenn Sie noch keine Anwendung entwickelt haben, wählen Sie eine Plattform, die Sie interessiert. Wir zeigen Ihnen in Kürze, wie Sie eine Beispielanwendung starten. Sie können diese Einstellung zu einem späteren Zeitpunkt jederzeit ändern.

   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. Wählen Sie Yes (Ja), um den Instances in Ihrer Elastic Beanstalk-Umgebung ein SSH-Schlüsselpaar zuzuweisen. Auf diese Weise können Sie eine direkte Verbindung für die Fehlerbehebung herstellen.

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

7. Wählen Sie ein vorhandenes Schlüsselpaar oder erstellen Sie ein neues. Damit mit eb init ein neues Schlüsselpaar erstellt werden kann, müssen Sie ssh-keygen auf Ihrem lokalen Computer installiert haben und über die Befehlszeile darauf zugreifen können. Die EB CLI registriert das neue key pair EC2 für Sie bei Amazon und speichert den privaten Schlüssel lokal in einem Ordner mit dem Namen .ssh in Ihrem Benutzerverzeichnis.

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

Ihre EB CLI-Installation ist nun konfiguriert und einsatzbereit. Anweisungen zum Erstellen und Verwenden von Elastic Beanstalk-Umgebungen finden Sie unter Elastic Beanstalk-Umgebungen mit der EB CLI verwalten.

Ignorieren von Dateien, die .ebignore verwenden

Sie können die EB CLI anweisen, bestimmte Dateien in Ihrem Projektverzeichnis zu ignorieren, indem Sie dem Verzeichnis die Datei .ebignore hinzufügen. Diese Datei funktioniert wie eine .gitignore-Datei. Bei der Bereitstellung Ihres Projektverzeichnisses für Elastic Beanstalk und der Erstellung einer neuen Anwendungsversion schließt die EB CLI keine Dateien ein, die als .ebignore im von ihr erstellten Quell-Bundle angegeben werden.

Wenn keine .ebignore vorhanden ist, jedoch eine .gitignore, ignoriert die EB CLI die Dateien, die in .gitignore angegeben sind. Wenn .ebignore vorhanden ist, liest die EB CLI .gitignore nicht.

Wenn .ebignore vorhanden ist, verwendet die EB CLI keine git-Befehle zum Erstellen Ihres Quell-Bundles. Das bedeutet, EB-CLI ignoriert die in .ebignore angegebenen Dateien und bindet alle anderen Dateien ein. Insbesondere bindet sie nicht festgeschriebene Quelldateien ein.

Anmerkung

Unter Windows bewirkt das Hinzufügen von .ebignore, dass die EB CLI symbolischen Links folgt und die verknüpfte Datei bei der Erstellung eines Quell-Bundle einschließt. Das Problem ist bekannt und wird in einem der nächsten Updates behoben.

Verwenden von benannten Profilen

Wenn Sie Ihre Anmeldeinformationen in einer credentials- oder config-Datei als benanntes Profil speichern, können Sie die --profile-Option zur expliziten Angabe eines Profils verwenden. Mit dem folgenden Befehl wird beispielsweise eine neue Anwendung mit dem user2-Profil erstellt.

$ eb init --profile user2

Sie können auch das Standard-Profil ändern, indem Sie die AWS_EB_PROFILE-Umgebungsvariable festlegen. Wenn diese Variable festgelegt ist, liest die EB CLI Anmeldeinformationen aus dem angegebenen Profil anstatt default oder eb-cli.

Linux, macOS oder Unix

$ export AWS_EB_PROFILE=user2

Windows

> set AWS_EB_PROFILE=user2

Bereitstellen eines Artefakts anstelle des Projektordners

Sie können die EB CLI anweisen, eine ZIP- oder WAR-Datei bereitzustellen, die Sie als Teil eines separaten Erstellungsprozess generieren, indem Sie die folgenden Zeilen zu .elasticbeanstalk/config.yml in Ihrem Projektordner hinzufügen.

deploy:
  artifact: path/to/buildartifact.zip

Wenn Sie die EB CLI in Ihrem Git-Repository konfigurieren und das Artifact nicht in Ihrer Quelle bereitstellen, verwenden Sie die --staged-Option zur Bereitstellung des neuesten Builds.

~/eb$ eb deploy --staged

Konfigurationseinstellungen und Vorrang

Die EB CLI verwendet eine Anbieterkette, um an verschiedenen Stellen nach AWS Anmeldeinformationen zu suchen, einschließlich System- oder Benutzerumgebungsvariablen und lokalen AWS Konfigurationsdateien.

Die EB CLI sucht in der folgenden Reihenfolge nach Anmeldeinformationen und Konfigurationseinstellungen:

1. Befehlszeilenoptionen – Geben Sie ein benanntes Profil mit --profile an, um die Standardeinstellungen zu überschreiben.

2. Umgebungsvariablen – AWS_ACCESS_KEY_ID und AWS_SECRET_ACCESS_KEY.

3. Die AWS Anmeldeinformationsdatei — Befindet sich ~/.aws/credentials auf Linux- und OS X-Systemen oder C:\Users\USERNAME\.aws\credentials unter Windows-Systemen. Diese Datei kann zusätzlich zu einem Standardprofil mehrere benannte Profile enthalten.

4. Die AWS CLI -Konfigurationsdatei – Gespeichert in ~/.aws/config auf Linux- und OS X-Systemen oder in C:\Users\USERNAME\.aws\config auf Windows-Systemen. Diese Datei kann ein Standardprofil, benannte Profile und jeweils AWS CLI spezifische Konfigurationsparameter enthalten.

5. Bestehende EB CLI-Konfigurationsdatei – Gespeichert in ~/.elasticbeanstalk/config auf Linux- und OS X-Systemen oder in C:\Users\USERNAME\.elasticbeanstalk\config auf Windows-Systemen.

6. Anmeldeinformationen für das Instance-Profil — Diese Anmeldeinformationen können auf EC2 Amazon-Instances mit einer zugewiesenen Instance-Rolle verwendet werden und werden über den EC2 Amazon-Metadatenservice bereitgestellt. Das Instance-Profil muss über die Berechtigung zur Nutzung von Elastic Beanstalk verfügen.

Wenn die Datei mit den Anmeldeinformationen ein benanntes Profil mit dem Namen "eb-cli" enthält, zieht die EB CLI dieses Profil dem Standard-Profil vor. Wenn keine Profile gefunden werden oder ein Profil gefunden wird, dieses jedoch nicht über die Berechtigung zur Nutzung von Elastic Beanstalk verfügt, fordert die EB CLI Sie auf, Schlüssel einzugeben.

Instance-Metadaten

Um die EB-CLI von einer EC2 Amazon-Instance aus zu verwenden, erstellen Sie eine Rolle, die Zugriff auf die benötigten Ressourcen hat, und weisen Sie diese Rolle der Instance zu, wenn sie gestartet wird. Starten Sie die Instance und installieren Sie die EB CLI mit pip.

~$ sudo pip install awsebcli

pip ist auf Amazon Linux vorinstalliert.

Die EB CLI liest die Anmeldeinformationen aus den Instance-Metadaten. Weitere Informationen finden Sie im IAM-Benutzerhandbuch unter Gewähren des Zugriffs auf AWS Ressourcen für Anwendungen, die auf EC2 Amazon-Instances ausgeführt werden.