View a markdown version of this page

sam init - AWS Serverless Application Model

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.

Il sam init Il comando fornisce opzioni per inizializzare una nuova applicazione serverless.

Importante

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-template TEXT

L'identificatore del modello di applicazione gestita che si desidera utilizzare. Se non sei sicuro, chiama sam init senza opzioni per un flusso di lavoro interattivo.

Questo parametro è obbligatorio se --no-interactive è specificato e --location non è 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_64 o 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 ]

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 come Image, e --location non è specificato.

--config-env TEXT

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-file PATH

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.json configurazione, ad esempio, {"customParam1": "customValue1", "customParam2":"customValue2"}.

--help, -h

Mostra questo messaggio ed esce.

--location, -l TEXT

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-template non 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, -n TEXT

Il nome del progetto da generare come directory.

Questo parametro è obbligatorio se --no-interactive è specificato e --location non è 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 come sam build. In caso di fallimento, include un error oggetto che descrive cosa è andato storto.

Nota

La --output json l'opzione non è compatibile con il flusso di lavoro interattivo. Per utilizzarla, specifica un'esecuzione completamente non interattiva fornendo tutte le opzioni richieste.

--output-dir, -o PATH

La posizione in cui viene emessa l'applicazione inizializzata.

--package-type [ Zip | Image ]

Il tipo di pacchetto dell'applicazione di esempio. Zip crea un archivio di file .zip e Image crea 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 come Zip, e --location non è 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.