Fungsi Lambda menggunakan Docker Container Image -Bahagian untuk membangunkan dan menggunakan fungsi Lambda dengan Java ( runtime

pengenalan

Dalam artikel ini saya ingin meneroka cara membangunkan dan menggunakan fungsi Lambda menggunakan Imej Kontena Docker dan masa jalan Java. Dalam artikel ini saya akan menggunakan Java 21 Corretto runtime. Tetapi seperti imej kontena, kita boleh menggunakan walaupun masa jalan Java baru-baru ini seperti Java 22 dan bukan sahaja masa jalan Java sokongan jangka panjang (LTS) seperti Java 17 dan 21. Sangat mudah untuk mengemas kini contoh ini apabila versi Java yang lebih baharu akan dikeluarkan (seperti Java versi 23 pada September 2024).

Cara membangunkan dan menggunakan fungsi Lambda menggunakan imej kontena Docker asas AWS Lambda dan masa jalan Java (21)

Imej asas AWS dipramuat dengan masa jalan bahasa, klien antara muka masa jalan untuk mengurus interaksi antara Lambda dan kod fungsi anda dan emulator antara muka masa jalan untuk ujian tempatan. Untuk menggunakan imej asas AWS untuk Java, sila rujuk artikel ini.

Demi penjelasan, kami akan menggunakan aplikasi sampel kami dan menggunakan masa jalan Java 21 untuk fungsi Lambda kami.

Dalam aplikasi ini kami akan mencipta dan mendapatkan semula produk dan menggunakan DynamoDB sebagai pangkalan data NoSQL. Anda boleh menemui pelaksanaan DynamoProductDao.java di sini. Kami juga meletakkan Amazon API Gateway di hadapannya seperti yang ditakrifkan dalam templat AWS SAM. Dalam templat ini kami juga menentukan 2 fungsi Lambda : PutProductWithPureJava21DockerImage dan GetProductByIdWithPureJava21DockerImage.

Kami perlu menentukan Dockerfile di mana kami menggunakan AWS Lambda base Docker image public.ecr.aws/lambda/java:21 untuk Java 21 daripada repositori Amazon ECR awam. Di sini anda boleh menemui semua imej Lambda base Docker untuk Java yang disediakan oleh AWS.

Dalam imej Docker, kami juga menyalin kod fungsi dan kebergantungan masa jalan daripada susun atur Maven ke pembolehubah persekitaran masa jalan LAMBDA_TASK_ROOT – Laluan ke kod fungsi Lambda anda.

COPY target/classes ${LAMBDA_TASK_ROOT}
COPY target/dependency/* ${LAMBDA_TASK_ROOT}/lib/

Semua yang lain ditakrifkan dalam pengisytiharan Fungsi Lambda dalam templat SAM AWS.

 GetProductByIdFunction:
    Type: AWS::Serverless::Function
    Properties:
      FunctionName: GetProductByIdWithPureJava21DockerImage
      PackageType: Image
      ImageUri: !Sub ${AWS::AccountId}.dkr.ecr.eu-central-1.amazonaws.com/aws-pure-lambda-java21-custom-docker-image:v1
      ImageConfig:
        Command: ["software.amazonaws.example.product.handler.GetProductByIdHandler::handleRequest"]

Kepingan penting ialah:

• PackageType: Imej yang mengatakan bahawa kami membungkus fungsi Lambda kami sebagai imej kontena Docker
• ImageUri: !Sub ${AWS::AccountId}.dkr.ecr.eu-central-1.amazonaws.com/aws-pure-lambda-java21-custom-docker-image:v1 yang merujuk laluan Imej bekas Docker dalam Pendaftaran Kontena Elastik Amazon. Lebih lanjut mengenai cara untuk menolak imej di sana kemudian. -ImageConfig: Perintah: ["software.amazonaws.example.product.handler.GetProductByIdHandler::handleRequest"] ditindih CMD kepada pengendali GetProductById kami. Memandangkan CMD ini unik untuk setiap fungsi Lambda, adalah lebih baik untuk mengisytiharkannya pada tahap fungsi Lambda seperti dalam fail Docker.

Sekarang mari jawab soalan bagaimana untuk mencipta dan menolak imej kontena Docker ke repositori ECR. Anda boleh melakukannya secara automatik kemudian anda melaksanakan sam build dan sam deploy rantai arahan atau sekiranya anda membina dan membungkus aplikasi di luar SAM dan hanya menggunakan SAM anda perlu melakukannya secara manual seperti ini

Build Docker image with name aws-pure-lambda-java21-custom-docker-image:

docker build --no-cache -t aws-pure-lambda-java21-custom-docker-image:v1 .

Login to Amazon ECR in case the credentials are expired:

aws ecr get-login-password --region eu-central-1 | docker login --username AWS --password-stdin {aws_account_id}.dkr.ecr.eu-central-1.amazonaws.com  

Create Amazon ECR repository if not exists with the name aws-pure-lambda-java21-custom-docker-image:

aws ecr create-repository --repository-name aws-pure-lambda-java21-custom-docker-image --image-scanning-configuration scanOnPush=true --region eu-central-1  

Tag our local Docker image and  link it with Amazon ECR repository. Exactly this image is referenced as ImageUri in the Lambda function:

docker tag aws-pure-lambda-java21-custom-docker-image:v1 {aws_account_id}.dkr.ecr.eu-central-1.amazonaws.com/aws-pure-lambda-java21-custom-docker-image:v1

Push the Docker image to the Amazon ECR repository:
docker push {aws_account_id}.dkr.ecr.eu-central-1.amazonaws.com/aws-pure-lambda-java21-custom-docker-image:v1 

Apabila menggunakan fungsi dengan sam deploy -g, kami perlu menyediakan URL Amazon ECR tambahan menggunakan pilihan parameter sam --image-repository, lihat parameter sam deploy.

Cara membangunkan dan menggunakan fungsi Lambda menggunakan imej asas AWS OS sahaja dan masa jalan Java (21).

Imej asas AWS OS sahaja mengandungi pengedaran Amazon Linux dan emulator antara muka masa jalan. Imej ini biasanya digunakan untuk mencipta imej bekas untuk bahasa yang disusun, seperti Java dan Rust, dan untuk bahasa atau versi bahasa yang Lambda tidak menyediakan imej asas untuknya, seperti Node.js 19. Kami juga boleh menggunakan OS- hanya imej asas untuk melaksanakan masa jalan tersuai.

Jika kami ingin menggunakan imej asas OS AWS sahaja untuk Java, kami mesti memasukkan klien antara muka masa jalan dalam pengurusan imej atau pergantungan kami. Klien antara muka masa jalan memanjangkan API masa jalan Lambda, yang menguruskan interaksi antara Lambda dan kod fungsi anda.

Saya juga menyediakan contoh aplikasi untuk kes penggunaan ini.

Saya menyertakan Klien Antaramuka AWS Lambda Java Runtime dalam pom.xml seperti ini:

<dependency>
   <groupId>com.amazonaws</groupId>
   <artifactId>aws-lambda-java-runtime-interface-client</artifactId>
</dependency>

Juga Dockerfile kelihatan sedikit berbeza dalam kes ini.
Kami menggunakan amazoncorretto:21-alpine sebagai imej Docker asas dan perlu mentakrifkan titik masuk secara eksplisit menunjuk ke kelas kemasukan AWSLambda daripada AWS Lambda Java Runtime Interface Client.

ENTRYPOINT [ "/usr/bin/java", "-cp", "./*", "com.amazonaws.services.lambda.runtime.api.client.AWSLambda" ]

Semua perkara lain: Templat SAM, kod sumber dan aplikasi serta langkah pembinaan dan penggunaan imej docker kekal sama seperti dalam contoh imej bekas Docker asas AWS Lambda.

Kesimpulan

Dalam artikel ini kami meneroka cara membangunkan dan menggunakan fungsi Lambda menggunakan Imej Kontena Docker dan masa jalan Java. Kami mempertimbangkan 2 kes penggunaan:

• Imej bekas Docker pangkalan AWS Lambda
• Imej asas AWS OS sahaja

Dalam artikel seterusnya, kami akan mengukur masa mula sejuk dan panas bagi fungsi Lambda menggunakan imej bekas Docker asas Lambda AWS.

Atas ialah kandungan terperinci Fungsi Lambda menggunakan Docker Container Image -Bahagian untuk membangunkan dan menggunakan fungsi Lambda dengan Java ( runtime. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!