This project provides the missing AWS Lambda base image for Java 17, 18, and 19. The base images are publicly available in the ECR Public Gallery. You should be able to use them directly in your builds. I use these images in production for personal projects today, but they should be considered experimental.
This project uses the following process to create new Lambda base images:
- Define a Java maven POM that includes all the Java Lambda support libraries as provided scope. This roundabout approach is used to coax @dependabot into flagging new versions as they are published.
- Also teach maven to collect these dependencies and build the appropriate docker images using the Dockerfile using the excellent fabric8io/docker-maven-plugin.
- Use GitHub Actions to do perform CI/CD and release new images to the ECR Public Gallery.
You can find an example Lambda function using these base images at aleph0io/example-java-lambda-function. It's just like building any container lambda function. For ease of use, find the Dockerfile below. Note the FROM image.
FROM public.ecr.aws/aleph0io/java/lambda:17.0.4-al2 COPY target/hello-lambda.jar "${LAMBDA_TASK_ROOT}/lib/" CMD [ "com.sigpwned.lambda.hello.HelloLambda::handleRequest" ] The Lambda RIE is not currently built into these lambda base images, so to test your lambda function implementations locally, you will need to use the standalone RIE server.
- This image is in no way optimized for cold start time, size, etc. PRs welcome!
- Java 17, 18, and 19 are all supported.
- For now, only x86_64 is supported. I hope to publish multiarch builds including arm64 soon.
- Of course, as soon as there is an offically-supported AWS Lambda base image for these Java versions, everyone should use that instead! But this project should hopefully fill the gap in the meantime, and will (hopefully) support non-LTS Java versions that will never receive an officially-supported AWS Lambda base image by that time.
You can find writeups of the Java 17 and Java 18 on my blog.
Many thanks to @rieckpil for his outstanding writeup of custom Lambda runtimes. That tutorial was the foundation and basis for this build. Cheers!
Also, thank you to @msailes for the example Java 17 Lambda layer. This prior art was also critically important to understanding how best to integrate a new Java version into Lambda.
Managed by @sigpwned.