Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
sam init
Questa pagina fornisce informazioni di riferimento per AWS Serverless Application Model Interfaccia a riga di comando (AWS SAM CLI) sam init comando.
-
Per un'introduzione al AWS SAM CLI, vedi Che cos'è il AWS SAM CLI?
-
Per la documentazione sull'uso di AWS SAM CLI
sam initcomando, vedere Crea la tua candidatura in AWS SAM.
Il sam init Il comando fornisce opzioni per inizializzare una nuova applicazione serverless.
Non usare sam init con modelli provenienti da fonti non attendibili. Un modello personalizzato, ad esempio quello specificato con --location, può eseguire hook nell'ambiente locale durante la generazione del progetto.
Utilizzo
$sam init<options>
Opzioni
--app-templateTEXT-
L'identificatore del modello di applicazione gestita che si desidera utilizzare. Se non sei sicuro, chiama
sam initsenza opzioni per un flusso di lavoro interattivo.Questo parametro è obbligatorio se
--no-interactiveè specificato e--locationnon è fornito.Questo parametro è disponibile solo in AWS SAM CLI versione 0.30.0 e successive. La specificazione di questo parametro con una versione precedente genera un errore.
--application-insights | --no-application-insights-
Attiva Amazon CloudWatch Monitoraggio di Application Insights per la tua applicazione. Per ulteriori informazioni, consulta Utilizzo di CloudWatch Application Insights per monitorare le applicazioni AWS SAM serverless.
L'opzione predefinita è
--no-application-insights. --architecture, -a[ x86_64 | arm64 ]-
L'architettura del set di istruzioni per Lambda Event Functions della tua applicazione. Specifica uno dei
x86_64oarm64. --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 ]-
L'immagine di base della tua applicazione. Questa opzione si applica solo quando il tipo di pacchetto è
Image.Questo parametro è obbligatorio se
--no-interactiveè specificato,--package-typeè specificato comeImage, e--locationnon è specificato. --config-envTEXT-
Il nome dell'ambiente che specifica i valori dei parametri predefiniti nel file di configurazione da utilizzare. Il valore predefinito è «default». Per ulteriori informazioni sui file di configurazione, consulta AWS SAMCLIfile di configurazione.
--config-filePATH-
Il percorso e il nome del file di configurazione contenente i valori dei parametri predefiniti da utilizzare. Il valore predefinito è «samconfig.toml» nella radice della directory del progetto. Per ulteriori informazioni sui file di configurazione, consulta AWS SAMCLIfile di configurazione.
--debug-
Attiva la registrazione di debug per stampare i messaggi di debug che AWS SAM CLI genera e visualizza i timestamp.
--dependency-manager, -d[ gradle | mod | maven | bundler | npm | cli-package | pip ]-
Il gestore delle dipendenze del tuo runtime Lambda.
--extra-content-
Sostituisci qualsiasi parametro personalizzato nel modello
cookiecutter.jsonconfigurazione, ad esempio,{"customParam1": "customValue1", "customParam2":"customValue2"}. --help, -h-
Mostra questo messaggio ed esce.
--location, -lTEXT-
La posizione del modello o dell'applicazione (Git, Mercurial, HTTP/HTTPS, file.zip, percorso).
Questo parametro è obbligatorio se
--no-interactiveè specificato e--runtime,--name, e--app-templatenon sono forniti.Per i repository Git, è necessario utilizzare la posizione della radice del repository.
Per i percorsi locali, il modello deve essere contenuto in un file .zip o Tagliabiscotti
formato. --name, -nTEXT-
Il nome del progetto da generare come directory.
Questo parametro è obbligatorio se
--no-interactiveè specificato e--locationnon è fornito. --no-input-
Disattiva la richiesta di Cookiecutter e accetta i valori vcfdefault definiti nella configurazione del modello.
--no-interactive-
Disattiva la richiesta interattiva per i parametri di inizializzazione e fallisce se mancano i valori richiesti.
--output[ text | json ]-
Il formato dell'output del comando:
-
text— Stampa un output regolare e leggibile dall'uomo. Si tratta del valore di default. -
json— Stampa un output strutturato e leggibile dalla macchina. Utilizza questo formato quando desideri utilizzare l'output a livello di programmazione, ad esempio in CI/CD pipeline, estensioni IDE e AI-assisted strumenti.
Quando si specifica
--output json, il AWS SAM CLI stampa un singolo oggetto JSON dopo il completamento del comando. In caso di successo, questo oggetto include campi come la directory del progetto e il file modello. È possibile concatenare l'output in comandi successivi comesam build. In caso di fallimento, include unerroroggetto che descrive cosa è andato storto.NotaLa
--output jsonl'opzione non è compatibile con il flusso di lavoro interattivo. Per utilizzarla, specifica un'esecuzione completamente non interattiva fornendo tutte le opzioni richieste. -
--output-dir, -oPATH-
La posizione in cui viene emessa l'applicazione inizializzata.
--package-type[ Zip | Image ]-
Il tipo di pacchetto dell'applicazione di esempio.
Zipcrea un archivio di file .zip eImagecrea un'immagine contenitore. --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 ]-
Il runtime Lambda della tua applicazione. Questa opzione si applica solo quando il tipo di pacchetto è
Zip.Questo parametro è obbligatorio se
--no-interactiveè specificato,--package-typeè specificato comeZip, e--locationnon è specificato. --save-params-
Salvate i parametri forniti nella riga di comando nel file AWS SAM file di configurazione.
--tracing | --no-tracing-
Attiva AWS X-Ray tracciamento delle tue funzioni Lambda.
Esempio
Per un esempio dettagliato e una guida dettagliata sull'uso di sam init sottocomando, fare riferimento a Crea la tua candidatura in AWS SAM.