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.
-
Für eine Einführung in die AWS SAM CLI, siehe Was ist der AWS SAM CLI?
-
Eine Dokumentation zur Verwendung des AWS SAM CLI
sam initBefehl, siehe Erstellen Sie Ihre Bewerbung in AWS SAM.
Das sam init Der Befehl bietet Optionen zum Initialisieren einer neuen serverlosen Anwendung.
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-templateTEXT-
Die ID der verwalteten Anwendungsvorlage, die Sie verwenden möchten. Wenn Sie sich nicht sicher sind, rufen Sie an
sam initohne Optionen für einen interaktiven Arbeitsablauf.Dieser Parameter ist erforderlich, wenn
--no-interactiveist spezifiziert und--locationist 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_64oderarm64. --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-interactiveist spezifiziert,--package-typeist spezifiziert alsImage, und--locationist nicht spezifiziert. --config-envTEXT-
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-filePATH-
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.jsonKonfiguration, zum Beispiel{"customParam1": "customValue1", "customParam2":"customValue2"}. --help, -h-
Zeigt diese Nachricht an und beendet das Programm.
--location, -lTEXT-
Der Speicherort der Vorlage oder der Anwendung (Git, Mercurial, HTTP/HTTPS, .zip-Datei, Pfad).
Dieser Parameter ist erforderlich, wenn
--no-interactiveist spezifiziert und--runtime,--name, und--app-templatesind 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, -nTEXT-
Der Name Ihres Projekts, das als Verzeichnis generiert werden soll.
Dieser Parameter ist erforderlich, wenn
--no-interactiveist spezifiziert und--locationist 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 eineerrorObjekt, das beschreibt, was schief gelaufen ist.AnmerkungDas
--output jsonDie 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, -oPATH-
Der Ort, an dem die initialisierte Anwendung ausgegeben wird.
--package-type[ Zip | Image ]-
Der Pakettyp der Beispielanwendung.
Ziperstellt ein ZIP-Dateiarchiv undImageerstellt 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-interactiveist spezifiziert,--package-typeist spezifiziert alsZip, und--locationist 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.