View a markdown version of this page

Debug fungsi Lambda dari jarak jauh dengan Visual Studio Code - AWS Lambda
Waktu aktif yang didukungKeamanan dan debugging jarak jauhPrasyaratMen-debug fungsi Lambda dari jarak jauhNonaktifkan debugging jarak jauhInformasi tambahan

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

Debug fungsi Lambda dari jarak jauh dengan Visual Studio Code

Dengan fitur debugging jarak jauh di AWS Toolkit for Visual Studio Code, Anda dapat men-debug fungsi Lambda Anda yang berjalan langsung di AWS cloud. Ini berguna saat menyelidiki masalah yang sulit direplikasi secara lokal atau didiagnosis hanya dengan log.

Dengan debugging jarak jauh, Anda dapat:

  • Tetapkan breakpoint dalam kode fungsi Lambda Anda.

  • Melangkah melalui eksekusi kode secara real-time.

  • Periksa variabel dan status selama runtime.

  • Debug fungsi Lambda yang digunakan AWS, termasuk yang ada di VPC atau dengan izin IAM tertentu.

Waktu aktif yang didukung

Remote debugging didukung untuk runtime berikut:

  • Python (AL2023)

  • Java

  • JavaScript/Node.js (AL2023)

catatan

Remote debugging didukung untuk arsitektur x86_64 dan arm64.

Keamanan dan debugging jarak jauh

Remote debugging beroperasi dalam batas keamanan Lambda yang ada. Pengguna dapat melampirkan lapisan ke fungsi menggunakan UpdateFunctionConfiguration izin, yang sudah memiliki kemampuan untuk mengakses variabel lingkungan fungsi dan konfigurasi. Debugging jarak jauh tidak melampaui izin yang ada ini. Sebagai gantinya, ia menambahkan kontrol keamanan ekstra melalui tunneling aman dan manajemen sesi otomatis. Selain itu, debugging jarak jauh sepenuhnya merupakan fitur yang dikendalikan pelanggan yang memerlukan izin dan tindakan eksplisit:

  • Pembuatan Terowongan Aman IoT: AWS Toolkit harus membuat terowongan aman IoT, yang hanya terjadi dengan izin eksplisit pengguna menggunakaniot:OpenTunnel.

  • Debug Layer Attachment dan Token Management: Proses debugging menjaga keamanan melalui kontrol ini:

    • Lapisan debugging harus dilampirkan ke fungsi Lambda dan proses ini memerlukan izin berikut: lambda:UpdateFunctionConfiguration danlambda:GetLayerVersion.

    • Perbarui token keamanan (dihasilkan melaluiiot:OpenTunnel) dalam variabel lingkungan fungsi sebelum setiap sesi debug. Langkah ini juga membutuhkanlambda:UpdateFunctionConfiguration.

    • Demi keamanan, token ini diputar secara otomatis dan lapisan debug dihapus secara otomatis pada akhir setiap sesi debug dan tidak dapat digunakan kembali.

catatan

Remote debugging didukung untuk arsitektur x86_64 dan arm64.

Prasyarat

Sebelum memulai debugging jarak jauh, pastikan Anda memiliki yang berikut:

  1. Fungsi Lambda diterapkan ke AWS akun Anda.

  2. AWS Toolkit for Visual Studio Code. Lihat Menyiapkan AWS Toolkit for Visual Studio Code untuk petunjuk pemasangan.

  3. Versi AWS Toolkit yang telah Anda instal adalah 3.69.0 atau yang lebih baru.

  4. AWS kredenSIAL dikonfigurasi di AWS Toolkit for Visual Studio Code. Untuk informasi selengkapnya, lihat Kontrol autentikasi dan akses.

Men-debug fungsi Lambda dari jarak jauh

Ikuti langkah-langkah ini untuk memulai sesi debugging jarak jauh:

  1. Buka AWS Explorer di VS Code dengan memilih AWS ikon di sidebar kiri.

  2. Perluas bagian Lambda untuk melihat fungsi Anda.

  3. Buka menu konteks untuk fungsi yang ingin Anda debug.

  4. Dari menu konteks, pilih Memanggil dari jarak jauh.

  5. Di jendela pemanggilan yang terbuka, centang kotak untuk Aktifkan debugging.

  6. Klik Memanggil untuk memulai sesi debugging jarak jauh.

catatan

Fungsi lambda memiliki batas gabungan 250MB untuk kode fungsi dan semua lapisan terlampir. Lapisan debugging jarak jauh menambahkan sekitar 40MB ke ukuran fungsi Anda.

Sesi debugging jarak jauh berakhir ketika Anda:

  • Pilih H apus Pengaturan Debug dari layar konfigurasi pemanggilan jarak jauh.

  • Pilih ikon pemutusan di kontrol debugging Kode VS.

  • Pilih file handler di editor Kode VS.

catatan

Lapisan debug dihapus secara otomatis setelah 60 detik tidak aktif setelah pemanggilan terakhir Anda.

Nonaktifkan debugging jarak jauh

Ada tiga cara untuk menonaktifkan fitur ini:

  • Tolak Pembaruan Fungsi: Set lambda:UpdateFunctionConfiguration el kedeny.

  • Batasi Izin IoT: Tolak IoT-related izin

  • Blok Lapisan Debug: Tolak lambda:GetLayerVersion untuk ARN berikut:

    • arn:aws:lambda:*:*:layer:LDKLayerX86:*

    • arn:aws:lambda:*:*:layer:LDKLayerArm64:*

    catatan

    Menonaktifkan fitur ini mencegah lapisan debugging ditambahkan selama pembaruan konfigurasi fungsi.

Untuk informasi lebih lanjut tentang menggunakan Lambda dalam Kode VS, lihat Mengem bangkan fungsi Lambda secara lokal dengan Kode VS.

Untuk petunjuk terperinci tentang pemecahan masalah, kasus penggunaan lanjutan, dan ketersediaan wilayah, lihat Remote debugging fungsi Lambda di Panduan AWS Toolkit for Visual Studio Code Pengguna.