View a markdown version of this page

Bekerja dengan lapisan untuk fungsi Java Lambda - AWS Lambda
Package konten layer AndaBuat layer di LambdaTambahkan layer ke fungsi Anda

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Bekerja dengan lapisan untuk fungsi Java Lambda

Gunakan lapisan Lambda untuk mengemas kode dan dependensi yang ingin Anda gunakan kembali di beberapa fungsi. Lapisan biasanya berisi dependensi pustaka, runtime kustom, atau file konfigurasi. Membuat layer melibatkan tiga langkah umum:

  1. Package konten layer Anda. Ini berarti membuat arsip file.zip yang berisi dependensi yang ingin Anda gunakan dalam fungsi Anda.

  2. Buat layer di Lambda.

  3. Tambahkan layer ke fungsi Anda.

Package konten layer Anda

Untuk membuat layer, bundel paket Anda ke dalam arsip file.zip yang memenuhi persyaratan berikut:

  • Pastikan bahwa versi Java yang mengacu pada Maven atau Gradle sama dengan versi Java dari fungsi yang ingin Anda gunakan. Misalnya, untuk fungsi Java 25, mvn -v perintah harus mencantumkan Java 25 di output.

  • Dependensi Anda harus disimpan di java/lib direktori, di root file.zip. Untuk informasi selengkapnya, lihat Jalur lapisan untuk setiap runtime Lambda.

  • Paket-paket di layer Anda harus kompatibel dengan Linux. Fungsi Lambda berjalan di Amazon Linux.

Anda dapat membuat lapisan yang berisi pustaka Java pihak ketiga atau modul dan paket Java Anda sendiri. Prosedur berikut menggunakan Maven. Anda juga dapat menggunakan Gradle untuk mengemas konten layer Anda.

Untuk membuat layer menggunakan dependensi Maven

  1. Buat proyek Apache Maven dengan pom.xml file yang mendefinisikan dependensi Anda.

    Contoh berikut termasuk Jackson Databind untuk pemrosesan JSON. Bagian ini menggunakan maven-dependency-pluginuntuk membuat file JAR terpisah untuk setiap dependensi alih-alih menggabungkannya ke dalam satu uber-jar. Jika Anda ingin membuat uber-jar, gunakan. maven-shade-plugin

    contoh pom.xml
    
    
        com.fasterxml.jackson.core
        jackson-databind
        2.17.0
    



    
        
            org.apache.maven.plugins
            maven-compiler-plugin
            3.13.0
            
                21
                21
                21
            
        
        
        
            org.apache.maven.plugins
            maven-dependency-plugin
            3.6.1
            
                
                    copy-dependencies
                    package
                    
                        copy-dependencies
                    
                    
                        ${project.build.directory}/lib

  2. Bangun proyek. Perintah ini menciptakan semua file JAR ketergantungan dalam target/lib/ direktori.

    mvn clean package

  3. Buat struktur direktori yang diperlukan untuk layer Anda:

    mkdir -p java/lib

  4. Salin file JAR ketergantungan ke java/lib direktori:

    cp target/lib/*.jar java/lib/

  5. Zip konten lapisan:

    Linux/macOS
    zip -r layer.zip java/
    PowerShell
    Compress-Archive -Path .\java -DestinationPath .\layer.zip

    Struktur direktori file.zip Anda akan terlihat seperti ini:

    java/              
└── lib/
    ├── jackson-databind-2.17.0.jar
    ├── jackson-core-2.17.0.jar
    └── jackson-annotations-2.17.0.jar
    catatan

    Pastikan file.zip Anda menyertakan java direktori di tingkat root dengan lib di dalamnya. Struktur ini memastikan bahwa Lambda dapat menemukan dan mengimpor pustaka Anda. Setiap dependensi disimpan sebagai file JAR terpisah daripada dibundel ke dalam uber-jar.

Buat layer di Lambda

Anda dapat mempublikasikan layer Anda menggunakan konsol AWS CLI atau Lambda.

AWS CLI

Jalankan publish-layer-version AWS CLI perintah untuk membuat layer Lambda:

aws lambda publish-layer-version --layer-name my-layer --zip-file fileb://layer.zip --compatible-runtimes java25

Parameter runtime yang kompatibel adalah opsional. Saat ditentukan, Lambda menggunakan parameter ini untuk memfilter lapisan di konsol Lambda.

Console
Untuk membuat lapisan (konsol)

  1. Buka halaman Fungsi di konsol Lambda.

  2. Pilih Buat lapisan.

  3. Pilih Unggah file.zip, lalu unggah arsip.zip yang Anda buat sebelumnya.

  4. (Opsional) Untuk runtime yang kompatibel, pilih runtime Java yang sesuai dengan versi Java yang Anda gunakan untuk membangun layer Anda.

  5. Pilih Buat.

Tambahkan layer ke fungsi Anda

AWS CLI

Untuk melampirkan layer ke fungsi Anda, jalankan update-function-configuration AWS CLI perintah. Untuk --layers parameter, gunakan lapisan ARN. ARN harus menentukan versi (misalnya,arn:aws:lambda:us-east-1:123456789012:layer:my-layer:1). Untuk informasi selengkapnya, lihat Lapisan dan versi lapisan.

aws lambda update-function-configuration --function-name my-function --cli-binary-format raw-in-base64-out --layers "arn:aws:lambda:us-east-1:123456789012:layer:my-layer:1"

cli-binary-formatOpsi ini diperlukan jika Anda menggunakan AWS CLI versi 2. Untuk menjadikan ini pengaturan default, jalankanaws configure set cli-binary-format raw-in-base64-out. Untuk informasi selengkapnya, lihat opsi baris perintah global yang AWS CLI didukung di Panduan AWS Command Line Interface Pengguna untuk Versi 2.

Console
Untuk menambahkan lapisan ke fungsi

  1. Buka halaman Fungsi di konsol Lambda.

  2. Pilih fungsinya.

  3. Gulir ke bawah ke bagian Layers, lalu pilih Add a layer.

  4. Di bawah Pilih layer, pilih Custom layers, dan kemudian pilih layer Anda.

    catatan

    Jika Anda tidak menambahkan runtime yang kompatibel saat membuat layer, layer Anda tidak akan tercantum di sini. Anda dapat menentukan lapisan ARN sebagai gantinya.

  5. Pilih Tambahkan.