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
<a name="eb-cli3-configuration"></a>

Nach [der Installation der EB-CLI](eb-cli3.md#eb-cli3-install) können Sie Ihr Projektverzeichnis und die EB-CLI konfigurieren, indem Sie Folgendes **eb init** ausführen. Das folgende Beispiel zeigt die Konfigurationsschritte **eb init** bei der ersten Ausführung in einem Projektordner mit dem Namen`eb`.

**So initialisieren Sie ein EB CLI-Projekt**

1. Zunächst werden Sie von der EB CLI aufgefordert, eine Region auszuwählen. Wählen Sie Ihre bevorzugte Region.

   ```
   ~/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
   ```

1. Wenn Sie dazu aufgefordert werden, geben Sie Ihren Zugriffsschlüssel und Ihren geheimen Schlüssel ein, damit 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?](https://docs.aws.amazon.com/general/latest/gr/getting-aws-sec-creds.html) 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}}
   ```

1. Eine Elastic Beanstalk Beanstalk-Anwendung ist eine Ressource, die eine Reihe von Anwendungsversionen (Quelle), Umgebungen und gespeicherten Konfigurationen enthält, 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
   ```

1. 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.
   ```

1. 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) .NET Core on Linux
   2) .NET on Windows Server
   3) Docker
   4) Go
   5) Java
   6) Node.js
   7) PHP         <== select platform by number
   8) Packer
   9) Python
   10) Ruby
   11) Tomcat
   (make a selection):7
   ```

1. Wählen Sie einen bestimmten Plattformzweig aus.

   ```
   Select a platform branch.
   1) PHP 8.4 running on 64bit Amazon Linux 2023
   2) PHP 8.3 running on 64bit Amazon Linux 2023
   3) PHP 8.2 running on 64bit Amazon Linux 2023
   4) PHP 8.1 running on 64bit Amazon Linux 2023
   5) PHP 8.1 running on 64bit Amazon Linux 2
   (default is 1):1
   ```

1. 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
   ```

1. 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.

**Topics**
+ [Ignorieren von Dateien, die .ebignore verwenden](#eb-cli3-ebignore)
+ [Verwenden von benannten Profilen](#eb-cli3-profile)
+ [Bereitstellen eines Artefakts anstelle des Projektordners](#eb-cli3-artifact)
+ [Konfigurationseinstellungen und Vorrang](#eb-cli3-credentials)
+ [Instance-Metadaten](#eb-cli3-metadata)

## Ignorieren von Dateien, die .ebignore verwenden
<a name="eb-cli3-ebignore"></a>

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
<a name="eb-cli3-profile"></a>

Wenn Sie Ihre Anmeldeinformationen in einer `credentials`- oder `config`-Datei als benanntes Profil speichern, können Sie die [`--profile`](eb3-cmd-options.md)-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
<a name="eb-cli3-artifact"></a>

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](eb3-cli-git.md) 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
<a name="eb-cli3-credentials"></a>

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.

1. **Umgebungsvariablen** – `AWS_ACCESS_KEY_ID` und `AWS_SECRET_ACCESS_KEY`.

1. **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.

1. **Die [AWS CLI -Konfigurationsdatei](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html#cli-config-files)** – 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](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html#cli-multiple-profiles) und jeweils AWS CLI spezifische Konfigurationsparameter enthalten.

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

1. **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](concepts-roles-instance.md) 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
<a name="eb-cli3-metadata"></a>

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](https://docs.aws.amazon.com/IAM/latest/UserGuide/role-usecase-ec2app.html) werden.