Remarques sur la migration d'AWS SDK v2 vers v3 ( Javascript) - Un guide rapide pour vous aider

Le kit AWS SDK pour JavaScript (v2) sera mis en mode maintenance cette année (2023). La v3 est disponible depuis un certain temps, et c'est la version incluse dans le nouveau runtime lambda pour Node18, qui est également la version actuelle du nœud LTS.

Donc, si vous souhaitez mettre à jour vos lambdas vers l'environnement d'exécution Node18 Lambda, vous devez ajouter le SDK v2 à votre fonction lambda actuelle ou rester dans Node16 (vous pouvez lancer votre propre environnement d'exécution , mais c'est un autre sujet).

Les avantages de la nouvelle version du SDK sont plus de modularité, y compris ce dont vous avez besoin, une taille de paquet plus petite telle qu'elle est livrée directement sur la nouvelle image lambda, la prise en charge de Typescript et une pile de middleware personnalisée pour personnaliser certains comportements du SDK (que je n'ai pas encore utilisé).

La migration n'est pas trop difficile ; tu peux suivre cette doc . Cependant, j'ai rencontré des détails qui n'étaient pas évidents au début et qui vous feront gagner du temps sur Google/invite.

Lambda

v2 :

 const AWS = require('aws-sdk'); const lambda = new AWS.Lambda(options); const result = await lambda.invoke(invokeParams).promise(); const resultPayload = JSON.parse(result.Payload)

v3 :

 const { LambdaClient, InvokeCommand } = require('@aws-sdk/client-lambda'); const { toUtf8 } = require('@aws-sdk/util-utf8-node'); const command = new InvokeCommand(invokeParams); const result = await lambda.send(command); const resultPayload = JSON.parse(toUtf8(result.Payload));// Now the result payload is a Uint8 array that needs to be decoded

DynamoDB

v2 :

 const AWS = require('aws-sdk'); dynamoDbClient = new AWS.DynamoDB.DocumentClient(options); await dynamoDbClient.put(params).promise(); await dynamoDbClient.get(params).promise(); await dynamoDbClient.update(params).promise(); await dynamoDbClient.update(params).promise(); await dynamoDb.delete(params).promise(); await dynamoDb.scan(params).promise(); await dynamoDb.query(params).promise();

v3 :

 const { DynamoDBClient } = require('@aws-sdk/client-dynamodb'); const { DynamoDBDocument, GetCommand, PutCommand, DeleteCommand, QueryCommand, UpdateCommand, ScanCommand, } = require('@aws-sdk/lib-dynamodb'); const dynamoDbClient = new DynamoDBClient(options); const docClient = DynamoDBDocument.from(dynamoDbClient); await docClient.send(new PutCommand(params)); await docClient.send(new GetCommand(params)); await docClient.send(new UpdateCommand(params)); await docClient.send(new UpdateCommand(params)); await docClient.send(new DeleteCommand(params)); await docClient.send(new ScanCommand(params)); await docClient.send(new QueryCommand(params));

Si vous aviez l'habitude de traiter certains flux à partir d'une table DynamoDB et que vous utilisiez la fonction unmarshall , v2 :

 const AWS = require('aws-sdk'); const {unmarshall} = AWS.DynamoDB.Converter;

v3 :

 const { unmarshall } = require('@aws-sdk/util-dynamodb');

S3

v2 :

 const AWS = require('aws-sdk'); const s3Client = new AWS.S3(options); s3Client.upload(params, callBack);

v3 :

 const { S3Client } = require('@aws-sdk/client-s3'); const { Upload } = require('@aws-sdk/lib-storage'); const s3Client = new S3Client(options); const parallelUploads3 = new Upload({ client: s3Client, params }); const result = await parallelUploads3.done();

SRS

v2 :

 const AWS = require('aws-sdk'); const snsClient = new AWS.SNS(options); await snsClient.publish(data).promise();

v3 :

 const { SNSClient, PublishCommand } = require('@aws-sdk/client-sns'); const snsClient = new SNSClient(options); await snsClient.send(new PublishCommand(data));