Bekerja dengan lapisan untuk fungsi Java Lambda

Lapisan Lambda adalah arsip file.zip yang berisi kode atau data tambahan. Lapisan biasanya berisi dependensi pustaka, runtime kustom, atau file konfigurasi. Membuat layer melibatkan tiga langkah umum:

Topik ini berisi langkah-langkah dan panduan tentang cara mengemas dan membuat lapisan Java Lambda dengan dependensi pustaka eksternal dengan benar.

Prasyarat

Untuk mengikuti langkah-langkah di bagian ini, Anda harus memiliki yang berikut:

Apache Maven 3.8.6
...
Java version: 21.0.2, vendor: Oracle Corporation, runtime: /Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home
...

Sepanjang topik ini, kami mereferensikan layer-javacontoh aplikasi pada repositori awsdocs GitHub . Aplikasi ini berisi skrip yang mengunduh dependensi dan menghasilkan lapisan. Aplikasi ini juga berisi fungsi yang sesuai yang menggunakan dependensi dari lapisan. Setelah membuat layer, Anda dapat menerapkan dan memanggil fungsi yang sesuai untuk memverifikasi bahwa semuanya berfungsi dengan baik. Karena Anda menggunakan runtime Java 21 untuk fungsi, lapisan juga harus kompatibel dengan Java 21.

Aplikasi layer-java sampel berisi satu contoh dalam dua sub-direktori. layerDirektori berisi pom.xml file yang mendefinisikan dependensi lapisan, serta skrip untuk menghasilkan lapisan. functionDirektori berisi fungsi sampel untuk membantu menguji bahwa lapisan berfungsi. Tutorial ini berjalan melalui cara membuat dan mengemas layer ini.

Kompatibilitas lapisan Java dengan Amazon Linux

Langkah pertama untuk membuat layer adalah untuk menggabungkan semua konten layer Anda ke dalam arsip file.zip. Karena fungsi Lambda berjalan di Amazon Linux, konten layer Anda harus dapat dikompilasi dan dibangun di lingkungan Linux.

Kode Java dirancang untuk menjadi platform-independen, sehingga Anda dapat mengemas lapisan Anda pada mesin lokal Anda bahkan jika itu tidak menggunakan lingkungan Linux. Setelah Anda mengunggah lapisan Java ke Lambda, itu akan tetap kompatibel dengan Amazon Linux.

Jalur lapisan untuk runtime Java

Saat Anda menambahkan lapisan ke fungsi, Lambda memuat konten lapisan ke dalam /opt direktori lingkungan eksekusi itu. Untuk setiap runtime Lambda, PATH variabel sudah menyertakan jalur folder tertentu dalam direktori. /opt Untuk memastikan bahwa Lambda mengambil konten layer Anda, file layer.zip Anda harus memiliki dependensinya di jalur folder berikut:

Misalnya, file layer zip yang dihasilkan yang Anda buat dalam tutorial ini memiliki struktur direktori berikut:

layer_content.zip
└ java
    └ lib
        └ layer-java-layer-1.0-SNAPSHOT.jar

File layer-java-layer-1.0-SNAPSHOT.jar JAR (sebuah uber-jar yang berisi semua dependensi yang diperlukan) terletak dengan benar di direktori. java/lib Ini memastikan bahwa Lambda dapat menemukan pustaka selama pemanggilan fungsi.

Mengemas konten lapisan

Dalam contoh ini, Anda mengemas dua pustaka Java berikut ke dalam satu file JAR:

Selesaikan langkah-langkah berikut untuk menginstal dan mengemas konten lapisan.

Membuat layer

Di bagian ini, Anda mengambil layer_content.zip file yang Anda buat di bagian sebelumnya dan mengunggahnya sebagai lapisan Lambda. Anda dapat mengunggah layer menggunakan AWS Management Console atau Lambda API melalui AWS Command Line Interface ()AWS CLI. Saat Anda mengunggah file layer .zip Anda, dalam PublishLayerVersion AWS CLI perintah berikut, tentukan java21 sebagai runtime yang kompatibel dan arm64 sebagai arsitektur yang kompatibel.

aws lambda publish-layer-version --layer-name java-jackson-layer \
    --zip-file fileb://layer_content.zip \
    --compatible-runtimes java21 \
    --compatible-architectures "arm64"

Dari tanggapan, perhatikanLayerVersionArn, yang terlihat sepertiarn:aws:lambda:us-east-1:123456789012:layer:java-jackson-layer:1. Anda akan memerlukan Amazon Resource Name (ARN) ini di langkah berikutnya dari tutorial ini, ketika Anda menambahkan layer ke fungsi Anda.

Menambahkan layer ke fungsi Anda

Di bagian ini, Anda menyebarkan contoh fungsi Lambda yang menggunakan pustaka Jackson dalam kode fungsinya, lalu Anda melampirkan layer. Untuk menyebarkan fungsi, Anda memerlukan file. Mendefinisikan izin fungsi Lambda dengan peran eksekusi Jika Anda tidak memiliki peran eksekusi yang ada, ikuti langkah-langkah di bagian yang dapat dilipat.

Kode fungsi Lambda mengambil input Map<String, String> as, dan menggunakan Jackson untuk menulis input sebagai String JSON sebelum mengubahnya menjadi objek Java F1Car yang telah ditentukan sebelumnya. Akhirnya, fungsi menggunakan bidang dari objek F1Car untuk membangun String yang fungsi kembali.

package example;

import com.amazonaws.services.lambda.runtime.Context;
import com.fasterxml.jackson.databind.ObjectMapper;

import java.io.IOException;
import java.util.Map;

public class Handler {

    public String handleRequest(Map<String, String> input, Context context) throws IOException {
        // Parse the input JSON
        ObjectMapper objectMapper = new ObjectMapper();
        F1Car f1Car = objectMapper.readValue(objectMapper.writeValueAsString(input), F1Car.class);

        StringBuilder finalString = new StringBuilder();
        finalString.append(f1Car.getDriver());
        finalString.append(" is a driver for team ");
        finalString.append(f1Car.getTeam());
        return finalString.toString();
    }
}