View a markdown version of this page

Crea la tua candidatura in AWS SAM - 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à.

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.

Importante

I modelli personalizzati possono includere hook che eseguono codice sul computer mentre sam init crea il progetto. Ottieni modelli personalizzati solo da autori affidabili.

Nota

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.

Inizializza una nuova applicazione serverless

Per inizializzare una nuova applicazione serverless utilizzando AWS SAM CLI
  1. cd in una directory di partenza.

  2. Esegui quanto segue nella riga di comando:

    $ sam init
  3. Il AWS SAM CLI ti guiderà attraverso un flusso interattivo per creare una nuova applicazione serverless.

    Nota

    Come 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 in template.yaml file che il sam init comando creato.

Scegli un modello iniziale

A modello è costituito da quanto segue:

  1. Un AWS SAM modello per il codice della tua infrastruttura.

  2. Una directory iniziale del progetto che organizza i file di progetto. Ad esempio, ciò può includere:

    1. Una struttura per il codice della funzione Lambda e le relative dipendenze.

    2. Un events cartella che contiene eventi di test per i test locali.

    3. A tests cartella per supportare i test unitari.

    4. A samconfig.toml file per configurare le impostazioni del progetto.

    5. A ReadMe file 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
  1. Quando richiesto, seleziona AWS Modelli di avvio rapido.

  2. 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: 1
    
    Choose 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
  1. 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
  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.

  3. 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:

  1. Immagine del contenitore — Contiene il sistema operativo di base, il runtime, le estensioni Lambda, il codice dell'applicazione e le relative dipendenze.

  2. 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 --location https://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 --location gh:aws-samples/cookiecutter-aws-sam-python $ sam init --location git+sh://git@github.com/aws-samples/cookiecutter-aws-sam-python.git $ sam init --location hg+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 --location https://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:

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.