Distribuzione delle applicazioni

In questa sezione vengono fornite le procedure per la distribuzione di applicazioni serverless da AWS Serverless Application Repository utilizzando la AWS Management Console o l'AWS CLI.

Distribuzione di una nuova applicazione (console)

In questa sezione viene illustrato come distribuire una nuova applicazione da AWS Serverless Application Repository utilizzando la AWS Management Console. Per le istruzioni sulla distribuzione di una nuova versione di un'applicazione esistente, consulta Aggiornamento delle applicazioni.

Esplorazione, ricerca e distribuzione delle applicazioni

Con la seguente procedura si può trovare, configurare e distribuire un'applicazione in AWS Serverless Application Repository.

Per trovare e configurare un'applicazione in AWS Serverless Application Repository

1. Aprire la home page pubblica AWS Serverless Application Repository o la console AWS Lambda. Scegliere Create function (Crea funzione), quindi selezionare Browse serverless app repository (Sfoglia repository app serverless).

2. Esplorare o cercare un'applicazione.

   Nota

   Per mostrare le applicazioni che contengono ruoli IAM o policy delle risorse personalizzati, selezionare la casella di controllo Show apps that create custom IAM roles or resource policies (Mostra app in grado di creare ruoli IAM o policy delle risorse personalizzati). Per ulteriori informazioni sui ruoli IAM e le policy delle risorse personalizzati, consulta Accettazione delle funzionalità delle applicazioni.

3. Scegli un'applicazione per visualizzare dettagli come le autorizzazioni, le funzionalità e il numero di volte in cui è stata implementata daiAWS clienti.

   I conteggi delle distribuzioni vengono visualizzati per laAWS regione in cui stai tentando di distribuire l'applicazione.

4. Nella pagina dei dettagli dell'applicazione, visualizzare le autorizzazioni e le risorse dell'applicazione visualizzando il modello AWS SAM, la licenza e il file readme. In questa pagina è disponibile anche il link URL del codice sorgente per le applicazioni condivise pubblicamente. Se l'applicazione include tutte le applicazioni nidificate, in questa pagina potrai anche visualizzare i dettagli delle applicazioni nidificate.

5. Configurare l'applicazione nella sezione Application settings (Impostazioni applicazione). Per istruzioni su come configurare una specifica applicazione, consultare il file readme dell'applicazione.

   Ad esempio, i requisiti di configurazione potrebbero includere l'indicazione del nome di una risorsa a cui si desidera che l'applicazione abbia accesso. Tale risorsa potrebbe essere una tabella Amazon DynamoDB, un bucket Amazon S3 o un'API Amazon API Gateway.

6. Selezionare Deploy (Distribuisci). In questo modo si accede alla pagina Deployment status (Stato distribuzione).

   Nota

   Se l'applicazione include funzionalità che richiedono l'accettazione, è necessario selezionare la casella di controllo I acknowledge this application creates custom IAM roles or resource polices (Accetto la creazione di ruoli IAM o policy delle risorse personalizzati da parte di questa applicazione) prima di distribuire l'applicazione. In caso contrario verrà restituito un errore. Per ulteriori informazioni sui ruoli IAM e le policy delle risorse personalizzati, consulta Accettazione delle funzionalità delle applicazioni.

7. Nella pagina stato di distribuzione si può visualizzare l'avanzamento della distribuzione. In attesa del completamento della distribuzione, è possibile cercare e cercare altre applicazioni e tornare a questa pagina tramite la console Lambda.

Dopo aver distribuito correttamente l'applicazione, è possibile esaminare e gestire le risorse create utilizzandoAWS gli strumenti esistenti.

Distribuzione di una nuova applicazione (AWS CLI)

In questa sezione viene illustrato come distribuire una nuova applicazione da AWS Serverless Application Repository utilizzando l'AWS CLI. Per le istruzioni sulla distribuzione di una nuova versione di un'applicazione esistente, consulta Aggiornamento delle applicazioni.

Individuazione e accettazione delle funzionalità delle applicazioni (AWS CLI)

Per accettare le funzionalità di un'applicazione con AWS CLI, attieniti alla seguente procedura:

1. Esamina le funzionalità dell'applicazione.Usa il seguenteAWS CLI comando per esaminare le funzionalità di un'applicazione:

   aws serverlessrepo get-application \
   --application-id application-arn

   La proprietà della risposta requiredCapabilities include l'elenco delle funzionalità dell'applicazione da accettare per distribuire l'applicazione. Puoi anche utilizzare l'GetApplication API negliAWS SDK per ottenere questi dati.

2. Crea il changeset.È necessario fornire il set di funzionalità richieste quando si crea ilAWS CloudFormation changeset. Ad esempio, utilizza il seguente comando AWS CLI per distribuire un'applicazione accettandone le funzionalità:

   aws serverlessrepo create-cloud-formation-change-set \
   --application-id application-arn \
   --stack-name unique-name-for-cloud-formation-stack \
   --capabilities list-of-capabilities

   Al termine dell'esecuzione di questo comando viene restituito l'ID del set di modifiche. L'ID del set di modifiche è necessario per il prossimo passaggio. Puoi anche utilizzare l'CreateCloudFormationChangeSet API negliAWS SDK per creare il changeset.

   Ad esempio, ilAWS CLI comando seguente riconosce un'applicazione che contiene una AWS::IAM::Rolerisorsa con un nome personalizzato e una o più applicazioni annidate:

   aws serverlessrepo create-cloud-formation-change-set \
   --application-id application-arn \
   --stack-name unique-name-for-cloud-formation-stack \
   --capabilities CAPABILITY_NAMED_IAM CAPABILITY_AUTO_EXPAND

3. Esegui il changeset.L'esecuzione del set di modifiche esegue effettivamente la distribuzione. Fornire l'ID del set di modifiche restituito al momento della creazione nel passaggio precedente.

   Il seguente comando AWS CLI di esempio esegue il set di modifiche dell'applicazione per distribuire l'applicazione:

   aws cloudformation execute-change-set \
   --change-set-name changeset-id-arn

   Puoi anche utilizzare l'ExecuteChangeSet API negliAWS SDK per eseguire il changeset.

Eliminazione degli stack di un'applicazione

Per eliminare un'applicazione precedentemente distribuita tramite AWS Serverless Application Repository, segui la stessa procedura di eliminazione di uno stack AWS CloudFormation:

• AWS Management Console: per eliminare un'applicazione utilizzando ilAWS Management Console, vedere Eliminazione di uno stack sullaAWS CloudFormation console nella Guida per l'AWS CloudFormationutente.

• AWS CLI: per eliminare un'applicazione utilizzando ilAWS CLI, vedere Eliminazione di uno stack nella Guida per l'AWS CloudFormationutente.