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à.
Crea la tua candidatura in AWS SAM
Dopo il completamento Guida introduttiva e leggendo Come usare AWS Serverless Application Model (AWS SAM), sarai pronto per creare un AWS SAM progetto nel tuo ambiente di sviluppo. Il tuo AWS SAM il progetto servirà come punto di partenza per scrivere la tua applicazione serverless. Per un elenco di AWS SAM CLI sam init opzioni di comando, vedere sam init.
Il AWS Serverless Application Model Interfaccia a riga di comando (AWS SAM CLI) sam init il comando fornisce opzioni per inizializzare una nuova applicazione serverless composta da:
-
Un AWS SAM modello per definire il codice dell'infrastruttura.
-
Una struttura di cartelle che organizza l'applicazione.
-
Configurazione per la tua AWS Lambda Funzioni degli eventi.
Per creare un AWS SAM progetto, consulta gli argomenti di questa sezione.
I modelli personalizzati possono includere hook che eseguono codice sul computer mentre sam init crea il progetto. Ottieni modelli personalizzati solo da autori affidabili.
sam init include modelli di progetto per funzioni durature nei runtime supportati (TypeScript, Python, Java). Questi modelli forniscono codice iniziale e configurazione per la creazione di applicazioni serverless con stato.
Argomenti
Inizializza una nuova applicazione serverless
Per inizializzare una nuova applicazione serverless utilizzando AWS SAM CLI
-
cdin una directory di partenza. -
Esegui quanto segue nella riga di comando:
$sam init -
Il AWS SAM CLI ti guiderà attraverso un flusso interattivo per creare una nuova applicazione serverless.
NotaCome dettagliato in Tutorial: Implementa un'applicazione Hello World con AWS SAM, questo comando inizializza l'applicazione serverless, creando la directory del progetto. Questa directory conterrà diversi file e cartelle. Il file più importante è
template.yaml. Questa è la tua AWS SAM modello. La tua versione di python deve corrispondere alla versione di python elencata intemplate.yamlfile che il sam init comando creato.
Scegli un modello iniziale
A modello è costituito da quanto segue:
-
Un AWS SAM modello per il codice della tua infrastruttura.
-
Una directory iniziale del progetto che organizza i file di progetto. Ad esempio, ciò può includere:
-
Una struttura per il codice della funzione Lambda e le relative dipendenze.
-
Un
eventscartella che contiene eventi di test per i test locali. -
A
testscartella per supportare i test unitari. -
A
samconfig.tomlfile per configurare le impostazioni del progetto. -
A
ReadMefile e altri file di progetto iniziali di base.
Di seguito è riportato un esempio di cartella iniziale del progetto:
sam-app ├── README.md ├── __init__.py ├── events │ └── event.json ├── hello_world │ ├── __init__.py │ ├── app.py │ └── requirements.txt ├── samconfig.toml ├── template.yaml └── tests ├── __init__.py ├── integration │ ├── __init__.py │ └── test_api_gateway.py ├── requirements.txt └── unit ├── __init__.py └── test_handler.py -
È possibile selezionare da un elenco di quelli disponibili AWS Modelli Quick Start o fornisci i tuoi Posizione del modello personalizzato.
Per scegliere un AWS Modello Quick Start
-
Quando richiesto, seleziona AWS Modelli di avvio rapido.
-
Seleziona un AWS Modello Quick Start per cominciare. Di seguito è riportato un esempio:
Which template source would you like to use? 1 - AWS Quick Start Templates 2 - Custom Template Location Choice:1Choose an AWS Quick Start application template 1 - Hello World Example 2 - Multi-step workflow 3 - Serverless API 4 - Scheduled task 5 - Standalone function 6 - Data processing 7 - Hello World Example With Powertools 8 - Infrastructure event management 9 - Serverless Connector Hello World Example 10 - Multi-step workflow with Connectors 11 - Lambda EFS example 12 - DynamoDB Example 13 - Machine Learning Template:4
Per scegliere la posizione del modello personalizzato
-
Quando richiesto, seleziona Posizione del modello personalizzato.
Which template source would you like to use? 1 - AWS Quick Start Templates 2 - Custom Template Location Choice:2 -
Il AWS SAM CLI ti chiederà di fornire una posizione del modello.
Template location (git, mercurial, http(s), zip, path):
Inserisci una delle seguenti posizioni nell'archivio di file .zip del modello:
-
GitHub magazzino — Il percorso del file .zip nel tuo GitHub repository. Il file deve trovarsi nella directory principale del repository.
-
Mercurial magazzino — Il percorso del file .zip nel tuo Mercurial repository. Il file deve trovarsi nella directory principale del repository.
-
percorso.zip — Un percorso HTTPS o locale del file .zip.
-
-
Il AWS SAM CLI inizializzerà l'applicazione serverless utilizzando il modello personalizzato.
Scegli un runtime
Quando scegli un AWS Modello Quick Start, il AWS SAM CLI richiede di selezionare un runtime per le funzioni Lambda. L'elenco delle opzioni visualizzate da AWS SAM CLI sono i runtime supportati nativamente da Lambda.
-
Il runtime fornisce un ambiente specifico del linguaggio di programmazione che viene eseguito in un ambiente di esecuzione.
-
Quando vengono distribuiti su Cloud AWS, il servizio Lambda richiama la funzione in un ambiente di esecuzione.
È possibile utilizzare qualsiasi altro linguaggio di programmazione con un runtime personalizzato. A tale scopo, è necessario creare manualmente la struttura iniziale dell'applicazione. È quindi possibile utilizzare sam init per inizializzare rapidamente l'applicazione configurando una posizione personalizzata del modello.
Dalla tua selezione, AWS SAM CLI crea la directory iniziale per il codice della funzione Lambda e le dipendenze.
Se Lambda supporta più gestori di dipendenze per il tuo runtime, ti verrà richiesto di scegliere il tuo gestore di dipendenze preferito.
Scegli un tipo di pacchetto
Quando scegli un AWS Modello Quick Start e un runtime, il AWS SAM CLI richiede di selezionare un tipo di pacchetto. Il tipo di pacchetto determina il modo in cui le funzioni Lambda vengono distribuite per l'utilizzo con il servizio Lambda. I due tipi di pacchetto supportati sono:
-
Immagine del contenitore — Contiene il sistema operativo di base, il runtime, le estensioni Lambda, il codice dell'applicazione e le relative dipendenze.
-
archivio di file.zip — Contiene il codice dell'applicazione e le relative dipendenze.
Per saperne di più sui tipi di pacchetti di distribuzione, vedi Pacchetti di distribuzione Lambda nel AWS Lambda Guida per gli sviluppatori.
Di seguito è riportato un esempio di struttura di directory di un'applicazione con una funzione Lambda impacchettata come immagine contenitore. Il AWS SAM CLI scarica l'immagine e crea un Dockerfile nella cartella della funzione per specificare l'immagine.
sam-app
├── README.md
├── __init__.py
├── events
│ └── event.json
├── hello_world
│ ├── Dockerfile
│ ├── __init__.py
│ ├── app.py
│ └── requirements.txt
├── samconfig.toml
├── template.yaml
└── tests
├── __init__.py
└── unit
├── __init__.py
└── test_handler.py
Di seguito è riportato un esempio di struttura di directory di un'applicazione con una funzione impacchettata come archivio di file .zip.
sam-app
├── README.md
├── __init__.py
├── events
│ └── event.json
├── hello_world
│ ├── __init__.py
│ ├── app.py
│ └── requirements.txt
├── samconfig.toml
├── template.yaml
└── tests
├── __init__.py
├── integration
│ ├── __init__.py
│ └── test_api_gateway.py
├── requirements.txt
└── unit
├── __init__.py
└── test_handler.py
Configura AWS X-Ray tracciato
Puoi scegliere di attivare AWS X-Ray tracciamento. Per saperne di più, vedi Che cos'è AWS X-Ray? nel AWS X-Ray Guida per gli sviluppatori.
Se si attiva, AWS SAM CLI configura il tuo AWS SAM modello. Di seguito è riportato un esempio:
Globals: Function: ... Tracing: Active Api: TracingEnabled: True
Configura il monitoraggio con Amazon CloudWatch Approfondimenti sulle applicazioni
Puoi scegliere di attivare il monitoraggio utilizzando Amazon CloudWatch Approfondimenti sulle applicazioni. Per saperne di più, vedi Amazon CloudWatch Approfondimenti sulle applicazioni nel Amazon CloudWatch Guida per l'utente.
Se si attiva, AWS SAM CLI configura il tuo AWS SAM modello. Di seguito è riportato un esempio:
Resources: ApplicationResourceGroup: Type: AWS::ResourceGroups::Group Properties: Name: Fn::Join: - '' - - ApplicationInsights-SAM- - Ref: AWS::StackName ResourceQuery: Type: CLOUDFORMATION_STACK_1_0 ApplicationInsightsMonitoring: Type: AWS::ApplicationInsights::Application Properties: ResourceGroupName: Fn::Join: - '' - - ApplicationInsights-SAM- - Ref: AWS::StackName AutoConfigurationEnabled: 'true' DependsOn: ApplicationResourceGroup
Assegna un nome alla tua applicazione
Fornisci un nome per la tua applicazione. Il AWS SAM CLI crea una cartella di primo livello per l'applicazione utilizzando questo nome.
Opzioni per sam init
Le seguenti sono alcune delle opzioni principali che puoi usare con sam init comando. Per un elenco di tutte le opzioni, vedere sam init.
Inizializza un'applicazione utilizzando una posizione del modello personalizzata
Usa il --location opzione e fornisci una posizione del modello personalizzato supportata. Di seguito è riportato un esempio:
$sam init --locationhttps://github.com/aws-samples/sessions-with-aws-sam/raw/master/starter-templates/web-app.zip
Inizializza un'applicazione senza il flusso interattivo
Usa il --no-interactive e fornisci le tue scelte di configurazione nella riga di comando per saltare il flusso interattivo. Di seguito è riportato un esempio:
$sam init --no-interactive--runtime go1.x --name go-demo --dependency-manager mod --app-template hello-world
Risoluzione dei problemi
Per risolvere i problemi di AWS SAM CLI, vedi AWS SAM CLI risoluzione dei problemi.
Esempi
Inizializza una nuova applicazione serverless utilizzando Hello World AWS Modello iniziale
Per questo esempio, vedi Passaggio 1: inizializza l'applicazione Hello World di esempio nel Tutorial: Distribuzione di un'applicazione Hello World.
Inizializza una nuova applicazione serverless con una posizione del modello personalizzata
Di seguito sono riportati alcuni esempi di come fornire un GitHub posizione del modello personalizzato:
$sam init --locationgh:aws-samples/cookiecutter-aws-sam-python$sam init --locationgit+sh://git@github.com/aws-samples/cookiecutter-aws-sam-python.git$sam init --locationhg+ssh://hg@bitbucket.org/repo/template-name
Di seguito è riportato un esempio di percorso di file locale:
$sam init --location/path/to/template.zip
Di seguito è riportato un esempio di percorso raggiungibile tramite HTTPS:
$sam init --locationhttps://github.com/aws-samples/sessions-with-aws-sam/raw/master/starter-templates/web-app.zip
Ulteriori informazioni
Per saperne di più sull'uso di sam init comando, vedi quanto segue:
-
Apprendimento AWS SAM: sam init
— Serverless Land «Apprendimento AWS SAM«serie su YouTube. -
Strutturazione di applicazioni serverless da utilizzare con AWS SAM CLI (Sessioni con SAM S2E7)
— Sessioni con AWS SAM serie su YouTube.
Fasi successive
Ora che hai creato il tuo AWS SAM progetto, sei pronto per iniziare a creare la tua applicazione. Vedi Definisci la tua infrastruttura con AWS SAM per istruzioni dettagliate sulle attività da completare a tale scopo.