Tutorial: Membangun runtime kustom

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 oleh fungsi untuk menulis log ke CloudWatch Logs.

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 waktu pengoperasian memuat skrip fungsi, ia menggunakan waktu pengoperasian API untuk mengambil kejadian invokasi dari Lambda, meneruskan kejadian tersebut ke penangan, dan memposting respons kembali ke Lambda. Untuk mendapatkan ID permintaan, waktu pengoperasian 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 berikut ini mendefinisikan fungsi penangan yang mengambil data kejadian, mencatat 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 terlihat seperti ini:

   runtime-tutorial
   ├ bootstrap
   └ function.sh

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

   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. Lakukan invokasi 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 tanggapan.

   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 lapisan 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. Lakukan invokasi fungsi untuk mengonfirmasi bahwa ia berfungsi dengan lapisan waktu pengoperasian.

   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 tanggapan.

   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 bash-runtime lapisan.

   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