Quick Start: pubblicazione delle applicazioni

Per inizializzare l'applicazione

1. Eseguire il comando seguente al prompt dei comandi dell'interfaccia a riga di comando AWS SAM.

   sam init --runtime python3.6 

2. Esaminare il contenuto della directory creata dal comando (sam-app/):

   • template.yaml— Definisce dueAWS risorse necessarie all'applicazione Hello World: una funzione Lambda e un endpoint API Gateway che supporta un'operazione GET. Il modello definisce anche la mappatura tra le due risorse.

   • Contenuto relativo al codice dell'applicazione Hello World:

     • hello_world/directory: contiene il codice dell'applicazione, chehello world viene restituito quando viene eseguita.

   Nota

   Per questo esercizio, il codice dell'applicazione è scritto in Python e specifichi il runtime nel comando init. AWS Lambda supporta altri linguaggi per la creazione del codice dell'applicazione. Se specifichi un altro runtime supportato, il comando init fornisce il codice Hello World nel linguaggio specificato e un file README.md che è possibile seguire per tale linguaggio. Per informazioni sui runtime supportati, consulta l'argomento relativo all'ambiente di esecuzione Lambda e alle librerie disponibili.

Per testare l'applicazione localmente

1. Avviare l'endpoint del gateway API localmente. È necessario eseguire il comando seguente dalla directory che contiene il file template.yaml.

   sam-app> sam local start-api --region us-east-1

   Il comando restituisce un endpoint API Gateway, a cui è possibile inviare richieste per i test locali.

2. Testare l'applicazione. Copia l'URL dell'endpoint API Gateway, incollalo nel browser e scegli Invio. Un esempio di URL dell'endpoint API Gateway èhttp://127.0.0.1:3000/hello.

   API Gateway richiama localmente la funzione Lambda a cui è mappato l'endpoint. La funzione Lambda viene eseguita nel contenitore Docker locale e restituiscehello world. API Gateway restituisce una risposta al browser che contiene il testo.

1. Modificare il file /hello_world/app.py per cambiare la stringa del messaggio da 'hello world' a 'Hello World!'.

2. Ricaricare l'URL di test nel browser e osservare la nuova stringa.

Per creare un pacchetto di distribuzione Lambda

1. Aggiungere una sezione Metadata al file del modello AWS SAM fornendo le informazioni richieste sull'applicazione. Per ulteriori informazioni sulla sezione Metadata dei modelli AWS SAM, consultare le proprietà della sezione Metadata del modello AWS SAM nella Guida per gli sviluppatori di AWS Serverless Application Model.

   Ecco una sezione Metadata di esempio:

   Metadata:
     AWS::ServerlessRepo::Application:
       Name: my-app
       Description: hello world
       Author: user1
       SpdxLicenseId: Apache-2.0
       LicenseUrl: LICENSE.txt
       ReadmeUrl: README.md
       Labels: ['tests']
       HomePageUrl: https://github.com/user1/my-app-project
       SemanticVersion: 0.0.1
       SourceCodeUrl: https://github.com/user1/my-app-project

   ReadmeUrlLe proprietàLicenseUrl and possono essere riferimenti a file locali (come nell'esempio precedente) oppure possono essere collegamenti a bucket Amazon S3 che già ospitano questi artefatti.

2. Creare un bucket S3 nella posizione in cui si desidera salvare il codice nel pacchetto. Se si desidera utilizzare un bucket S3 esistente, ignorare questo passaggio.

   sam-app> aws s3 mb s3://bucketname

3. Crea il pacchetto di distribuzione delle funzioni Lambda eseguendo il seguente comandopackageAWS SAM CLI.

   sam-app> sam package \
       --template-file template.yaml \
       --output-template-file packaged.yaml \
       --s3-bucket bucketname

   Il comando esegue quanto segue:

   • Comprime il contenuto dellaaws-sam/hello_world/ directory e lo carica su Amazon S3.

   • Carica il pacchetto di distribuzione, il file README e il file LICENSE nel bucket Amazon S3 specificato dall'--s3-bucketopzione.

   • Produce un nuovo file del modello, chiamato packaged.yaml, che viene utilizzato nella prossima fase per pubblicare l'applicazione in AWS Serverless Application Repository. Il filepackaged.yaml modello è simile al file modello originale (template.yaml), ma presenta una differenza fondamentale: leReadmeUrl proprietàCodeUriLicenseUrl, e rimandano al bucket Amazon S3 e agli oggetti che contengono i rispettivi artefatti. Il frammento riportato di seguito tratto dal file del modello di esempio packaged.yaml mostra la proprietà CodeUri:

     HelloWorldFunction:
         Type: AWS::Serverless::Function # For more information about function resources, see https://github.com/awslabs/serverless-application-model/blob/master/versions/2016-10-31.md#awsserverlessfunction
         Properties:
           CodeUri: s3://bucketname/fbd77a3647a4f47a352fcObjectGUID
     
     ...

Per pubblicare l'applicazione serverless in AWS Serverless Application Repository

• Eseguire il seguente comando per pubblicare la nuova applicazione in AWS Serverless Application Repository con la prima versione creata come 0.0.1.

  sam-app> sam publish \
      --template packaged.yaml \
      --region us-east-1