View a markdown version of this page

Debug dari jarak jauh Fungsi Acara Lambda dengan Kode Visual Studio - AWS Lambda
Waktu aktif yang didukungKeamanan dan debugging jarak jauhPrasyaratDebug dari jarak jauh Fungsi Acara LambdaNonaktifkan 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 dari jarak jauh Fungsi Acara Lambda dengan Kode Visual Studio

Dengan fitur debugging jarak jauh di AWS Toolkit for Visual Studio Code, Anda dapat men-debug Fungsi Peristiwa Lambda yang berjalan langsung di cloud. AWS 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 Peristiwa Lambda Anda.

  • Melangkah melalui eksekusi kode secara real-time.

  • Periksa variabel dan status selama runtime.

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

Waktu aktif yang didukung

Debugging jarak jauh didukung untuk runtime berikut:

  • Python (AL2023)

  • Java

  • JavaScript/Node.js (AL2023)

catatan

Debugging jarak jauh didukung untuk arsitektur x86_64 dan arm64.

Keamanan dan debugging jarak jauh

Debugging jarak jauh beroperasi dalam batas keamanan Lambda yang ada. Pengguna dapat melampirkan lapisan ke Fungsi Acara menggunakan UpdateFunctionConfiguration izin, yang sudah memiliki kemampuan untuk mengakses variabel dan konfigurasi lingkungan Fungsi Acara. Debugging jarak jauh tidak melampaui izin yang ada ini. Sebaliknya, 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 menggunakan. iot:OpenTunnel

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

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

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

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

catatan

Debugging jarak jauh didukung untuk arsitektur x86_64 dan arm64.

Prasyarat

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

  1. Fungsi Peristiwa Lambda diterapkan ke akun Anda. AWS

  2. AWS Toolkit for Visual Studio Code. Lihat Menyiapkan AWS Toolkit for Visual Studio Code petunjuk penginstalan.

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

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

Debug dari jarak jauh Fungsi Acara Lambda

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 Acara Anda.

  3. Buka menu konteks untuk Fungsi Acara 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

Lambda Event Functions memiliki batas gabungan 250MB untuk kode Fungsi Acara dan semua lapisan terlampir. Lapisan debugging jarak jauh menambahkan sekitar 40MB ke ukuran Event Function Anda.

Sesi debugging jarak jauh berakhir saat Anda:

  • Pilih Hapus Pengaturan Debug dari layar konfigurasi panggilan jarak jauh.

  • Pilih ikon putuskan sambungan di kontrol debugging VS Code.

  • Pilih file handler di editor VS Code.

catatan

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

Nonaktifkan debugging jarak jauh

Ada tiga cara untuk menonaktifkan fitur ini:

  • Tolak Pembaruan Fungsi: Setel lambda:UpdateFunctionConfiguration kedeny.

  • Batasi Izin IoT: Tolak izin IoT-related

  • Blokir 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 Acara.

Untuk informasi lebih lanjut tentang penggunaan Lambda di VS Code, lihat Mengembangkan fungsi Lambda secara lokal dengan VS Code.

Untuk petunjuk mendetail tentang pemecahan masalah, kasus penggunaan lanjutan, dan ketersediaan wilayah, lihat Fungsi Lambda debugging jarak jauh di Panduan Pengguna. AWS Toolkit for Visual Studio Code