Lokaal testen met SAM CLI

Elke wijziging naar een testomgeving implementeren is traag. De SAM CLI bootst Lambda en API Gateway na op je computer, zodat je snel feedback krijgt.

Lokale emulatie voert functies uit in Docker-containers die de Lambda-runtime nabootsen. Daarom heb je naast de SAM CLI ook Docker nodig.

Gebruik sam local invoke om één functie één keer uit te voeren met een testgebeurtenis, net als bij één Lambda-uitvoering.

Het gebeurtenisbestand is de JSON-lading die je handler ontvangt. Bewaar een map met voorbeeldgebeurtenissen voor verschillende scenario's.

SAM kan realistische gebeurtenissen voor veelgebruikte bronnen genereren, zodat je ze niet zelf hoeft samen te stellen.

sam local start-api start een lokale HTTP-server die verzoeken naar je functies doorstuurt en API Gateway nabootst.

Als de API actief is, kun je deze met elke HTTP-client aanroepen. De respons komt van je echte handlercode.

Geef een JSON-bestand met overschrijvingen voor omgevingsvariabelen door, zodat lokale uitvoeringen naar testbronnen wijzen in plaats van naar productie.

Start met -d om te wachten totdat een foutopsporingsprogramma verbinding maakt via een poort. Daarna kun je onderbrekingspunten in je functiecode instellen.

De lokale modus kan IAM, netwerken of koude starts niet perfect nabootsen. Gebruik deze modus als snelle eerste controle, niet als vervanging voor een test in een stagingomgeving in de cloud.

Voer vóór het implementeren sam validate uit om fouten in de sjabloon vroegtijdig te vinden.

Je hebt geleerd hoe je functies aanroept, gebeurtenissen genereert, een lokale API uitvoert, omgevingsvariabelen injecteert en een foutopsporingsprogramma koppelt met de SAM CLI, inclusief de beperkingen van emulatie.