Das Beispiel für NodeJS ist im Unterordner node zu finden.
Es verwendet ausschließlich Node JS und nutzt die managed Node Runtime für Lambda
Das Projekt besitzt eine package.json, in der mit npm die Abhängigkeiten verwaltet werden:
link:./src/package.json[role=include]Hier sind ausschließlich devDependencies zu sehen, da die managed Lambda Node Runtime selbst die entsprechenden AWS SDKs direkt mit bringt.
Insofern ist es nicht notwendig, Abhängigkeiten einzuführen, die den Zugriff auf AWS Services erlauben, wodurch sich die Paketierung auch auf den eigentlichen fachlichen Prozess konzentrieren kann.
Dies verschlankt die Paketgröße deutlich.
Im vorliegenden Beispiel liegt der gesamte Code in einer einzigen relativ kleinen Datei.
Lambda benötigt zur Ausführung einen Handler, der als exportierte Funktion in der entsprechenden JavaScript Datei deklariert ist:
link:./src/index.mjs[role=include]Dieser Handler geht davon aus, dass die Lambda über ein API Gateway aufgerufen wird.
Aus diesem Grund reagiert der Handler auf die httpMethod im Event und parsed entweder den body oder liest das Feld pathParameters aus, um die übergebene petId auszulesen.
Als Client für DynamoDB kommt hier ein DocumentClient zum Einsatz, der einige Vereinfachungen zur DynamoDB Low Level API mit sich bringt:
link:./src/index.mjs[role=include]link:./src/index.mjs[role=include]Im Verzeichnis src/terraform des Beispiels ist der benötigte Terraform Code abgelegt.
Hier wird ein S3 Bucket zur Ablage des Codes erzeugt:
link:./terraform/bucket.tf[role=include]Hier wird die einzige JavaScript Datei (index.mjs) mittels archive_file in ein zip-Archiv komprimiert und dieses als Quelltext in einen S3 Bucket geladen.
Die DynamoDB Table wird unter Berücksichtigung eines numerischen partition key erzeugt:
link:./terraform/dynamodb.tf[role=include]Das API Gateway wird aus der Datei resources/openapi.yaml erzeugt, die Template Code enthält:
link:./resources/openapi.yaml[role=include]Hier ist neben der API Spezifikation an jeder Methode eine Extension annotiert, die die Integration mit dem AWS API Gateway repräsentiert:
link:./resources/openapi.yaml[role=include]Mithilfe dieser Integration wird auf eine lambda_invoke_arn verwiesen, um bei Aufruf der Methode eine Lambda Funktion auszulösen.
In diesem Fall ist die lambda_invoke_arn als Terraform Template Variable realisiert, um die entsprechende arn extern bei der Erstellung des API Gateway aus dem tatsächlichen Wert zu parametrisieren:
link:./terraform/api-gateway.tf[role=include]Dies erstellt das REST API Gateway mit Verweis auf die lambda_function_invoke_arn im Template.
Dadurch wird dynamisch die Lambda mit dem API Gateway verbunden, um diese bei den entsprechenden REST API Calls aufrufen zu können.
Die Lambda Funktion wird aus dem Quelltext auf S3 erstellt:
link:./terraform/lambda.tf[role=include]Hier wird weiterhin die Umgebungsvariable DYNAMODB_TABLE_ID übergeben, die im Handler ausgelesen wird, um die richtige Table zu nutzen.
Außerdem werden Trigger seitens des API Gateway erlaubt und eine IAM Policy angehangen, die Schreib- und Leseoperationen auf der DynamoDB Table erlaubt.
Für e2e-Tests liegt im Projekt die Datei requests.http.
Diese funktioniert mit dem IntelliJ HTTP Client:
link:./src/requests.http[role=include]Zur erfolgreichen Ausführung muss vorher die api-url in der Datei http-client.env.json auf den passenden Wert aus der erstellten Infrastruktur konfiguriert werden.
link:./src/http-client.env.json[role=include]