A serverless function to combine multiple PDFs into one
- Python3.7
- SAM CLI, version 0.43.0
If you have not done so, following the steps to install the AWS SAM CLI on your local machine. Also recommend installing Docker to test code locally.
In your console, execute:
sam build
to build the code, then execute:
sam local invoke -e events/event.json
to test the code locally. Note that you'll need to modify the event.json file to include the correct links to the PDFs you want to combine, and the S3 bucket and output file name. If your event.json is correct, you'll see a result like this in the console:
$ sam local invoke -e events/event.json
Invoking app.lambda_handler (python3.7)
Fetching lambci/lambda:python3.7 Docker container image......
Mounting /Users/datnguyen/works/tiendatiowa/sam/combine-pdf/.aws-sam/build/CombinePdfFunction as /var/task:ro,delegated inside runtime container
START RequestId: fea61f91-0df7-1b00-24b1-7af880e609b1 Version: $LATEST
END RequestId: fea61f91-0df7-1b00-24b1-7af880e609b1
REPORT RequestId: fea61f91-0df7-1b00-24b1-7af880e609b1 Init Duration: 407.83 ms Duration: 646.80 ms Billed Duration: 700 ms Memory Size: 128 MB Max Memory Used: 41 MB
{"statusCode":200,"body":"{\"message\": \"Combine 2 pdfs successfully\", \"response\": {\"ResponseMetadata\": {\"RequestId\": \"EFE3CAEC05E2EFFE\", \"HostId\": \"hDj2QuWwAl9Frfq/Y1ZT5+vggMuV0e1Uxv5E8q26yRAxaxAU9CfoiW0B/xyW9o/TFKla34kMFZ4=\", \"HTTPStatusCode\": 200, \"HTTPHeaders\": {\"x-amz-id-2\": \"hDj2QuWwAl9Frfq/Y1ZT5+vggMuV0e1Uxv5E8q26yRAxaxAU9CfoiW0B/xyW9o/TFKla34kMFZ4=\", \"x-amz-request-id\": \"EFE3CAEC05E2EFFE\", \"date\": \"Thu, 05 Mar 2020 19:59:08 GMT\", \"x-amz-version-id\": \"d5DRRcbdtIXATMIdYoem2gIiRjyIST.3\", \"etag\": \"\\\"1130363fcaccbdf128bd2f574d7eb74a\\\"\", \"content-length\": \"0\", \"server\": \"AmazonS3\"}, \"RetryAttempts\": 1}, \"ETag\": \"\\\"1130363fcaccbdf128bd2f574d7eb74a\\\"\", \"VersionId\": \"d5DRRcbdtIXATMIdYoem2gIiRjyIST.3\"}}"}
If you open the S3 bucket, you should see the output file there.
In your console, execute:
sam deploy --guided
and follow the guided instruction to deploy the serverless function to AWS.
After deploying successfully, you should see a result like this:
CloudFormation outputs from deployed stack
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Outputs
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Key CombinePdfFunction
Description Combine PDF Lambda Function ARN
Value arn:aws:lambda:us-east-1:297921772302:function:combine-pdf-CombinePdfFunction-T58UWR8S6DRF
Key CombinePdfApi
Description API Gateway endpoint URL for Prod stage for Combine PDF function
Value https://vvnep4kp07.execute-api.us-east-1.amazonaws.com/Prod/combine/
Key CombinePdfFunctionIamRole
Description Implicit IAM Role created for Combine PDF function
Value arn:aws:iam::297921772302:role/combine-pdf-CombinePdfFunctionRole-5U85FXEIXR00
Notice the function name combine-pdf-CombinePdfFunction-T58UWR8S6DRF in the log above. You can then test the function using this command:
$ aws lambda invoke --function-name combine-pdf-CombinePdfFunction-T58UWR8S6DRF --payload <event in base64 format> out
{
"StatusCode": 200,
"ExecutedVersion": "$LATEST"
}
Note the "StatusCode" is 200 even if the function returns error, so to check for the return of the function, run:
$ cat out
You'll either see the success message (with code 200), or any error that the function encounters (e.g. invalid input, unable to write to S3),
similarly to when running it locally via sam local invoke.
If the return code is 200, you will see the result PDF in your bucket.