AWS Lambda con LocalStack supporto

Crea, testa ed esegui il debug delle tue applicazioni serverless con LocalStack il supporto di. AWS Toolkit for Visual Studio Code LocalStack è un emulatore AWS cloud che consente il test locale di applicazioni serverless.

Per ulteriori informazioni in merito AWS Lambda, consulta la Guida per gli AWS Lambdasviluppatori. Per saperne di più LocalStack, visita il loro sito Web LocalStack.

Prerequisiti

Di seguito sono riportati i prerequisiti per lavorare con LocalStack VS Code.

Nota

La LocalStack CLI viene installata durante il processo di configurazione, ma se si preferisce una versione diversa della LocalStack CLI, la versione minima richiesta è la 4.8.0.

• È necessario un account LocalStack Web Application per accedere a tutte le funzionalità disponibili per i livelli gratuito e a pagamento. LocalStack LocalStack l'edizione community è disponibile senza un account.

• Docker è necessario per funzionare con LocalStack VS Code. Per ulteriori informazioni sui LocalStack requisiti per Docker, consulta l'argomento LocalStack Docker Images nella documentazione. LocalStack

• Consigliato: il AWS Command Line Interface (AWS CLI) ti aiuta a lavorare con i servizi nel tuo ambiente cloud simulato.

Installazione LocalStack

Per installare versioni a più livelli LocalStack gratuite e a pagamento, completa i seguenti passaggi.

Nota

Per istruzioni su come configurare l'edizione LocalStack Community, consulta il contenuto LocalStackdella community nella LocalStack sezione Configurazione di questo argomento.

1. Dal AWS Toolkit, espandi l'esploratore APPLICATION BUILDER.

2. Scegli il pulsante Apri procedura dettagliata per aprire la scheda Guida introduttiva alla creazione della tua applicazione nell'editor VS Code.

3. Dalla procedura dettagliata, scegli Installa per avviare il processo di installazione LocalStack in VS Code. LocalStack

Configurazione LocalStack

Dopo aver installato l' LocalStack estensione per VS Code, potresti visualizzare uno dei seguenti indicatori quando è necessaria la configurazione:

• Nella barra di stato di VS Code, situata nell'angolo inferiore sinistro dell'IDE per impostazione predefinita, lo LocalStack stato è rosso.

• VS Code ti chiede di eseguire la configurazione. LocalStack

Esistono due tipi di installazione e configurazioni LocalStack, a seconda della versione che LocalStack stai utilizzando. Le seguenti sezioni a schede descrivono ogni LocalStack processo di configurazione.

Nota

LocalStack i token di autenticazione sono necessari per le versioni di livello gratuito e a pagamento di. LocalStack Per informazioni specifiche sui LocalStack prezzi, consulta la guida ai prezzi di Choose your plan.

LocalStack livelli gratuiti e a pagamento

Esistono 2 modi per configurare. LocalStack

• Dalla richiesta di avvio di VS Code Setup LocalStack , scegli il pulsante Setup.

• Dalla barra di stato di VS Code, scegli l'icona di LocalStack stato per aprire il prompt Setup LocalStack to get started, quindi scegli il pulsante Setup.

Durante la configurazione, il sistema esegue i seguenti passaggi:

1. Installa la LocalStack CLI.

2. Verifica se hai un LocalStack account.

3. Se hai un LocalStack account, il sistema ti guida attraverso il processo di autenticazione nel tuo browser web predefinito. Analogamente, se non disponete di un LocalStack account, il sistema vi guida nella configurazione dell'account prima del processo di autenticazione.

Dopo la configurazione, LocalStack lo stato LocalStack si aggiorna nella barra di stato di VS Code.

Nota

Se non hai creato un AWS profilo per LocalStack, ne viene creato automaticamente uno nuovo come parte del processo di LocalStack configurazione.

LocalStack Comunità

L'edizione Community di LocalStack è gratuita e non richiede la registrazione di un account, viene eseguita da un'immagine Docker che non richiede una licenza. Per ulteriori dettagli sulla LocalStack Community Edition, consulta la documentazione relativa all'immagine per la LocalStack community. Le sezioni seguenti descrivono i prerequisiti e la configurazione di base necessaria per lavorare con l'edizione LocalStack comunitaria in VS Code.

Avvio di una nuova istanza

Per avviare una nuova istanza di LocalStack Community, completare la procedura seguente.

Nota

L'esempio seguente avvia un'istanza di container LocalStack sulla porta 4566. Se si specificano valori di porta diversi, è necessario aggiornare il valore di porta specificato nella procedura disponibile nella sezione Configurazione del AWS CLI AWS Toolkit.

1. Da VS Code, apri il terminale VS Code premendo. ctrl + `(backtick)

2. Inserisci quanto segue nel terminale.

   Mac:

   docker run -d --name localstack_main \
   >> -p 4566:4566 \
   >> -v /var/run/docker.sock:/var/run/docker.sock \
   >> localstack/localstack

   Windows:

   docker run -d --name localstack_main `
   >> -p 4566:4566 `
   >> -v /var/run/docker.sock:/var/run/docker.sock `
   >> localstack/localstack

3. Il terminale si aggiorna con lo stato dell'istanza Docker al termine del processo.

Questa istanza containerizzata di LocalStack consente di accedere ai AWS servizi specificati durante il processo di download.

Configurazione della CLI LocalStack per e Docker.

Per configurare AWS CLI e utilizzare AWS Toolkit LocalStack in Docker, configura un nuovo profilo completando i seguenti passaggi:

1. Da VS Code, apri il terminale VS Code premendo. ctrl + `(backtick)

2. Inserisci quanto segue nel terminale.

   ~/.aws/credentials
   [localstack]
   aws_access_key_id = test
   aws_secret_access_key = test
   ~/.aws/config
   [profile localstack]
   region = us-east-1
   output = json
   endpoint_url = http://localhost:4566 [default localstack endpoint]

3. Il AWS Toolkit rileva il tuo LocalStack profilo e aggiorna il menu di stato della connessione.

Dopo la configurazione, la scelta del LocalStack profilo dalla sezione AWS profilo della barra di stato rende le LocalStack risorse visibili nell' AWS Explorer. Inoltre, puoi visualizzare i tuoi LocalStack registri nella scheda Output del terminale VS Code.

A partire da LocalStack VS Code

Puoi iniziare a LocalStack utilizzare uno dei seguenti metodi:

A partire LocalStack dalla barra di stato di VS Code

1. Da VS Code, vai alla barra di stato, quindi scegli il LocalStack pulsante Start per avviarlo LocalStack.

2. La barra di stato di VS Code LocalStack si aggiorna quando viene avviata correttamente.

A partire LocalStack dalla palette di comandi VS Code

1. Da VS Code, apri la palette dei comandi premendo Cmd + Shift + P (Mac) o Control + Shift + P (Windows).

2. Dalla Command Palette, accedi Start LocalStack alla barra di ricerca e sceglila dall'elenco quando viene inserita nei risultati.

3. La barra di stato di VS Code si aggiorna quando viene LocalStack avviata correttamente.

A partire LocalStack dal terminale VS Code

1. Da VS Code, apri il terminale VS Code premendoctrl + `(backtick).

2. Dal terminale VS Code, immettere il localstack start comando CLI.

3. La barra di stato di VS Code si aggiorna quando viene LocalStack avviata correttamente.

Creazione di un'applicazione serverless di esempio

Per iniziare a lavorare con LocalStack VS Code, è necessaria un'applicazione serverless di esempio. Se hai già un'applicazione esistente nel tuo AWS account, puoi distribuirla localmente utilizzando LocalStack oppure puoi creare una nuova applicazione con AWS Serverless Land.

Per ulteriori informazioni sulla creazione di un'applicazione con Serverless Land nel AWS Toolkit, consultate l'argomento Lavorare con AWS Serverless Land in questa guida per l'utente. Per informazioni dettagliate su Serverless Land, consultate la pagina iniziale principale dell'applicazione web Serverless Land.

Test e debug delle funzioni Lambda con LocalStack

Il test e il debug delle funzioni Lambda nell'estensione LocalStack VS Code sono simili all'utilizzo delle funzioni distribuite nel cloud. AWS La differenza principale è che l'istanza AWS Toolkit deve essere autenticata con l' LocalStack account per distribuire ed eseguire il debug delle funzioni. LocalStack

Nota

Le funzionalità di test e debug descritte in questa sezione non sono disponibili per l'edizione Community. LocalStack

Per lavorare con LocalStack VS Code, connettiti al tuo LocalStack profilo nel Toolkit. AWS Quando il tuo LocalStack profilo è attivo, la barra di stato di VS Code mostra AWS: profile:localstack (endpoint personalizzato) con un segno di spunta.

Per informazioni dettagliate sull'utilizzo delle funzioni Lambda nel AWS Toolkit, consulta l'argomento Utilizzo delle AWS Lambda funzioni in questa guida per l'utente.