Tutorial: Membangun runtime khusus

Untuk membuat peran eksekusi

1. Buka halaman peran di IAM konsol.

2. Pilih Buat peran.

3. Buat peran dengan properti berikut.

   • Entitas tepercaya – Lambda.

   • Izin — AWSLambdaBasicExecutionRole.

   • Nama peran – lambda-role.

   AWSLambdaBasicExecutionRoleKebijakan ini memiliki izin yang diperlukan fungsi untuk menulis log ke CloudWatch Log.

1. Buat direktori untuk proyek, dan kemudian beralih ke direktori itu.

   mkdir runtime-tutorial
   cd runtime-tutorial

2. Buat file baru bernamabootstrap. Ini adalah runtime khusus.

   contoh bootstrap

   #!/bin/sh
   
   set -euo pipefail
   
   # Initialization - load function handler
   source $LAMBDA_TASK_ROOT/"$(echo $_HANDLER | cut -d. -f1).sh"
   
   # Processing
   while true
   do
     HEADERS="$(mktemp)"
     # Get an event. The HTTP request will block until one is received
     EVENT_DATA=$(curl -sS -LD "$HEADERS" "http://${AWS_LAMBDA_RUNTIME_API}/2018-06-01/runtime/invocation/next")
   
     # Extract request ID by scraping response headers received above
     REQUEST_ID=$(grep -Fi Lambda-Runtime-Aws-Request-Id "$HEADERS" | tr -d '[:space:]' | cut -d: -f2)
   
     # Run the handler function from the script
     RESPONSE=$($(echo "$_HANDLER" | cut -d. -f2) "$EVENT_DATA")
   
     # Send the response
     curl "http://${AWS_LAMBDA_RUNTIME_API}/2018-06-01/runtime/invocation/$REQUEST_ID/response"  -d "$RESPONSE"
   done

   Waktu pengoperasian memuat skrip fungsi dari paket deployment. Runtime menggunakan dua variabel untuk menemukan skrip.LAMBDA_TASK_ROOT memberi tahu tempat paket diekstrak, dan _HANDLER mencakup nama skrip.

   Setelah runtime memuat skrip fungsi, ia menggunakan runtime API untuk mengambil acara pemanggilan dari Lambda, meneruskan acara ke handler, dan memposting respons kembali ke Lambda. Untuk mendapatkan ID permintaan, runtime menyimpan header dari API respons ke file sementara, dan membaca Lambda-Runtime-Aws-Request-Id header dari file.

   catatan

   Waktu pengoperasian memiliki tanggung jawab tambahan, termasuk penanganan kesalahan, dan memberikan informasi konteks kepada penangan. Untuk detailnya, lihat Persyaratan.

3. Buat skrip untuk fungsi tersebut. Contoh skrip berikut mendefinisikan fungsi handler yang mengambil data peristiwa, log kestderr, dan mengembalikannya.

   contoh function.sh

   function handler () {
     EVENT_DATA=$1
     echo "$EVENT_DATA" 1>&2;
     RESPONSE="Echoing request: '$EVENT_DATA'"
   
     echo $RESPONSE
   }

   runtime-tutorialDirektori sekarang akan terlihat seperti ini:

   runtime-tutorial
   ├ bootstrap
   └ function.sh

4. Buat file dapat dijalankan dan tambahkan ke arsip file .zip. Ini adalah paket penyebaran.

   chmod 755 function.sh bootstrap
   zip function.zip function.sh bootstrap

5. Buat fungsi bernama bash-runtime. Untuk--role, masukkan peran ARN eksekusi Lambda Anda.

   aws lambda create-function --function-name bash-runtime \
   --zip-file fileb://function.zip --handler function.handler --runtime provided.al2023 \
   --role arn:aws:iam::123456789012:role/lambda-role

6. Memanggil fungsi.

   aws lambda invoke --function-name bash-runtime --payload '{"text":"Hello"}' response.txt --cli-binary-format raw-in-base64-out

   cli-binary-formatOpsi ini diperlukan jika Anda menggunakan AWS CLI versi 2. Untuk menjadikan ini pengaturan default, jalankanaws configure set cli-binary-format raw-in-base64-out. Untuk informasi selengkapnya, lihat opsi baris perintah global yang AWS CLI didukung di Panduan AWS Command Line Interface Pengguna untuk Versi 2.

   Anda akan melihat tanggapan seperti ini:

   {
       "StatusCode": 200,
       "ExecutedVersion": "$LATEST"
   }

7. Verifikasi responsnya.

   cat response.txt

   Anda akan melihat tanggapan seperti ini:

   Echoing request: '{"text":"Hello"}'

1. Buat file.zip yang berisi bootstrap file.

   zip runtime.zip bootstrap

2. Buat layer dengan publish-layer-versionperintah.

   aws lambda publish-layer-version --layer-name bash-runtime --zip-file fileb://runtime.zip

   Ini menciptakan versi pertama lapisan.

1. Perbarui konfigurasi fungsi untuk menarik lapisan.

   aws lambda update-function-configuration --function-name bash-runtime \
   --layers arn:aws:lambda:us-east-1:123456789012:layer:bash-runtime:1

   Ini menambahkan waktu pengoperasian ke fungsi di direktori /opt. Untuk memastikan bahwa Lambda menggunakan runtime di layer, Anda harus menghapus boostrap dari paket penerapan fungsi, seperti yang ditunjukkan dalam dua langkah berikutnya.

2. Buat file.zip yang berisi kode fungsi.

   zip function-only.zip function.sh

3. Perbarui kode fungsi untuk hanya memasukkan skrip penangan.

   aws lambda update-function-code --function-name bash-runtime --zip-file fileb://function-only.zip

4. Panggil fungsi untuk mengonfirmasi bahwa ia berfungsi dengan layer runtime.

   aws lambda invoke --function-name bash-runtime --payload '{"text":"Hello"}' response.txt --cli-binary-format raw-in-base64-out

   cli-binary-formatOpsi ini diperlukan jika Anda menggunakan AWS CLI versi 2. Untuk menjadikan ini pengaturan default, jalankanaws configure set cli-binary-format raw-in-base64-out. Untuk informasi selengkapnya, lihat opsi baris perintah global yang AWS CLI didukung di Panduan AWS Command Line Interface Pengguna untuk Versi 2.

   Anda akan melihat tanggapan seperti ini:

   {
       "StatusCode": 200,
       "ExecutedVersion": "$LATEST"
   }

5. Verifikasi responsnya.

   cat response.txt

   Anda akan melihat tanggapan seperti ini:

   Echoing request: '{"text":"Hello"}'

1. Untuk mencatat log informasi tentang lingkungan eksekusi, perbarui skrip waktu pengoperasian ke variabel lingkungan output.

   contoh bootstrap

   #!/bin/sh
   
   set -euo pipefail
   
   # Configure runtime to output environment variables
   echo "##  Environment variables:"
   env
   
   # Load function handler
   source $LAMBDA_TASK_ROOT/"$(echo $_HANDLER | cut -d. -f1).sh"
   
   # Processing
   while true
   do
     HEADERS="$(mktemp)"
     # Get an event. The HTTP request will block until one is received
     EVENT_DATA=$(curl -sS -LD "$HEADERS" "http://${AWS_LAMBDA_RUNTIME_API}/2018-06-01/runtime/invocation/next")
   
     # Extract request ID by scraping response headers received above
     REQUEST_ID=$(grep -Fi Lambda-Runtime-Aws-Request-Id "$HEADERS" | tr -d '[:space:]' | cut -d: -f2)
   
     # Run the handler function from the script
     RESPONSE=$($(echo "$_HANDLER" | cut -d. -f2) "$EVENT_DATA")
   
     # Send the response
     curl "http://${AWS_LAMBDA_RUNTIME_API}/2018-06-01/runtime/invocation/$REQUEST_ID/response"  -d "$RESPONSE"
   done

2. Buat file.zip yang berisi versi baru bootstrap file.

   zip runtime.zip bootstrap

3. Buat versi baru dari bash-runtime layer.

   aws lambda publish-layer-version --layer-name bash-runtime --zip-file fileb://runtime.zip

4. Konfigurasikan fungsi untuk menggunakan versi baru lapisan.

   aws lambda update-function-configuration --function-name bash-runtime \
   --layers arn:aws:lambda:us-east-1:123456789012:layer:bash-runtime:2