Mengurangi waktu SDK startup untuk AWS Lambda

Salah satu tujuannya AWS SDK for Java 2.x adalah untuk mengurangi latensi startup untuk AWS Lambda fungsi. SDKBerisi perubahan yang mengurangi waktu startup, yang dibahas di akhir topik ini.

Pertama, topik ini berfokus pada perubahan yang dapat Anda lakukan untuk mengurangi waktu mulai dingin. Ini termasuk membuat perubahan dalam struktur kode Anda dan dalam konfigurasi klien layanan.

Gunakan HTTP klien AWS CRT berbasis

Untuk bekerja dengan AWS Lambda, kami merekomendasikan skenario AwsCrtHttpClientuntuk sinkron dan AwsCrtAsyncHttpClientuntuk skenario asinkron.

Konfigurasikan HTTP klien AWS CRT berbasisTopik dalam panduan ini menjelaskan manfaat menggunakan HTTP klien, cara menambahkan ketergantungan, dan cara mengonfigurasi penggunaannya oleh klien layanan.

Hapus dependensi HTTP klien yang tidak digunakan

Seiring dengan penggunaan eksplisit klien AWS CRT berbasis, Anda dapat menghapus HTTP klien lain yang SDK dibawa secara default. Waktu startup Lambda berkurang ketika lebih sedikit pustaka yang perlu dimuat, jadi Anda harus menghapus artefak yang tidak terpakai yang perlu dimuat. JVM

Cuplikan berikut dari pom.xml file Maven menunjukkan pengecualian klien berbasis Apache HTTP dan klien berbasis Netty. HTTP (Klien ini tidak diperlukan saat Anda menggunakan klien AWS CRT berbasis.) Contoh ini mengecualikan artefak HTTP klien dari ketergantungan klien S3 dan menambahkan aws-crt-client artefak untuk memungkinkan akses ke klien berbasis. AWS CRT HTTP

<project>
    <properties>
        <aws.java.sdk.version>2.27.21</aws.java.sdk.version>
    <properties>
    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>software.amazon.awssdk</groupId>
                <artifactId>bom</artifactId>
                <version>${aws.java.sdk.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>software.amazon.awssdk</groupId>
            <artifactId>aws-crt-client</artifactId>
        </dependency>
        <dependency>
            <groupId>software.amazon.awssdk</groupId>
            <artifactId>s3</artifactId>
            <exclusions>
                <exclusion>
                    <groupId>software.amazon.awssdk</groupId>
                    <artifactId>netty-nio-client</artifactId>
                </exclusion>
                <exclusion>
                    <groupId>software.amazon.awssdk</groupId>
                    <artifactId>apache-client</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
    </dependencies>
</project>

catatan

Tambahkan <exclusions> elemen ke semua dependensi klien layanan di file Andapom.xml.

Konfigurasikan klien layanan untuk memintas pencarian

Tentukan wilayah

Saat Anda membuat klien layanan, panggil region metode pada pembuat klien layanan. Ini memintas SDK proses pencarian Wilayah default yang memeriksa beberapa tempat untuk informasi. Wilayah AWS

Untuk menjaga kode Lambda independen dari wilayah, gunakan kode berikut di dalam metode. region Kode ini mengakses variabel AWS_REGION lingkungan yang ditetapkan oleh wadah Lambda.

Region.of(System.getenv(SdkSystemSetting.AWS_REGION.environmentVariable()))

Gunakan EnvironmentVariableCredentialProvider

Sama seperti perilaku pencarian default untuk informasi Wilayah, SDK terlihat di beberapa tempat untuk kredensil. Dengan menentukan EnvironmentVariableCredentialProviderkapan Anda membangun klien layanan, Anda menghemat waktu dalam proses SDK pencarian kredensional.

catatan

Menggunakan penyedia kredensi ini memungkinkan kode untuk digunakan dalam Lambda fungsi, tetapi mungkin tidak berfungsi pada Amazon EC2 atau sistem lain.

Jika Anda berniat menggunakan Lambda SnapStart untuk Java di beberapa titik, Anda harus mengandalkan rantai penyedia kredensi default untuk mencari kredensil. Jika Anda menentukanEnvironmentVariableCredentialsProvider, pencarian kredensial awal berfungsi, tetapi ketika SnapStart diaktifkan, runtime Java menetapkan variabel lingkungan kredensi kontainer. Pada aktivasi, variabel lingkungan yang digunakan oleh variabel lingkungan kunci EnvironmentVariableCredentialsProvider akses — tidak tersedia untuk Java. SDK

Cuplikan kode berikut menunjukkan klien layanan S3 yang dikonfigurasi dengan tepat untuk digunakan di lingkungan Lambda.

S3Client s3Client = S3Client.builder()
    .region(Region.of(System.getenv(SdkSystemSetting.AWS_REGION.environmentVariable())))
    .credentialsProvider(EnvironmentVariableCredentialsProvider.create())
    .httpClient(AwsCrtHttpClient.builder().build())
    .build();

Inisialisasi SDK klien di luar penangan fungsi Lambda

Kami merekomendasikan untuk menginisialisasi SDK klien di luar metode penangan Lambda. Dengan cara ini, jika konteks eksekusi digunakan kembali, inisialisasi klien layanan dapat dilewati. Dengan menggunakan kembali instance klien dan koneksinya, pemanggilan berikutnya dari metode handler terjadi lebih cepat.

Dalam contoh berikut, S3Client instance diinisialisasi dalam konstruktor menggunakan metode pabrik statis. Jika wadah yang dikelola oleh lingkungan Lambda digunakan kembali, instance yang diinisialisasi S3Client akan digunakan kembali.

public class App implements RequestHandler<Object, Object> {
    private final S3Client s3Client;

    public App() {
        s3Client = DependencyFactory.s3Client();
    }

    @Override
    public Object handle Request(final Object input, final Context context) {
         ListBucketResponse response = s3Client.listBuckets();
         // Process the response.
    }
}

Minimalkan injeksi ketergantungan

Kerangka kerja injeksi ketergantungan (DI) mungkin membutuhkan waktu tambahan untuk menyelesaikan proses penyiapan. Mereka mungkin juga memerlukan dependensi tambahan, yang membutuhkan waktu untuk memuat.

Jika kerangka kerja DI diperlukan, kami sarankan menggunakan kerangka kerja DI ringan seperti Dagger.

Gunakan penargetan Maven Archetype AWS Lambda

SDKTim AWS Java telah mengembangkan template Maven Archetype untuk mem-bootstrap proyek Lambda dengan waktu startup minimal. Anda dapat membangun proyek Maven dari pola dasar dan mengetahui bahwa dependensi dikonfigurasi sesuai untuk lingkungan Lambda.

Untuk mempelajari lebih lanjut tentang arketipe dan bekerja melalui contoh penyebaran, lihat posting blog ini.

Pertimbangkan Lambda SnapStart untuk Java

Jika persyaratan runtime Anda kompatibel, AWS tawarkan SnapStart Lambda untuk Java. Lambda SnapStart adalah solusi berbasis infrastruktur yang meningkatkan kinerja startup untuk fungsi Java. Saat Anda mempublikasikan versi baru suatu fungsi, Lambda SnapStart menginisialisasinya dan mengambil snapshot memori dan status disk yang tidak dapat diubah dan terenkripsi. SnapStart kemudian menyimpan snapshot untuk digunakan kembali.

Perubahan versi 2.x yang memengaruhi waktu startup

Selain perubahan yang Anda buat pada kode Anda, versi 2.x SDK untuk Java mencakup tiga perubahan utama yang mengurangi waktu startup:

• Penggunaan jackson-jr, yang merupakan pustaka serialisasi yang meningkatkan waktu inisialisasi

• Penggunaan pustaka java.time untuk objek tanggal dan waktu, yang merupakan bagian dari JDK

• Penggunaan SLF4j untuk fasad penebangan

Sumber daya tambahan

Panduan AWS Lambda Pengembang berisi bagian tentang praktik terbaik untuk mengembangkan fungsi Lambda yang tidak spesifik untuk Java.

Untuk contoh membangun aplikasi cloud-native di Java yang menggunakan AWS Lambda, lihat konten lokakarya ini. Optimalisasi kinerja diskusi lokakarya dan praktik terbaik lainnya.

Anda dapat mempertimbangkan untuk menggunakan gambar statis yang dikompilasi sebelumnya untuk mengurangi latensi startup. Misalnya, Anda dapat menggunakan SDK untuk Java 2.x dan Maven untuk membangun gambar asli GraalVM.