Konfiguration der AWS SAMCLI - AWS Serverless Application Model
So erstellen Sie Ihre Konfigurationsdatei (die samconfig Datei)Konfigurieren Sie die ProjekteinstellungenKonfigurieren Sie Anmeldeinformationen und Grundeinstellungen

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

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

In den Themen in diesem Abschnitt erfahren Sie, wie Sie Ihre Standardeinstellungen erstellen AWS SAM CLI Konfigurationsdatei und anpassen können, um die Entwicklungszeit für Ihre serverlose Anwendung zu optimieren.

So erstellen Sie Ihre Konfigurationsdatei (die samconfig Datei)

Die AWS SAMCLI Konfigurationsdatei (Dateinamesamconfig) 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 -\-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

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 SAM CLI Konfigurationsdatei

Verwenden von Konfigurationsdateien

Konfigurationsdateien sind nach Umgebung, Befehl und Parameterwert strukturiert. Weitere Informationen finden Sie unter Grundlagen der Konfigurationsdatei.

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:

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

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

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

Beispiele

Einfaches TOML Beispiel

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

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

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:

Anweisungen zur schnellen Einrichtung finden Sie unterSchritt 5: Verwenden Sie die AWS CLI , um die AWS Anmeldeinformationen zu konfigurieren.