Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # AWS Lambda Fungsi AWS Toolkit for Visual Studio Code Ini memberikan dukungan komprehensif untuk AWS Lambda fungsi, memungkinkan Anda untuk membangun, menguji, dan menyebarkan langsung dari VS Code. Lambda adalah layanan komputasi berbasis peristiwa yang dikelola sepenuhnya yang secara otomatis menjalankan kode Anda sebagai respons terhadap peristiwa dari lebih dari 200 layanan AWS dan aplikasi ( software-as-a-serviceSaaS). Untuk informasi rinci tentang AWS Lambda layanan, lihat Panduan [AWS Lambda](https://docs.aws.amazon.com/lambda/latest/dg/welcome.html)Pengembang. Topik-topik berikut menjelaskan cara bekerja dengan AWS Lambda di. AWS Toolkit for Visual Studio Code **Topics** + [Bekerja dengan AWS Lambda Fungsi](remote-lambda.md) + [AWS Lambda console ke IDE](lambda-console-ide.md) + [AWS Lambda dengan LocalStack dukungan](lambda-localstack.md) + [AWS Lambda debugging jarak jauh](lambda-remote-debug.md) # Bekerja dengan AWS Lambda Fungsi AWS Toolkit for Visual Studio Code Ini memungkinkan Anda untuk bekerja dengan AWS Lambda fungsi Anda di lingkungan VS Code lokal Anda. Dengan AWS Toolkit, Anda dapat membuat, mengedit, menguji, men-debug, dan menerapkan fungsi Lambda Anda, tanpa harus meninggalkan IDE. Untuk informasi rinci tentang AWS Lambda layanan, lihat Panduan [AWS Lambda](https://docs.aws.amazon.com//lambda/latest/dg/welcome.html)Pengembang. Bagian berikut menjelaskan cara memulai bekerja dengan fungsi Lambda di. AWS Toolkit for Visual Studio Code **catatan** Jika Anda telah membuat fungsi Lambda dengan menggunakan Konsol Manajemen AWS, maka Anda dapat memanggilnya dari Toolkit. Selain itu, Anda dapat membuka fungsi Lambda Anda ke Kode VS dari AWS Lambda console, untuk informasi tambahan, lihat [AWS Lambda console ke IDE](lambda-console-ide.md) topik di panduan pengguna ini. Untuk membuat fungsi Lambda baru di VS Code, ikuti langkah-langkah yang diuraikan dalam topik [Membuat aplikasi tanpa server baru (lokal)](https://docs.aws.amazon.com//toolkit-for-vscode/latest/userguide/sam-get-started.html#serverless-apps-create) dalam panduan pengguna ini. ## Prasyarat Ketentuan berikut harus dipenuhi untuk bekerja dengan AWS Lambda layanan di AWS Toolkit. + Versi terbaru diinstal dan diatur dengan AWS kredensi Anda. AWS Toolkit for Visual Studio Code + Izin dan kebijakan terkelola AWS Identity and Access Management (IAM) Anda dikonfigurasi untuk bekerja dengan layanan. AWS Lambda Untuk informasi terperinci tentang cara mengonfigurasi izin dan membuat kebijakan AWS terkelola yang kompatibel, lihat AWS Lambda topik [AWS Identity and Access Management untuk](https://docs.aws.amazon.com/lambda/latest/dg/security-iam.html) di *Panduan AWS Lambda Pengembang*. + Anda memiliki AWS Lambda fungsi yang ada atau terbiasa dengan cara membuatnya. *Untuk petunjuk tentang cara membuat fungsi Lambda, lihat topik [Membuat fungsi Lambda pertama Anda di Panduan Pengembang](https://docs.aws.amazon.com/lambda/latest/dg/getting-started.html).AWS Lambda * ## Memanggil Fungsi Lambda Untuk menjalankan fungsi Lambda dari akun AWS Anda ke VS Code, selesaikan langkah-langkah berikut. 1. Dari AWS Toolkit for Visual Studio Code, perluas AWS penjelajah. 1. Dari AWS penjelajah, perluas **Lambda** untuk melihat sumber daya Lambda Anda. 1. Buka menu konteks untuk (klik kanan) fungsi Lambda yang ingin Anda panggil, lalu **pilih Panggil di cloud atau pilih ikon Panggil di** cloud untuk membuka menu **konfigurasi pemanggilan jarak jauh di** **VS Code**. 1. Dari menu **konfigurasi pemanggilan jarak jauh**, tentukan pengaturan **Payload** Anda dan tambahkan informasi tambahan apa pun yang diperlukan untuk acara tersebut. **catatan** Proses pemanggilan pertama mungkin mulai berjalan segera setelah Anda memilih **Invoke di cloud** di AWS explorer. Output ditampilkan di tab **OUTPUT** dari terminal VS Code. 1. Pilih tombol **Remote Invoke** untuk menjalankan fungsi Anda, Output ditampilkan di tab **OUTPUT** dari terminal VS Code. ## Menghapus fungsi Lambda Untuk menghapus fungsi Lambda, selesaikan prosedur berikut. **Awas** Jangan gunakan prosedur ini untuk menghapus fungsi Lambda yang terkait dengannya. [CloudFormation](https://docs.aws.amazon.com/cloudformation/) Fungsi-fungsi ini harus dihapus melalui CloudFormation tumpukan Anda. 1. Dari AWS Toolkit for Visual Studio Code, perluas AWS penjelajah. 1. Dari AWS penjelajah, perluas **Lambda** untuk melihat sumber daya Lambda Anda. 1. **Klik kanan fungsi Lambda yang ingin Anda hapus, lalu pilih Hapus.** 1. Saat diminta, konfirmasikan bahwa Anda ingin menghapus fungsi Anda. Setelah fungsi dihapus, itu tidak lagi terdaftar di AWS explorer. ## Mengunduh fungsi Lambda Anda dapat mengunduh kode dari fungsi Lambda jarak jauh ke ruang kerja VS Code Anda untuk mengedit dan men-debug. **catatan** Untuk mengunduh fungsi Lambda Anda, Anda harus bekerja di ruang kerja VS Code dengan folder yang dapat diakses dan AWS Toolkit hanya mendukung fitur ini dengan fungsi Lambda menggunakan runtime Node.js dan Python. 1. Dari AWS Toolkit for Visual Studio Code, perluas AWS penjelajah. 1. Dari AWS penjelajah, perluas **Lambda** untuk melihat sumber daya Lambda Anda. 1. **Klik kanan fungsi Lambda yang ingin Anda unduh, lalu pilih Unduh.** 1. Fungsi Lambda Anda terbuka di editor VS Code dan ditampilkan di AWS explorer saat unduhan selesai. AWS Toolkit juga membuat *konfigurasi peluncuran* di panel run VS Code yang memungkinkan Anda menjalankan dan men-debug fungsi Lambda secara lokal. AWS Serverless Application Model Untuk informasi selengkapnya tentang penggunaan AWS SAM, lihat[Menjalankan dan men-debug aplikasi tanpa server dari template (lokal)](sam-get-started.md#serverless-apps-debug). ## Menyebarkan pembaruan untuk fungsi Lambda baru Anda dapat menerapkan pembaruan ke fungsi Lambda baru dari lokasi sementara yang tidak ditentukan di komputer lokal Anda. **catatan** Ketika ada perubahan yang tidak diterapkan pada file lambda Anda, Anda akan diberi tahu oleh ikon **M** yang terletak di sebelah file yang dimodifikasi di editor Kode VS dan di explorer. AWS **Menerapkan dari editor VS Code** 1. Buka file dari fungsi Lambda Anda di editor VS Code, lalu buat perubahan pada file tersebut. 1. Simpan secara manual dari menu utama Kode VS atau menekan **option\$1s** (Mac) **ctrl\$1s** (Windows). 1. VS Code secara otomatis meminta Anda tentang penerapan perubahan Anda ke cloud, pilih tombol **Deploy** untuk mengonfirmasi penerapan. 1. VS Code memperbarui status penerapan Anda dan memberi tahu Anda saat proses selesai. **Menyebarkan dari Explorer AWS** 1. Buka file dari fungsi Lambda Anda di editor VS Code, lalu buat perubahan pada file tersebut. 1. Dari AWS Toolkit, perluas AWS explorer. 1. Dari AWS penjelajah, perluas AWS wilayah dengan fungsi Lambda yang ingin Anda gunakan perubahannya. 1. Dari AWS wilayah tersebut, perluas Lambda dan navigasikan fungsi yang ingin Anda gunakan untuk perubahannya. 1. Dari menu cepat di sebelah fungsi Anda, pilih ikon **Simpan dan terapkan kode Anda**. 1. VS Code memperbarui status penerapan Anda dan memberi tahu Anda saat proses selesai. ## Mengunggah pembaruan untuk fungsi Lambda yang ada Prosedur berikut menjelaskan cara mengunggah perubahan lokal yang dibuat ke fungsi Lambda Anda yang ada. Fitur ini mendukung unggahan dengan runtime yang didukung Lambda apa pun. **Awas** Sebelum mengunggah fungsi lambda Anda, perhatikan hal-hal berikut: Memperbarui kode dengan cara ini tidak menggunakan AWS SAM CLI untuk penerapan atau membuat tumpukan CloudFormation AWS Toolkit tidak memvalidasi kode. Validasi kode Anda dan uji fungsi Anda sebelum mengunggah perubahan apa pun ke cloud. **Mengunggah Arsip Zip** 1. Dari AWS Toolkit for Visual Studio Code, perluas AWS penjelajah. 1. Dari AWS penjelajah, perluas **Lambda** untuk melihat sumber daya Lambda Anda. 1. Klik kanan fungsi Lambda yang ingin Anda unggah perubahan, lalu pilih **Unggah** Lambda... untuk membuka menu **Pilih Jenis Unggah**. 1. Pilih **Arsip ZIP** untuk menemukan `ZIP Archive` di direktori lokal Anda. 1. Saat diminta, konfirmasikan unggahan untuk memulai unggahan yang dipilih`ZIP Archive`. 1. Status unggahan Anda ditampilkan dalam Kode VS dan Anda akan diberi tahu saat proses pengunggahan selesai. **Mengunggah direktori tanpa membangun** 1. Dari AWS Toolkit for Visual Studio Code, perluas AWS penjelajah. 1. Dari AWS penjelajah, perluas **Lambda** untuk melihat sumber daya Lambda Anda. 1. Klik kanan fungsi Lambda yang ingin Anda unggah perubahan, lalu pilih **Unggah** Lambda... untuk membuka menu **Pilih Jenis Unggah**. 1. Pilih **Direktori** untuk melanjutkan ke **direktori Build** layar. 1. Dari layar **Membangun direktori**, pilih **Tidak** untuk memilih direktori lokal untuk diunggah. 1. Saat diminta, konfirmasikan unggahan untuk mengunggah direktori yang dipilih. 1. Status unggahan Anda ditampilkan dalam Kode VS dan Anda akan diberi tahu saat proses pengunggahan selesai. **Mengunggah direktori dengan build** **catatan** Ketahui hal-hal berikut: Prosedur ini membutuhkan AWS Serverless Application Model CLI. AWS Toolkit memberi tahu Anda bahwa handler yang cocok tidak dapat dideteksi sebelum mengunggah. Untuk mengubah handler yang terpasang pada fungsi Lambda Anda, gunakan tombol atau AWS Lambda console . AWS Command Line Interface 1. Dari AWS Toolkit for Visual Studio Code, perluas AWS penjelajah. 1. Dari AWS penjelajah, perluas **Lambda** untuk melihat sumber daya Lambda Anda. 1. Klik kanan fungsi Lambda yang ingin Anda unggah perubahan, lalu pilih **Unggah** Lambda... untuk membuka menu **Pilih Jenis Unggah**. 1. Pilih **Direktori** untuk melanjutkan ke **direktori Build** layar. 1. Dari layar **Build directory**, pilih **Ya**, lalu pilih direktori lokal untuk diunggah. 1. Saat diminta, konfirmasikan unggahan untuk mulai membangun dan mengunggah direktori yang dipilih. 1. Status unggahan Anda ditampilkan dalam Kode VS dan Anda akan diberi tahu saat proses pengunggahan selesai. ## Mengonversi fungsi Lambda Anda menjadi proyek AWS SAM Untuk mengonversi fungsi Lambda Anda menjadi AWS SAM tumpukan, selesaikan langkah-langkah berikut. **Awas** Saat ini, hanya sebagian sumber daya yang didukung saat mengonversi fungsi Lambda menjadi proyek. AWS SAM Untuk menemukan sumber daya yang hilang setelah konversi, periksa konsol Lambda dan tambahkan secara manual ke template Anda AWS SAM . Untuk detail tambahan tentang sumber daya yang didukung dan tidak didukung, lihat topik [dukungan jenis sumber daya](https://docs.aws.amazon.com//AWSCloudFormation/latest/UserGuide/resource-import-supported-resources.html) di *Panduan AWS CloudFormation Pengembang*. 1. Dari AWS Toolkit, perluas AWS explorer. 1. Dari AWS penjelajah, perluas AWS wilayah dengan fungsi Lambda yang ingin Anda ubah menjadi AWS SAM proyek. 1. Dari AWS wilayah tersebut, perluas Lambda dan navigasikan fungsi yang ingin Anda ubah menjadi AWS SAM tumpukan. 1. Dari menu cepat di sebelah fungsi Lambda Anda, pilih ikon **Konversi ke Aplikasi SAM untuk** menelusuri sistem file lokal Anda dan menentukan lokasi untuk proyek baru AWS SAM Anda. 1. Setelah menentukan lokasi, AWS Toolkit mulai mengubah fungsi Lambda Anda menjadi AWS SAM proyek, VS Code memberikan pembaruan tentang status proses. **catatan** Proses ini mungkin memerlukan waktu beberapa menit. 1. Saat diminta oleh VS Code, masukkan nama tumpukan, lalu tekan **Enter** tombol untuk melanjutkan. 1. VS Code terus memperbarui Anda dengan status proyek Anda, kemudian memberi tahu Anda saat proses selesai dan membuka AWS SAM proyek baru Anda sebagai ruang kerja VS Code. # AWS Lambda console ke IDE Fitur AWS Lambda console to IDE memungkinkan Anda mengunduh AWS Lambda fungsi Anda dari Kode VS AWS Lambda console ke dalam. Bekerja dengan fungsi Lambda Anda di VS Code memberi Anda akses ke opsi pengembangan lokal lainnya seperti AWS Serverless Application Model ()AWS SAM dan file. AWS Cloud Development Kit (AWS CDK) Untuk informasi selengkapnya AWS Lambda, lihat Panduan [AWS Lambda](https://docs.aws.amazon.com//lambda/latest/dg/welcome.html)Pengembang. Untuk mulai bekerja dengan fungsi Lambda Anda di AWS Toolkit, lihat topik [Bekerja dengan AWS Lambda Fungsi](https://docs.aws.amazon.com//toolkit-for-vscode/latest/userguide/remote-lambda.html) dalam panduan pengguna ini. Bagian berikut menjelaskan cara memindahkan alur kerja Anda dari konsol Lambda ke VS Code. *Untuk informasi mendetail tentang memindahkan fungsi Lambda Anda dari konsol Lambda ke VS Code, termasuk cara mulai bekerja dengan konsol Lambda, lihat topik Mengembangkan [fungsi Lambda secara lokal dengan VS Code di Panduan](https://docs.aws.amazon.com/lambda/latest/dg/foundation-iac-local-development.html) Pengembang.AWS Lambda * ## Pindah dari konsol ke pengembangan lokal Untuk membuka fungsi Lambda dari konsol Lambda di VS Code, selesaikan langkah-langkah berikut: 1. Dari browser web Anda, buka konsol [Lambda](https://console.aws.amazon.com/lambda). 1. Dari konsol Lambda, pilih fungsi yang ingin Anda buka di VS Code. 1. Dari tampilan fungsi, arahkan ke tab **Sumber kode**. 1. Dari tab **Sumber kode**, pilih **Buka di VS Code**. ## Bekerja dengan fungsi Lambda Anda di VS Code Saat fungsi Lambda Anda terbuka di VS Code melalui konsol Lambda: + VS Code secara otomatis diluncurkan di komputer lokal Anda. + Fungsi Lambda Anda terbuka sebagai ruang kerja VS Code. + Lambda Anda `handler file` terbuka di editor Kode VS. **catatan** Jika tidak ada yang dikonfigurasi dengan benar `handler file` di ruang kerja, tidak ada file yang terbuka di editor Kode VS. Membuka fungsi Lambda Anda di VS Code melalui konsol Lambda memungkinkan Anda mengakses semua fitur AWS Lambda Toolkit yang ada, termasuk kemampuan untuk mengedit kode fungsi dengan dukungan bahasa penuh, pengujian lokal, debugging jarak jauh, dukungan penerapan, dan manajemen ketergantungan. Untuk informasi selengkapnya tentang fitur Lambda yang didukung di AWS Toolkit, lihat daftar isi [AWS Lambda](https://docs.aws.amazon.com//toolkit-for-vscode/latest/userguide/building-lambda.html)layanan dalam panduan pengguna ini. # AWS Lambda dengan LocalStack dukungan Buat, uji, dan debug aplikasi tanpa server Anda dengan LocalStack dukungan di. AWS Toolkit for Visual Studio Code LocalStack adalah emulator AWS Cloud yang memungkinkan pengujian lokal aplikasi tanpa server. Untuk informasi selengkapnya AWS Lambda, lihat *Panduan [AWS Lambda](https://docs.aws.amazon.com//lambda/latest/dg/welcome.html)Pengembang*. Untuk mempelajari lebih lanjut LocalStack, kunjungi situs web mereka [LocalStack](https://www.localstack.cloud/). ## Prasyarat Berikut ini adalah prasyarat untuk bekerja dengan LocalStack di VS Code. **catatan** LocalStack *CLI diinstal selama proses pengaturan, tetapi jika Anda lebih suka versi LocalStack CLI yang berbeda, versi minium yang diperlukan adalah 4.8.0.* + Akun Aplikasi LocalStack Web diperlukan untuk akses ke semua fitur yang tersedia untuk LocalStack tingkatan gratis dan berbayar. LocalStack edisi komunitas tersedia tanpa akun. + Docker diperlukan untuk bekerja dengan LocalStack di VS Code. Untuk informasi selengkapnya tentang LocalStack persyaratan untuk Docker, lihat topik LocalStack [Docker Images](https://docs.localstack.cloud/aws/capabilities/config/docker-images/) dalam dokumentasi. LocalStack + **Direkomendasikan:** The AWS Command Line Interface (AWS CLI) membantu Anda dalam bekerja dengan layanan di lingkungan cloud simulasi Anda. ## Instalasi LocalStack Untuk menginstal versi berjenjang LocalStack gratis dan berbayar, selesaikan langkah-langkah berikut. **catatan** Untuk petunjuk tentang cara mengatur edisi LocalStack Komunitas, lihat Konten *LocalStackkomunitas* di LocalStack bagian *Menyiapkan* topik ini. 1. Dari AWS Toolkit, perluas penjelajah **APPLICATION BUILDER**. 1. Pilih tombol **Buka Walkthrough** untuk membuka tab Panduan **Mulai membangun aplikasi Anda** di editor Kode VS. 1. Dari panduan, pilih **Instal LocalStack** untuk memulai proses LocalStack instalasi di VS Code. ## Menyiapkan LocalStack Setelah Anda menginstal LocalStack ekstensi untuk VS Code, Anda mungkin melihat salah satu indikator berikut saat penyiapan diperlukan: + Di VS Code Status Bar, yang terletak di sudut kiri bawah IDE secara default, LocalStack statusnya berwarna merah. + VS Code meminta Anda untuk mengatur LocalStack. Ada dua jenis pengaturan dan konfigurasi untuk LocalStack, tergantung pada versi yang LocalStack Anda gunakan. Bagian tab berikut menjelaskan setiap proses LocalStack penyiapan. **catatan** LocalStack token autentikasi diperlukan untuk versi tingkat gratis dan berbayar. LocalStack Untuk informasi spesifik tentang LocalStack harga, lihat panduan harga [Pilih paket Anda](https://www.localstack.cloud/pricing). ### LocalStack tingkatan gratis dan berbayar Ada 2 cara untuk mengatur LocalStack. + Dari VS Code **Setup LocalStack untuk memulai** prompt, pilih tombol **Setup**. + Dari bilah status VS Code, pilih ikon LocalStack status untuk membuka prompt **Setup LocalStack to get start**, lalu pilih tombol **Setup**. Selama pengaturan, sistem melewati langkah-langkah berikut: 1. Menginstal LocalStack CLI. 1. Periksa untuk melihat apakah Anda memiliki LocalStack akun. 1. Jika Anda memiliki LocalStack akun, sistem memandu Anda melalui proses otentikasi di browser web default Anda. Demikian pula, jika Anda tidak memiliki LocalStack akun, sistem memandu Anda melalui pengaturan akun sebelum proses otentikasi. Setelah LocalStack diatur, LocalStack status diperbarui di bilah status Kode VS. **catatan** Jika Anda belum membuat AWS profil untuk LocalStack, maka yang baru secara otomatis dibuat untuk Anda sebagai bagian dari proses LocalStack penyiapan. ### LocalStack Komunitas Edisi Komunitas gratis untuk digunakan dan tidak mengharuskan Anda untuk mendaftar akun, itu berjalan dari gambar Docker yang tidak memerlukan lisensi. LocalStack Untuk detail tambahan tentang Edisi LocalStack Komunitas, lihat dokumentasi [gambar LocalStack Komunitas](https://docs.localstack.cloud/references/docker-images/). Bagian berikut menjelaskan prasyarat dan pengaturan dasar yang diperlukan untuk bekerja dengan edisi LocalStack komunitas di VS Code. **Meluncurkan instance baru** Untuk meluncurkan instance baru LocalStack Komunitas, selesaikan prosedur berikut. **catatan** Contoh berikut memulai instance kontainer LocalStack pada port 4566. Jika Anda menentukan nilai port yang berbeda, Anda harus memperbarui nilai port yang ditentukan dalam prosedur yang terletak di bagian *Configuring the AWS CLI and AWS Toolkit*. 1. Dari VS Code, buka terminal VS Code dengan menekan**ctrl \$1 `(backtick)**. 1. Masukkan yang berikut ini ke terminal. **Mac:** ``` docker run -d --name localstack_main \ >> -p 4566:4566 \ >> -v /var/run/docker.sock:/var/run/docker.sock \ >> localstack/localstack ``` **Windows:** ``` docker run -d --name localstack_main ` >> -p 4566:4566 ` >> -v /var/run/docker.sock:/var/run/docker.sock ` >> localstack/localstack ``` 1. Terminal diperbarui dengan status instance Docker Anda saat proses selesai. Instance containerized ini LocalStack memberi Anda akses ke AWS layanan yang Anda tentukan selama proses pengunduhan. **Mengkonfigurasi CLI LocalStack untuk dan Docker.** Untuk mengonfigurasi AWS CLI dan AWS Toolkit agar berfungsi LocalStack di Docker, siapkan profil baru dengan menyelesaikan langkah-langkah berikut: 1. Dari VS Code, buka terminal VS Code dengan menekan**ctrl \$1 `(backtick)**. 1. Masukkan yang berikut ini ke terminal. ``` ~/.aws/credentials [localstack] aws_access_key_id = test aws_secret_access_key = test ~/.aws/config [profile localstack] region = us-east-1 output = json endpoint_url = http://localhost:4566 [default localstack endpoint] ``` 1. AWS Toolkit mendeteksi LocalStack profil Anda dan memperbarui menu status koneksi. Setelah penyiapan, memilih LocalStack profil Anda dari bagian AWS profil bilah status membuat LocalStack sumber daya Anda terlihat di AWS penjelajah. Selain itu, Anda dapat melihat LocalStack log Anda di tab **Output** dari terminal VS Code. ## Mulai LocalStack dari VS Code Anda dapat mulai LocalStack menggunakan salah satu metode berikut: **Mulai LocalStack dari VS Code Status Bar** 1. Dari VS Code, navigasikan ke bilah status, lalu pilih LocalStack tombol **Mulai** untuk diluncurkan LocalStack. 1. Bilah Status Kode VS diperbarui ketika LocalStack telah berhasil diluncurkan. **Mulai LocalStack dari **Palet Perintah** Kode VS** 1. Dari VS Code, buka **Command Palette** dengan menekan **Cmd \$1 Shift \$1 P** (Mac) atau **Control \$1 Shift \$1 P** (Windows). 1. Dari **Command Palette**, masukkan **Start LocalStack** di bilah pencarian dan pilih dari daftar saat diisi dalam hasil. 1. Bilah Status Kode VS diperbarui ketika LocalStack telah berhasil diluncurkan. **Mulai LocalStack dari terminal VS Code** 1. Dari VS Code, buka terminal VS Code dengan menekan**ctrl \$1 `(backtick)**. 1. Dari terminal VS Code, masukkan perintah **localstack start** CLI. 1. Bilah Status Kode VS diperbarui ketika LocalStack telah berhasil diluncurkan. ## Membangun contoh aplikasi tanpa server Untuk mulai bekerja dengan LocalStack di VS Code, Anda memerlukan contoh aplikasi tanpa server. Jika Anda sudah memiliki aplikasi yang ada di AWS akun Anda, Anda dapat menerapkannya secara lokal menggunakan LocalStack atau Anda dapat membuat aplikasi baru dengan AWS Serverless Land. Untuk informasi tambahan tentang membuat aplikasi dengan Tanah Tanpa Server di AWS Toolkit, lihat topik [Bekerja dengan Tanah AWS Tanpa Server](https://docs.aws.amazon.com//toolkit-for-vscode/latest/userguide/serverlessland-overview.html) di Panduan Pengguna ini. Untuk informasi rinci tentang Serverless Land, lihat halaman landing utama aplikasi web [Serverless Land](https://serverlessland.com/). ## Menguji dan men-debug fungsi Lambda dengan LocalStack Menguji dan men-debug fungsi Lambda Anda LocalStack di ekstensi VS Code mirip dengan bekerja dengan fungsi Anda yang diterapkan ke cloud. AWS Perbedaan utamanya adalah instans AWS Toolkit Anda harus diautentikasi dengan LocalStack akun Anda untuk menyebarkan dan men-debug fungsi Anda. LocalStack **catatan** Fitur pengujian dan debugging yang dijelaskan dalam bagian ini tidak tersedia untuk edisi LocalStack Komunitas. Untuk bekerja dengan LocalStack di VS Code, sambungkan ke LocalStack profil Anda di AWS Toolkit. Saat LocalStack profil Anda aktif, bilah status VS Code menampilkan **AWS: profile:localstack (titik akhir khusus)** dengan tanda centang. Untuk informasi rinci tentang bekerja dengan fungsi Lambda Anda di AWS Toolkit, lihat topik [Bekerja dengan AWS Lambda fungsi](https://docs.aws.amazon.com//toolkit-for-vscode/latest/userguide/remote-lambda.html) dalam panduan pengguna ini. # AWS Lambda debugging jarak jauh AWS Toolkit for Visual Studio Code Ini memungkinkan Anda untuk men-debug AWS Lambda fungsi Anda yang berjalan di cloud, langsung di VS Code. Dengan debugging AWS Lambda jarak jauh, Anda dapat memeriksa fungsi yang sedang berjalan, mengatur breakpoint, memeriksa variabel, dan debugging step-through tanpa memodifikasi alur kerja pengembangan yang ada. Bagian berikut menjelaskan cara bekerja dengan debugging jarak jauh Lambda di file. AWS Toolkit for Visual Studio Code ## Cara kerja debugging jarak jauh Lambda AWS Toolkit memungkinkan debugging jarak jauh dengan memodifikasi sementara fungsi Lambda Anda dengan lapisan debugging Lambda tambahan dan memperpanjang batas waktu pemanggilan Lambda hingga 900 detik. Koneksi aman dibuat antara debugger lokal Anda dan lingkungan runtime Lambda menggunakan Tunneling Aman. AWS IoT Koneksi ini memungkinkan Anda untuk menggunakan breakpoint kode lokal Anda untuk melangkah melalui fungsi saat dijalankan dari jarak jauh. Setelah sesi debugging Anda selesai, semua modifikasi sementara secara otomatis dikembalikan ke pengaturan aslinya. ## Memulai ### Waktu aktif yang didukung Runtime berikut didukung oleh debugging jarak jauh Lambda. + Python (Amazon Linux 2023) + Java + Typescript/JavaScript/Node.js (Amazon Linux 2023) **catatan** Instans terkelola Lambda dan tipe fungsi gambar OCI tidak didukung oleh debugging jarak jauh Lambda. ### Prasyarat Sebelum Anda mulai, prasyarat berikut harus dipenuhi. + Anda harus memiliki AWS kredenal yang valid yang dikonfigurasi di Toolkit. AWS Untuk detail tambahan tentang menginstal AWS Toolkit dan mengonfigurasi kredensional Anda, lihat topik [Memulai](https://docs.aws.amazon.com//toolkit-for-vscode/latest/userguide/setting-up.html) di panduan pengguna ini. + Fungsi Lambda telah diterapkan ke akun Anda. AWS Untuk detail tentang penerapan fungsi Lambda, lihat topik [Membuat fungsi Lambda pertama](https://docs.aws.amazon.com//lambda/latest/dg/getting-started.html) Anda di Panduan Pengembang. *AWS Lambda* + Anda harus memiliki kebijakan dan izin AWS Identity and Access Management (IAM) yang sesuai untuk men-debug fungsi Anda. Untuk detail tambahan tentang izin Lambda, lihat [kebijakan AWS terkelola untuk AWS Lambda](https://docs.aws.amazon.com//lambda/latest/dg/security-iam-awsmanpol.html) topik di Panduan Pengembang. *AWS Lambda* Berikut ini adalah contoh kebijakan yang berisi izin minimum yang diperlukan untuk bekerja dengan debugging jarak jauh Lambda di Toolkit. AWS **catatan** Debugging jarak jauh diaktifkan melalui Tunneling AWS AWS IoT Aman. Ini memungkinkan debugger lokal Anda untuk membuat koneksi aman ke lingkungan runtime Lambda. ``` { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "lambda:ListFunctions", "lambda:GetFunction", "lambda:GetFunctionConfiguration", "lambda:GetLayerVersion", "lambda:UpdateFunctionConfiguration", "lambda:InvokeFunction", "lambda:PublishVersion", "lambda:DeleteFunction", "iot:OpenTunnel", "iot:RotateTunnelAccessToken", "iot:ListTunnels" ], "Resource": "*" } ] } ``` ## Mengakses debugging jarak jauh Lambda Ada dua jalur utama untuk mengakses Lambda remote debugging di AWS Toolkit: AWS explorer atau Application Builder explorer. Dari AWS penjelajah, Anda dapat mengakses debugging jarak jauh Lambda melalui node Anda. AWS Lambda Dari penjelajah Application Builder, Anda dapat mengakses debugging jarak jauh Lambda melalui proyek lokal Anda. AWS SAM **Mengakses debugging jarak jauh Lambda dari penjelajah AWS** 1. Dari VS Code, buka ekstensi AWS Toolkit. 1. Dari AWS Toolkit, perluas AWS penjelajah. 1. Dari penjelajah, perluas simpul **Lambda**. 1. Arahkan ke fungsi yang ingin Anda debug, lalu pilih ikon **Panggil jarak jauh** dari menu konteks untuk membuka layar konfigurasi pemanggilan **jarak jauh.** **Mengakses debugging jarak jauh Lambda dari penjelajah Application Builder.** 1. Dari VS Code, buka ekstensi AWS Toolkit. 1. Dari AWS Toolkit, perluas explorer pembuat aplikasi. 1. Dari penjelajah, perluas `AWS SAM` proyek yang berisi proyek Lambda yang ingin Anda debug. 1. Perluas `Lambda` fungsi yang digunakan yang ingin Anda debug. 1. Arahkan ke fungsi remote, lalu pilih ikon **Invoke remote** dari menu konteks untuk membuka layar konfigurasi **pemanggilan jarak jauh**. ## Bekerja dengan debugging jarak jauh Lambda Bagian berikut menjelaskan cara bekerja dengan debugging jarak jauh Lambda di file. AWS Toolkit for Visual Studio Code **catatan** Fungsi Lambda memiliki batas 5 lapisan dan batas gabungan 250MB untuk kode fungsi dan semua lapisan terlampir. Debugging jarak jauh Lambda membutuhkan setidaknya 1 lapisan gratis untuk dijalankan. ### Menyiapkan sesi debugging Sebelum memulai, konfigurasikan sesi debugging Anda dengan menyelesaikan prosedur berikut. 1. Buka menu **konfigurasi panggilan Jarak Jauh** dengan menyelesaikan proses debug jarak jauh *Accessing Lambda dari explorer AWS atau debugging jarak jauh* Accessing *Lambda dari prosedur explorer Application Builder, yang terletak di bagian sebelumnya*. 1. Dari menu **konfigurasi panggilan jarak jauh**, pilih kotak centang **Remote Debugging** untuk menampilkan properti debugging jarak jauh. 1. Tentukan **Local Root Path** ke file handler lokal Anda. **catatan** Jalur root lokal adalah lokasi kode sumber Anda yang cocok dengan fungsi Lambda yang diterapkan. Jika Anda bekerja dari fungsi yang di-deploy di Application Builder explorer, jalur root lokal Anda akan terdeteksi secara otomatis. Jika Anda tidak memiliki kode sumber yang disimpan secara lokal, pilih tombol **Unduh kode jarak jauh untuk mengambil kode** sumber fungsi Lambda Anda. Ini akan membuka Anda `handler file` di editor VS Code. 1. Dari bagian **Payload**, tentukan di mana data ujian-acara Anda diperoleh. ### Mengatur breakpoint dan debugging Atur breakpoint dan mulai debugging dengan menyelesaikan prosedur berikut. 1. Dari editor VS Code Anda`handler file`, klik margin selokan untuk mengatur breakpoint pada nomor baris tempat Anda ingin menjeda debugging. 1. Ketika Anda puas dengan breakpoint, kembali **ke menu konfigurasi pemanggilan jarak jauh untuk memverifikasi bahwa pengaturan Anda dikonfigurasi** dengan benar, lalu pilih tombol **Remote invoke** untuk memulai debugging. 1. AWS Toolkit memperbarui fungsi Lambda Anda dengan kemampuan debugging, membuat terowongan aman untuk sesi debugging, memanggil fungsi Anda dengan muatan yang ditentukan, lalu menjeda proses saat mencapai breakpoint. 1. **Pada jeda breakpoint, gunakan panel **RUN AND DEBUG** untuk melihat **VARIABLES**, **CALL STACK**, dan BREAKPOINTS Anda.** ### Memperbarui dan menguji fungsi Anda Untuk memodifikasi kode Anda dan menguji perubahan dengan penerapan cepat, selesaikan prosedur berikut. 1. Dengan sesi debugging Anda aktif, buat perubahan `handler file` pada editor VS Code Anda. 1. Simpan perubahan Anda (**Command\$1S on macOS**,**Ctrl\$1S on Windows**) 1. Saat diminta, konfirmasikan bahwa Anda ingin melanjutkan untuk menerapkan perubahan Anda. AWS Toolkit akan memperbarui fungsi Lambda Anda dengan kode yang dimodifikasi. 1. Lanjutkan debugging dan uji perubahan Anda dengan mengatur breakpoint baru dan memilih tombol **Remote invoke lagi**. **catatan** Atau, Anda dapat membatalkan pilihan opsi **Attach debugger** di kontrol debugging VS Code dan memilih tombol **Remote invoke** untuk menjalankan fungsi Anda tanpa debugging. ### Mengakhiri sesi debugging Masing-masing opsi berikut mengakhiri sesi debugging jarak jauh Anda dan menghapus lapisan debug dari proyek Anda. + Memilih opsi **Hapus Pengaturan Debug** dari layar **konfigurasi pemanggilan jarak jauh**. + Memilih ikon **putuskan sambungan** dari kontrol debugging VS Code. + Menutup `handler file` di editor Kode VS. **catatan** Perhatikan hal-hal berikut ini: Lapisan debug Lambda secara otomatis dihapus setelah 60 detik tidak aktif. Hitungan dimulai saat pemanggilan terakhir Anda selesai. Jika Anda membuat perubahan kode pada fungsi infrastructure-as-code (IAc) yang dikelola (AWS SAM, AWS CDK, Terraform) selama proses debugging, simpan ke proyek lokal Anda dan pertimbangkan untuk memperbarui repositori kontrol sumber Anda. Perubahan yang belum disimpan akan ditimpa saat fungsi IAc Anda di-deploy ulang. Jika Anda membuat perubahan sementara hanya untuk tujuan debugging, Anda mungkin ingin menerapkan ulang fungsi Anda dari kontrol sumber untuk memastikannya cocok dengan kode produksi Anda. ### Mendebug fungsi TypeScript Lambda dengan peta sumber Bagian berikut menjelaskan cara men-debug fungsi TypeScript Lambda Anda dengan peta sumber. #### Prasyarat Untuk men-debug fungsi TypeScript Lambda Anda, prasyarat berikut harus dipenuhi. + Anda TypeScript harus dikompilasi dengan opsi peta sumber diaktifkan. Untuk informasi tambahan, lihat topik [dukungan peta JavaScript sumber](https://code.visualstudio.com/docs/typescript/typescript-debugging#_javascript-source-map-support) dalam dokumentasi VS Code. + Peta sumber in-line tidak didukung. Anda harus menggunakan `.js.map` file terpisah untuk menyimpan peta sumber. #### Konfigurasi Untuk mengonfigurasi debugging jarak jauh Lambda untuk fungsi TypeScript Lambda di AWS Toolkit, selesaikan langkah-langkah berikut. 1. Dari AWS Toolkit, perluas AWS penjelajah. 1. Dari penjelajah, perluas simpul **Lambda**. 1. Arahkan ke fungsi yang ingin Anda konfigurasikan TypeScript, lalu pilih ikon **Panggil jarak jauh** dari menu konteks untuk membuka layar konfigurasi **pemanggilan jarak jauh**. 1. Aktifkan debugging jarak jauh dengan memilih kotak centang **Remote debugging**. 1. Konfigurasikan **Jalur Root Lokal** Anda dengan menunjuk ke direktori yang berisi Anda`TypeScript handler file`. **catatan** Di `TypeScript handler file` sinilah Anda mengatur breakpoint debugging Anda. 1. Perluas pengaturan **konfigurasi tambahan debug jarak jauh**. 1. Aktifkan pemetaan sumber dengan memilih kotak centang **Peta Sumber**. 1. Atur bidang **Keluar file** ke direktori lokal salinan fungsi Lambda Anda. **Example** Jika `app.js` dan `app.map` berada di`.aws-sam/build/HelloWorldFunction`, maka buatlah lokasi **file Keluar**`/Users/user/project/aws-sam/build/HelloWorldFunction/*`. **catatan** Jalur **file Out** harus menjadi jalur absolut. Untuk AWS SAM dan AWS CDK proyek, AWS Toolkit mendukung deteksi peta sumber otomatis. Jika bidang **Out files** dibiarkan kosong untuk proyek-proyek ini, toolkit akan secara otomatis mencoba mendeteksi lokasi peta sumber. 1. Ketika Anda puas dengan pengaturan, pilih tombol **Remote invoke** untuk mulai men-debug fungsi Anda TypeScript . ## Pemecahan masalah dan kasus penggunaan lanjutan Jika sesi debug Anda gagal, mulailah proses pemecahan masalah dengan menyelesaikan langkah-langkah ini. 1. Perbarui AWS Toolkit ke versi terbaru. 1. Segarkan tampilan web dengan menutup tampilan web **konfigurasi panggilan Remote** dan membukanya kembali. 1. Mulai ulang VS Code dengan menutupnya sepenuhnya dan membukanya kembali. 1. Buka Palet Perintah Kode VS dan masukkan perintah**AWS: Reset Lambda Remote Debugging Snapshot**, pilih saat diisi dalam hasil untuk mengatur ulang snapshot debugging jarak jauh Lambda Anda. 1. [Jika Anda tidak dapat memecahkan masalah, kirimkan masalah ke AWS Toolkit for Visual Studio Code GitHub Masalah.](https://github.com/aws/aws-toolkit-vscode/issues) ### Kasus penggunaan lanjutan: konfigurasi penandatanganan kode Debugging jarak jauh membutuhkan melampirkan lapisan debug ke fungsi Lambda Anda. Jika fungsi Anda memiliki konfigurasi penandatanganan kode diaktifkan dan diberlakukan, AWS Toolkit tidak dapat secara otomatis melampirkan lapisan debug ke fungsi Anda. Ada dua opsi untuk mengatasi masalah konfigurasi penandatanganan kode. + Hapus penandatanganan kode untuk sementara. + Gunakan layer debug yang ditandatangani. #### Menghapus penandatanganan kode untuk sementara Perbarui konfigurasi penandatanganan kode dengan menyetel`UntrustedArtifactOnDeployment : Warn`, lalu aktifkan kembali `Enforced` setelah proses debugging selesai. Untuk informasi selengkapnya, lihat [UpdateCodeSigningConfig](https://docs.aws.amazon.com//lambda/latest/api/API_UpdateCodeSigningConfig.html)referensi di *Referensi AWS Lambda API*. #### Menggunakan lapisan debug yang ditandatangani 1. Dari debugging jarak jauh Lambda di AWS Toolkit, perluas bagian konfigurasi tambahan **debug jarak jauh**. 1. Dari bagian **konfigurasi tambahan debug jarak jauh**, salin ARN layer Region Anda dari bidang penggantian **Layer**. 1. Dari AWS CLI, gunakan perintah berikut untuk men-download versi layer`aws lambda get-layer-version-by-arn --arn layer-arn`, menggantikan *layer-arn dengan layer ARN* Anda. *Untuk petunjuk rinci tentang cara mengunduh layer debug yang ditandatangani, lihat referensi [get-layer-version-by-arn di Command](https://docs.aws.amazon.com/cli/latest/reference/lambda/get-layer-version-by-arn.html) Reference.AWS CLI * 1. Tanda tangani layer dengan konfigurasi penandatanganan kode Anda dan publikasikan ke akun Anda. Untuk panduan penandatanganan dan penerbitan, lihat [Menyiapkan penandatanganan kode untuk topik AWS SAM aplikasi Anda](https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/authoring-codesigning.html) di *Panduan AWS Serverless Application Model Pengembang*. 1. **Setelah layer ditandatangani dan dipublikasikan ke akun Anda, kembali ke bagian **konfigurasi tambahan debug jarak jauh** Lambda dari debugging jarak jauh Lambda, lalu masukkan ARN layer baru ke bidang penggantian Layer.** Ketika proses selesai, debugging jarak jauh Lambda menggunakan lapisan yang ditandatangani Anda alih-alih lapisan default. ### Kasus penggunaan lanjutan: fungsi debugging dengan SnapStart atau konkurensi yang disediakan Untuk fungsi Lambda yang dikonfigurasi dengan SnapStart atau disediakan konkurensi, penerbitan versi baru membutuhkan waktu yang jauh lebih lama. Untuk mempercepat alur kerja debugging, Anda dapat mengonfigurasi debugging jarak jauh Lambda untuk memperbarui hanya `$LATEST` versi fungsi Anda alih-alih menerbitkan versi baru. 1. Dari layar **konfigurasi pemanggilan jarak jauh**, perluas pengaturan **konfigurasi tambahan Remote debug**. 1. Hapus pilihan **versi Publikasikan**. 1. AWS Toolkit sekarang hanya akan memperbarui `$LATEST` versi fungsi Anda dan men-debug menggunakannya. **catatan** Sebagai efek samping dari debugging dengan `$LATEST` versi, Anda harus menghindari lalu lintas lain yang mungkin memanggil `$LATEST` versi Anda untuk memastikan lingkungan debugging yang tidak terganggu. ### Wilayah yang didukung Kesalahan berikut terjadi ketika suatu wilayah tidak mendukung debugging jarak jauh. ``` Region ${region} doesn't support remote debugging yet ``` Berikut ini adalah daftar wilayah yang didukung. + ap-east-1 + ap-northeast-1 + ap-northeast-2 + ap-south-1 + ap-southeast-1 + ap-southeast-2 + ca-sentral-1 + eu-central-1 + eu-north-1 + eu-west-1 + eu-west-2 + eu-west-3 + me-central-1 + me-south-1 + sa-east-1 + us-east-1 + us-east-2 + us-west-1 + us-west-2 ### Lambda RequestEntityTooLargeException Fungsi Lambda memiliki batas 5 lapisan dan batas gabungan 250MB untuk kode fungsi dan semua lapisan terlampir. Lapisan debugging jarak jauh sekitar 40MB, yang dapat menyebabkan fungsi Anda melebihi batas ini jika Anda memiliki paket fungsi besar atau beberapa lapisan. Untuk detail tambahan, lihat bagian [Lambda: InvalidParameterValueException atau RequestEntityTooLargeException](https://docs.aws.amazon.com//lambda/latest/dg/troubleshooting-deployment.html#troubleshooting-deployment-InvalidParameterValueException1) topik di Panduan *AWS Lambda Pengembang*. Daftar berikut menjelaskan cara untuk memecahkan masalah dan memperbaiki kesalahan ini. + **Kurangi ukuran fungsi**: Optimalkan kode fungsi Anda dan hapus dependensi yang tidak perlu. + **Hapus lapisan yang tidak digunakan**: Hapus sementara lapisan yang tidak penting selama debugging. + **Gunakan dependensi eksternal**: Pindahkan dependensi besar ke penyimpanan eksternal, seperti Amazon S3, dan muat saat runtime. ### Memecahkan masalah debugging Java Untuk men-debug fungsi Java Lambda, Anda harus menginstal versi Java yang sama secara lokal yang cocok dengan versi runtime fungsi Lambda Anda. Misalnya, saat men-debug fungsi Java 25, Anda harus menginstal Java 25 di lingkungan lokal tempat AWS Toolkit berjalan. Jika Anda mencoba men-debug fungsi Java 25 dengan Java 21 atau versi sebelumnya yang diinstal secara lokal, debugging jarak jauh tidak akan dapat berhenti di breakpoint yang Anda tetapkan. Pastikan versi Java lokal Anda cocok dengan versi runtime fungsi Lambda Anda sebelum memulai sesi debugging. ### Kuota tunneling aman IoT terlampaui Berikut ini adalah contoh *kesalahan terlampaui kuota terowongan* yang terjadi ketika Anda telah mencapai batas harian untuk koneksi tunneling AWS IoT aman di debugging jarak jauh Lambda. ``` Error creating/reusing tunnel: LimitExceededException: Exceeded quota of Lambda debugging tunnels ``` AWS IoT Koneksi Tunneling yang aman memiliki kuota berikut: + Tunneling aman IoT tingkat bebas dialokasikan 10 koneksi per hari. + Setiap terowongan mendukung satu instance VS Code hingga 12 jam. + Kuota berlaku per AWS akun, per hari. Jika Anda mengalami kesalahan tunneling AWS IoT aman, tunggu pengaturan ulang kuota harian atau hubungi AWS dukungan untuk meminta peningkatan batas kuota. Untuk info kontak AWS dukungan, lihat [portal kontak AWS dukungan](https://aws.amazon.com/contact-us/). *Untuk informasi rinci tentang tunneling AWS IoT aman, lihat topik [tunneling AWS IoT aman](https://docs.aws.amazon.com/iot/latest/developerguide/secure-tunneling.html) di Panduan Pengembang.AWS IoT *