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.

# Konfiguration der AWS SAMCLI
<a name="using-sam-cli-configure"></a>

Einer der Vorteile von AWS SAM besteht darin, dass die Zeit eines Entwicklers optimiert wird, indem sich wiederholende Aufgaben entfallen. AWS SAMCLIenthält eine nach diesem `samconfig` Zweck benannte Konfigurationsdatei. Standardmäßig AWS SAMCLI ist keine Konfiguration für erforderlich, aber Sie können Ihre Konfigurationsdatei aktualisieren, damit Sie Befehle mit weniger Parametern ausführen können, indem AWS SAM Sie stattdessen Ihre benutzerdefinierten Parameter in Ihrer Konfigurationsdatei referenzieren. Die Beispiele in der folgenden Tabelle zeigen, wie Sie Ihre Befehle optimieren können:


| Original | Optimiert mit `samconfig` | 
| --- | --- | 
| **sam build --cached --parallel --use-containers** | **sam build** | 
| **sam local invoke --env-vars locals.json** | **sam local invoke** | 
| **sam local start-api --env-vars locals.json --warm-containers EAGER** | **sam local start-api** | 

Das AWS SAMCLI bietet eine Reihe von Befehlen, mit denen Entwickler serverlose Anwendungen erstellen, entwickeln und bereitstellen können. Jeder dieser Befehle ist mit optionalen Flags konfigurierbar, die auf den Einstellungen der Anwendung und des Entwicklers basieren. Weitere Informationen finden Sie im [AWS SAMCLIInhalt in GitHub](https://github.com/aws/aws-sam-cli)

In den Themen in diesem Abschnitt erfahren Sie, wie Sie Ihre Standardeinstellungen erstellen [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md) und anpassen können, um die Entwicklungszeit für Ihre serverlose Anwendung zu optimieren.

**Topics**
+ [

## So erstellen Sie Ihre Konfigurationsdatei (die `samconfig` Datei)
](#using-sam-cli-configure-create)
+ [

## Konfigurieren Sie die Projekteinstellungen
](#using-sam-cli-configure-project)
+ [

## Konfigurieren Sie Anmeldeinformationen und Grundeinstellungen
](#using-sam-cli-configure-basic)

## So erstellen Sie Ihre Konfigurationsdatei (die `samconfig` Datei)
<a name="using-sam-cli-configure-create"></a>

Die AWS SAMCLI Konfigurationsdatei (Dateiname`samconfig`) ist eine Textdatei, die normalerweise die TOML-Struktur verwendet, aber auch in YAML sein kann. Wenn Sie eine AWS Schnellstartvorlage verwenden, wird diese Datei erstellt, wenn Sie den **sam init** Befehl ausführen. Sie können diese Datei aktualisieren, wenn Sie eine Anwendung mithilfe des **sam deploy -\$1-guided** Befehls bereitstellen.

Nach Abschluss der Bereitstellung enthält die `samconfig` Datei ein Profil mit dem Namen, `default` ob Sie die Standardwerte verwendet haben. Wenn Sie den **deploy** Befehl erneut ausführen, werden AWS SAM die gespeicherten Konfigurationseinstellungen aus diesem Profil übernommen.

Der Vorteil der `samconfig` Datei besteht darin, dass sie die Konfigurationseinstellungen für alle anderen Befehle AWS SAM speichert, die zusätzlich zum Befehl deploy verfügbar sind. Neben diesen Werten, die bei einer neuen Bereitstellung erstellt werden, gibt es eine Reihe von Attributen, die Sie in der `samconfig` Datei festlegen können, um andere Aspekte des Entwickler-Workflows zu vereinfachen AWS SAMCLI.

## Konfigurieren Sie die Projekteinstellungen
<a name="using-sam-cli-configure-project"></a>

Sie können projektspezifische Einstellungen, wie z. B. AWS SAMCLI Befehlsparameterwerte, in einer Konfigurationsdatei angeben, um sie mit dem zu verwenden. AWS SAMCLI Weitere Informationen zu dieser Konfigurationsdatei finden Sie unter. [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md)

### Verwenden von Konfigurationsdateien
<a name="using-sam-cli-configure-project-using"></a>

Konfigurationsdateien sind nach Umgebung, Befehl und Parameterwert strukturiert. Weitere Informationen finden Sie unter [Grundlagen der Konfigurationsdatei](serverless-sam-cli-config.md#serverless-sam-cli-config-basics).

**Um eine neue Umgebung zu konfigurieren**

1. Geben Sie Ihre neue Umgebung in Ihrer Konfigurationsdatei an.

   Im Folgenden finden Sie ein Beispiel für die Angabe einer neuen `prod` Umgebung:

------
#### [ TOML ]

   ```
   [prod.global.parameters]
   ```

------
#### [ YAML ]

   ```
   prod:
     global:
       parameters:
   ```

------

1. Geben Sie Parameterwerte als Schlüssel-Wert-Paare im Parameterbereich der Konfigurationsdatei an.

   Im Folgenden finden Sie ein Beispiel für die Angabe des Stack-Namens Ihrer Anwendung für die `prod` Umgebung.

------
#### [ TOML ]

   ```
   [prod.global.parameters]
   stack_name = "prod-app"
   ```

------
#### [ YAML ]

   ```
   prod:
     global:
       parameters:
         stack_name: prod-app
   ```

------

1. Verwenden Sie die `--config-env` Option, um die zu verwendende Umgebung anzugeben.

   Im Folgenden wird ein Beispiel gezeigt:

   ```
   $ sam deploy --config-env "prod"
   ```

**Um Parameterwerte zu konfigurieren**

1. Geben Sie den AWS SAMCLI Befehl an, für den Sie Parameterwerte konfigurieren möchten. Verwenden Sie den `global` Bezeichner, um Parameterwerte für alle AWS SAMCLI Befehle zu konfigurieren.

   Im Folgenden finden Sie ein Beispiel für die Angabe von Parameterwerten für den `sam deploy` Befehl der `default` Umgebung:

------
#### [ TOML ]

   ```
   [default.deploy.parameters]
   confirm_changeset = true
   ```

------
#### [ YAML ]

   ```
   default:
     deploy:
       parameters:
         confirm_changeset: true
   ```

------

   Das Folgende ist ein Beispiel für die Angabe von Parameterwerten für alle AWS SAMCLI Befehle in der `default` Umgebung:

------
#### [ TOML ]

   ```
   [default.global.parameters]
   stack_name = "sam-app"
   ```

------
#### [ YAML ]

   ```
   default:
     global:
       parameters:
         stack_name: sam-app
   ```

------

1. Sie können auch Parameterwerte angeben und Ihre Konfigurationsdatei über den AWS SAMCLI interaktiven Ablauf ändern.

   Im Folgenden finden Sie ein Beispiel für den `sam deploy --guided` interaktiven Ablauf:

   ```
   $ sam deploy --guided
   
   Configuring SAM deploy
   ======================
   
       Looking for config file [samconfig.toml] :  Found
       Reading default arguments  :  Success
   
       Setting default arguments for 'sam deploy'
       =========================================
       Stack Name [sam-app]: ENTER
       AWS Region [us-west-2]: ENTER
       #Shows you resources changes to be deployed and require a 'Y' to initiate deploy
       Confirm changes before deploy [Y/n]: n
       #SAM needs permission to be able to create roles to connect to the resources in your template
       Allow SAM CLI IAM role creation [Y/n]: ENTER
       #Preserves the state of previously provisioned resources when an operation fails
       Disable rollback [y/N]: ENTER
       HelloWorldFunction may not have authorization defined, Is this okay? [y/N]: y
       Save arguments to configuration file [Y/n]: ENTER
       SAM configuration file [samconfig.toml]: ENTER
       SAM configuration environment [default]: ENTER
   ```

Weitere Informationen finden Sie unter [Konfigurationsdateien erstellen und ändern](serverless-sam-cli-config.md#serverless-sam-cli-config-using).

### Beispiele
<a name="using-sam-cli-configure-project-examples"></a>

#### Einfaches TOML Beispiel
<a name="using-sam-cli-configure-project-examples-toml"></a>

Das Folgende ist ein Beispiel für eine `samconfig.toml` Konfigurationsdatei:

```
...
version = 0.1

[default]
[default.global]
[default.global.parameters]
stack_name = "sam-app"

[default.build.parameters]
cached = true
parallel = true

[default.deploy.parameters]
capabilities = "CAPABILITY_IAM"
confirm_changeset = true
resolve_s3 = true

[default.sync.parameters]
watch = true

[default.local_start_api.parameters]
warm_containers = "EAGER"

[prod]
[prod.sync]
[prod.sync.parameters]
watch = false
```

#### Einfaches YAML Beispiel
<a name="using-sam-cli-configure-project-examples-yaml"></a>

Das Folgende ist ein Beispiel für eine `samconfig.yaml` Konfigurationsdatei:

```
version 0.1
default:
  global:
    parameters:
      stack_name: sam-app
  build:
    parameters:
      cached: true
      parallel: true
  deploy:
    parameters:
      capabilities: CAPABILITY_IAM
      confirm_changeset: true
      resolve_s3: true
  sync:
    parameters:
      watch: true
  local_start_api:
    parameters:
      warm_containers: EAGER
prod:
  sync:
    parameters:
      watch: false
```

## Konfigurieren Sie Anmeldeinformationen und Grundeinstellungen
<a name="using-sam-cli-configure-basic"></a>

Verwenden Sie AWS Command Line Interface (AWS CLI), um grundlegende Einstellungen wie AWS Anmeldeinformationen, den Namen der Standardregion und das Standardausgabeformat zu konfigurieren. Nach der Konfiguration können Sie diese Einstellungen mit dem verwenden AWS SAMCLI. Weitere Informationen finden Sie im *AWS Command Line Interface Benutzerhandbuch* im Folgenden:
+ [Grundlagen der Konfiguration](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html)
+ [Einstellungen für die Konfiguration und die Anmeldeinformationsdatei](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html)
+ [Benannte Profile für AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html)
+ [Verwendung eines für IAM Identity Center aktivierten benannten Profils](https://docs.aws.amazon.com/cli/latest/userguide/sso-using-profile.html)

Anweisungen zur schnellen Einrichtung finden Sie unter[Schritt 5: Verwenden Sie die AWS CLI , um die AWS Anmeldeinformationen zu konfigurieren](prerequisites.md#prerequisites-configure-credentials).