Bekerja dengan AWS SAM menggunakan AWS Toolkit

1. Di AWS Explorer, buka menu konteks (klik kanan) untuk simpul Lambda, lalu pilih Buat Aplikasi SAM Lambda.

   catatan

   Atau, Anda dapat memilih ikon menu di seberang judul AWS: Explorer, dan memilih Create Lambda SAM Application.

2. Pilih runtime untuk aplikasi SAM Anda. Untuk contoh ini, pilih nodejs12.x.

   catatan

   Jika Anda memilih salah satu runtime dengan “(Gambar),” aplikasi Anda adalah jenis Image paket. Jika Anda memilih salah satu runtime tanpa “(Gambar),” aplikasi Anda adalah Zip jenisnya. Untuk informasi selengkapnya tentang perbedaan antara jenis paket Image dan Zip, lihat paket deployment Lambda dalam Panduan Developer AWS Lambda .

3. Pilih salah satu templat berikut untuk aplikasi tanpa server Anda:

   • AWS SAM Hello World: Template dasar dengan fungsi Lambda yang mengembalikan pesan klasik “Hello World”.

   • AWS Step Functions Sample App: Contoh aplikasi yang menjalankan alur kerja perdagangan saham. Fungsi langkah mengatur interaksi fungsi Lambda yang terlibat.

4. Pilih lokasi untuk proyek baru Anda. Jika tersedia, Anda dapat memilih folder ruang kerja yang ada. Jika tidak, telusuri folder yang berbeda. Jika Anda memilih Pilih folder yang berbeda, kotak dialog akan ditampilkan di mana Anda dapat memilih lokasi folder.

5. Masukkan nama untuk aplikasi baru Anda. Untuk contoh ini, gunakan my-sam-app-nodejs. Setelah Anda menekan Enter, AWS Toolkit membutuhkan beberapa saat untuk membuat proyek.

Untuk menggunakan templat SAM guna menjalankan dan men-debug aplikasi nirserver

1. Untuk melihat file aplikasi Anda yang membentuk aplikasi nirserver Anda, buka jendela Lingkungan.

2. Dari folder aplikasi (misalnya, my-sample-app), buka template.yaml file.

3. Untuktemplate.yaml, pilih Edit Konfigurasi Peluncuran.

   Editor baru menampilkan file launch.json yang menyediakan konfigurasi debug dengan atribut default.

4. Edit atau konfirmasi nilai untuk properti konfigurasi berikut:

   • "name"— Masukkan nama yang ramah pembaca untuk muncul di bidang tarik-turun Konfigurasi di tampilan Jalankan.

   • "target"— Pastikan nilainya"template". Dengan begitu, template SAM adalah titik masuk untuk sesi debug.

   • "templatePath" – Masukkan jalur relatif atau absolut untuk file template.yaml.

   • "logicalId"— Pastikan bahwa nama cocok dengan yang ditentukan di bagian Sumber daya dari template SAM. Dalam hal ini, ini adalah HelloWorldFunction dari tipe AWS::Serverless::Function.

   Untuk informasi selengkapnya tentang entri ini dan entri lainnya dalam file launch.json, lihat Opsi konfigurasi untuk men-debug aplikasi nirserver.

5. Jika Anda puas dengan konfigurasi debug Anda, simpan launch.json. Kemudian, pilih tombol “putar” hijau di sebelah RUN untuk memulai debugging.

   catatan

   Jika aplikasi SAM Anda gagal dijalankan, periksa jendela Output untuk melihat apakah kesalahan tersebut disebabkan oleh citra Docker yang tidak membangun. Anda mungkin perlu mengosongkan ruang disk di lingkungan Anda.

   Untuk informasi selengkapnya, lihat Kesalahan menjalankan aplikasi SAM secara lokal di AWS Toolkit karena AWS Cloud9 lingkungan tidak memiliki cukup ruang disk.

   Saat sesi debugging dimulai, panel DEBUG CONSOLE menampilkan output debugging dan menampilkan nilai apa pun yang dikembalikan oleh fungsi Lambda. Saat men-debug aplikasi SAM, AWS Toolkit dipilih sebagai saluran Output di panel Output.

   catatan

   Untuk pengguna Windows, jika Anda melihat kesalahan pemasangan Docker selama proses ini, Anda mungkin perlu menyegarkan kredensil untuk drive bersama Anda di Pengaturan Docker. Kesalahan pemasangan Docker terlihat mirip dengan yang berikut ini.

   Fetching lambci/lambda:nodejs10.x Docker container image......
   2019-07-12 13:36:58 Mounting C:\Users\<username>\AppData\Local\Temp\ ... as /var/task:ro,delegated inside runtime container
   Traceback (most recent call last):
   ...requests.exceptions.HTTPError: 500 Server Error: Internal Server Error ...

Untuk menjalankan dan men-debug aplikasi nirserver langsung dari kode aplikasi

1. Untuk melihat file aplikasi tanpa server Anda, navigasikan ke folder aplikasi dengan memilih ikon folder di sebelah editor.

2. Dari folder aplikasi (misalnya, my-sample-app), perluas folder fungsi (dalam contoh ini, hello-world) dan buka file. app.js

3. Dalam tindakan sebaris yang mengidentifikasi fungsi penangan Lambda yang memenuhi syarat, pilih Add Debug Configuration. Jika opsi tambahkan konfigurasi debug tidak muncul, Anda harus mengaktifkan lensa kode. Untuk mengaktifkan lensa kode, lihatMengaktifkan lensa kode AWS Toolkit .

   

4. Pilih runtime tempat aplikasi SAM Anda berjalan.

5. Di editor untuk file launch.json, edit atau konfirmasi nilai untuk properti konfigurasi berikut:

   • "name" – Masukkan nama yang mudah dibaca.

   • "target" – Pastikan bahwa nilainya adalah "code" agar penangan fungsi Lambda dipanggil secara langsung.

   • "lambdaHandler" – Masukkan nama metode dalam kode Anda yang dipanggil Lambda untuk memanggil fungsi Anda. Misalnya, untuk aplikasi di JavaScript, defaultnya adalahapp.lambdaHandler.

   • "projectRoot" – Masukkan jalur ke file aplikasi yang berisi fungsi Lambda.

   • "runtime"— Masukkan atau konfirmasikan runtime yang valid untuk lingkungan eksekusi Lambda (misalnya"nodejs.12x",).

   • "payload" – Pilih salah satu opsi berikut untuk menentukan muatan peristiwa yang ingin Anda berikan ke fungsi Lambda Anda sebagai input:

     • "json": Pasangan nilai kunci berformat JSON yang menentukan muatan peristiwa.

     • "path": Jalur ke file yang digunakan sebagai muatan peristiwa.

6. Jika Anda puas dengan konfigurasi debug, pilih panah play hijau di sebelah JALANKAN untuk memulai debugging.

   Saat sesi debugging dimulai, panel DEBUG CONSOLE menampilkan output debugging dan menampilkan nilai apa pun yang dikembalikan oleh fungsi Lambda. Saat men-debug aplikasi SAM, AWS Toolkit dipilih sebagai saluran Output di panel Output.

   catatan

   Jika Anda melihat Docker disebutkan dalam pesan kesalahan, lihat catatan ini.

Untuk menjalankan dan men-debug sumber daya API Gateway lokal

1. Pilih salah satu pendekatan berikut untuk membuat konfigurasi peluncuran untuk sumber daya AWS SAM API Gateway:

   • Opsi 1: Kunjungi kode sumber handler (khususnya, file.js, .cs, atau .py) di AWS SAM proyek Anda, arahkan kursor ke handler Lambda, dan pilih Tambahkan Konfigurasi Debug Jika opsi tambahkan konfigurasi debug tidak muncul, aktifkan lensa kode. Untuk mengaktifkan lensa kode, lihatMengaktifkan lensa kode AWS Toolkit .). Kemudian, dalam menu, pilih item bertanda API Event.

   • Opsi 2: Edit launch.json dan buat konfigurasi peluncuran baru menggunakan sintaks berikut.

     {
         "type": "aws-sam",
         "request": "direct-invoke",
         "name": "myConfig",
         "invokeTarget": {
             "target": "api",
             "templatePath": "n12/template.yaml",
             "logicalId": "HelloWorldFunction"
         },
         "api": {
             "path": "/hello",
             "httpMethod": "post",
             "payload": {
                 "json": {}
             }
         }, 
         "sam": {},
         "aws": {}
     }
                             

2. Di menu tarik-turun di sebelah tombol Run, pilih konfigurasi peluncuran (dinamai myConfig dalam contoh sebelumnya).

3. (Opsional) Tambahkan titik henti ke kode proyek Lambda Anda.

4. Pilih tombol jalankan di sebelah tombol “play” hijau.

5. Di panel output, lihat hasilnya.

1. Di jendela AWS Explorer, buka menu konteks (klik kanan) untuk simpul Lambda dan pilih Sync SAM Application.

2. Pilih Wilayah AWS untuk menyebarkan ke.

3. Pilih file template.yaml yang akan digunakan untuk deployment.

4. Masukkan nama bucket Amazon S3 yang dapat digunakan penerapan ini. Bucket harus berada di Wilayah tempat Anda menerapkan.

   Awas

   Nama bucket Amazon S3 harus unik secara global di semua nama bucket yang ada di Amazon S3. Tambahkan pengenal unik ke nama yang diberikan dalam contoh berikut atau pilih nama lain.

5. Jika aplikasi nirserver Anda menyertakan fungsi dengan tipe paket Image, masukkan nama repositori Amazon ECR yang dapat digunakan oleh deployment ini. Repositori harus berada di Wilayah tempat Anda men-deploy.

6. Masukkan nama untuk tumpukan yang di-deploy, baik nama tumpukan baru atau nama tumpukan yang sudah ada.

7. Verifikasi keberhasilan deployment pada tab AWS Toolkit di Konsol.

   Jika terjadi kesalahan, pesan muncul di kanan bawah.

   Jika hal ini terjadi, periksa teks di tab AWS Toolkit untuk detailnya. Berikut ini adalah contoh detail kesalahan.

   Error with child process: Unable to upload artifact HelloWorldFunction referenced by CodeUri parameter of HelloWorldFunction resource.
   S3 Bucket does not exist. Execute the command to create a new bucket
   aws s3 mb s3://pbart-my-sam-app-bucket
   An error occurred while deploying a SAM Application. Check the logs for more information by running the "View AWS Toolkit Logs" command from the Command Palette.

   Dalam contoh ini, kesalahan terjadi karena bucket Amazon S3 tidak ada.