Konfigurieren der EB CLI - AWS Elastic Beanstalk
Ignorieren von Dateien, die .ebignore verwendenVerwenden von benannten ProfilenBereitstellen eines Artefakts anstelle des ProjektordnersKonfigurationseinstellungen und VorrangInstance-Metadaten

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

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 Schlüsselpaar für Sie mit Amazon EC2 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 mehreren Positionen – unter anderem in System- und Benutzerumgebungsvariablen sowie lokalen AWS-Konfigurationsdateien – nach AWS-Anmeldeinformationen zu suchen.

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 Datei mit den AWS-Anmeldeinformationen – Gespeichert in ~/.aws/credentials auf Linux- und OS X-Systemen oder in C:\Users\USERNAME\.aws\credentials auf 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 jeweils ein Standardprofil, benannte Profile und AWS CLI-spezifische Konfigurationsparameter umfassen.

  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. Instance-Profilanmeldeinformationen – Diese Anmeldeinformationen können in Amazon EC2-Instances mit einer zugewiesenen Instance-Rolle verwendet werden. Ihre Bereitstellung übernimmt der Amazon EC2-Metadatenservice. 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

Sie können die EB CLI aus einer Amazon EC2-Instance verwenden. Dazu erstellen Sie eine Rolle, die Zugriff auf die benötigten Ressourcen hat, und weisen die Rolle der Instance bei deren Start zu. 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 Thema zum Gewähren von Zugriff auf AWS-Ressourcen für Anwendungen, die auf Amazon EC2-Instances ausgeführt werden im IAM-Benutzerhandbuch.