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 AWS Serverless Application Model Befehlszeilenschnittstelle (AWS SAM CLI) sam init Befehl.

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

Wichtig

Nicht verwenden sam init mit Vorlagen aus nicht vertrauenswürdigen Quellen. Eine benutzerdefinierte Vorlage, z. B. eine, die Sie mit angeben --location, kann während der Projektgenerierung Hooks in Ihrer lokalen Umgebung ausführen.

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 an sam init ohne Optionen für einen interaktiven Arbeitsablauf.

Dieser Parameter ist erforderlich, wenn --no-interactive ist spezifiziert und --location ist nicht vorgesehen.

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

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

Aktivieren Sie 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-Ereignisfunktionen Ihrer Anwendung. Geben Sie eine der folgenden an x86_64 oder arm64.

--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/nodejs26.x-base | amazon/nodejs24.x-base | amazon/nodejs22.x-base | amazon/nodejs20.x-base | amazon/nodejs18.x-base | amazon/nodejs16.x-base | amazon/python3.15-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 Basisbild Ihrer Anwendung. Diese Option gilt nur, wenn der Pakettyp lautet Image.

Dieser Parameter ist erforderlich, wenn --no-interactive ist spezifiziert, --package-type ist spezifiziert als Image, und --location ist nicht spezifiziert.

--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 Debug-Meldungen auszudrucken, die AWS SAM CLI generiert und um 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 Vorlage cookiecutter.json Konfiguration, zum Beispiel {"customParam1": "customValue1", "customParam2":"customValue2"}.

--help, -h

Zeigt diese Nachricht 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 ist spezifiziert und --runtime, --name, und --app-template sind nicht vorgesehen.

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

Für lokale Pfade muss sich die Vorlage entweder in einer ZIP-Datei befinden oder Ausstecher formatieren.

--name, -n TEXT

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

Dieser Parameter ist erforderlich, wenn --no-interactive ist spezifiziert und --location ist nicht vorgesehen.

--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 [ text | json ]

Das Format der Befehlsausgabe:

  • text — Druckt normale, für Menschen lesbare Ausgaben. Dies ist der Standardwert.

  • json — Druckt eine strukturierte, maschinenlesbare Ausgabe. Verwenden Sie dieses Format, wenn Sie die Ausgabe programmgesteuert verarbeiten möchten, z. B. in CI/CD Pipelines, IDE-Erweiterungen und AI-assisted Werkzeuge.

Wenn Sie angeben --output json, der AWS SAM CLI druckt ein einzelnes JSON-Objekt, nachdem der Befehl abgeschlossen ist. Bei Erfolg enthält dieses Objekt Felder wie das Projektverzeichnis und die Vorlagendatei. Sie können die Ausgabe mit nachfolgenden Befehlen verketten, z. B. sam build. Im Fehlerfall beinhaltet es eine error Objekt, das beschreibt, was schief gelaufen ist.

Anmerkung

Das --output json Die Option ist nicht mit dem interaktiven Arbeitsablauf kompatibel. Um sie zu verwenden, geben Sie einen vollständig nicht interaktiven Lauf an, indem Sie alle erforderlichen Optionen angeben.

--output-dir, -o PATH

Der Ort, an dem die initialisierte Anwendung ausgegeben wird.

--package-type [ Zip | Image ]

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

--runtime, -r [ dotnet8 | dotnet6 | java25 | java21 | java17 | java17.al2023 | java11 | java11.al2023 | java8.al2023 | nodejs26.x | nodejs24.x | nodejs22.x | nodejs20.x | nodejs18.x | nodejs16.x | python3.15 | 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 lautet Zip.

Dieser Parameter ist erforderlich, wenn --no-interactive ist spezifiziert, --package-type ist spezifiziert als Zip, und --location ist nicht spezifiziert.

--save-params

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

--tracing | --no-tracing

aktivieren AWS X-Ray Tracing für Ihre Lambda-Funktionen.

Beispiel

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