View a markdown version of this page

sam init - AWS Serverless Application Model

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.

sam init

Diese Seite enthält Referenzinformationen für den AWS Serverless Application Model Befehl Command Line Interface (AWS SAMCLI)sam init.

Der sam init Befehl bietet Optionen zum Initialisieren einer neuen serverlosen Anwendung.

Usage

$ sam init <options>

Optionen

--app-template TEXT

Die ID der verwalteten Anwendungsvorlage, die Sie verwenden möchten. Wenn Sie sich nicht sicher sind, rufen Sie sam init ohne Optionen für einen interaktiven Workflow an.

Dieser Parameter ist erforderlich, wenn --no-interactive er angegeben und nicht bereitgestellt --location wird.

Dieser Parameter ist nur in AWS SAMCLI Version 0.30.0 und höher verfügbar. Die Angabe dieses Parameters mit einer früheren Version führt zu einem Fehler.

--application-insights | --no-application-insights

Aktivieren Sie die Amazon CloudWatch Application Insights-Überwachung für Ihre Anwendung. Weitere Informationen hierzu finden Sie unter Verwenden von CloudWatch Application Insights zur Überwachung Ihrer AWS SAM serverlosen Anwendungen.

Die Standardoption ist --no-application-insights.

--architecture, -a [ x86_64 | arm64 ]

Die Befehlssatzarchitektur für die Lambda-Funktionen Ihrer Anwendung. Geben Sie eines von x86_64 oder arm64 an.

--base-image [ amazon/dotnet8-base | amazon/dotnet6-base | amazon/java25-base | amazon/java21-base | amazon/java17-base | amazon/java17.al2023-base | amazon/java11-base | amazon/java11.al2023-base | amazon/java8.al2023-base | amazon/nodejs24.x-base | amazon/nodejs22.x-base | amazon/nodejs20.x-base | amazon/nodejs18.x-base | amazon/nodejs16.x-base | amazon/python3.14-base | amazon/python3.13-base | amazon/python3.12-base | amazon/python3.11-base | amazon/python3.10-base | amazon/python3.9-base | amazon/python3.8-base | amazon/ruby4.0-base | amazon/ruby3.4-base | amazon/ruby3.3-base | amazon/ruby3.2-base ]

Das Basis-Image Ihrer Anwendung. Diese Option gilt nur, wenn der Pakettyp lautetImage.

Dieser Parameter ist erforderlich, wenn er angegeben --no-interactive --package-type istImage, als angegeben --location ist und nicht angegeben ist.

--config-env TEXT

Der Umgebungsname, der die Standardparameterwerte in der zu verwendenden Konfigurationsdatei angibt. Der Standardwert ist „default“. Weitere Informationen zu Konfigurationsdateien finden Sie unter AWS SAMCLIKonfigurationsdatei.

--config-file PATH

Der Pfad und der Dateiname der Konfigurationsdatei, die die zu verwendenden Standardparameterwerte enthält. Der Standardwert ist „samconfig.toml“ im Stammverzeichnis des Projektverzeichnisses. Weitere Informationen zu Konfigurationsdateien finden Sie unter AWS SAMCLIKonfigurationsdatei.

--debug

Aktiviert die Debug-Protokollierung, um die AWS SAMCLI generierten Debug-Meldungen auszudrucken und Zeitstempel anzuzeigen.

--dependency-manager, -d [ gradle | mod | maven | bundler | npm | cli-package | pip ]

Der Abhängigkeitsmanager Ihrer Lambda-Laufzeit.

--extra-content

Überschreiben Sie alle benutzerdefinierten Parameter in der cookiecutter.json Konfiguration der Vorlage, {"customParam1": "customValue1", "customParam2":"customValue2"} z. B.

--help, -h

Zeigt diese Meldung an und beendet das Programm.

--location, -l TEXT

Der Speicherort der Vorlage oder der Anwendung (Git, Mercurial HTTP/HTTPS, .zip-Datei, Pfad).

Dieser Parameter ist erforderlich, wenn --no-interactive und --runtime--name, und nicht angegeben --app-template sind.

Für Git-Repositorys müssen Sie den Speicherort des Stammverzeichnisses des Repositorys verwenden.

Für lokale Pfade muss die Vorlage entweder im ZIP-Datei- oder https://cookiecutter.readthedocs.io/en/latest/README.html Cookiecutter-Format vorliegen.

--name, -n TEXT

Der Name Ihres Projekts, das als Verzeichnis generiert werden soll.

Dieser Parameter ist erforderlich, wenn er angegeben --no-interactive --location ist und nicht bereitgestellt wird.

--no-input

Deaktiviert die Cookiecutter-Aufforderung und akzeptiert die in der Vorlagenkonfiguration definierten vcfdefault-Werte.

--no-interactive

Deaktiviert die interaktive Aufforderung zur Eingabe von Init-Parametern und schlägt fehl, wenn erforderliche Werte fehlen.

--output-dir, -o PATH

Der Ort, an dem die initialisierte Anwendung ausgegeben wird.

--package-type [ Zip | Image ]

Der Pakettyp der Beispielanwendung. Ziperstellt ein ZIP-Dateiarchiv und Image erstellt ein Container-Image.

--runtime, -r [ dotnet8 | dotnet6 | java25 | java21 | java17 | java17.al2023 | java11 | java11.al2023 | java8.al2023 | nodejs24.x | nodejs22.x | nodejs20.x | nodejs18.x | nodejs16.x | python3.14 | python3.13 | python3.12 | python3.11 | python3.10 | python3.9 | python3.8 | ruby4.0 | ruby3.4 | ruby3.3 | ruby3.2 ]

Die Lambda-Laufzeit Ihrer Anwendung. Diese Option gilt nur, wenn der Pakettyp lautetZip.

Dieser Parameter ist erforderlich, wenn er angegeben --no-interactive --package-type istZip, als angegeben --location ist und nicht angegeben ist.

--save-params

Speichern Sie die Parameter, die Sie in der Befehlszeile angeben, in der AWS SAM Konfigurationsdatei.

--tracing | --no-tracing

Aktivieren Sie das AWS X-Ray Tracing für Ihre Lambda-Funktionen.

Beispiel

Ein detailliertes Beispiel und eine ausführliche Anleitung zur Verwendung des sam init Unterbefehls finden Sie unter. Erstellen Sie Ihre Bewerbung in AWS SAM