Ketergantungan dalam Ruby Membuat paket penyebaran.zip tanpa dependensi Membuat paket penyebaran.zip dengan dependensi Membuat layer Ruby untuk dependensi Anda Membuat paket penyebaran.zip dengan pustaka asli Membuat dan memperbarui fungsi Ruby Lambda menggunakan file.zip

Deploy fungsi Lambda Ruby dengan arsip file .zip

Kode AWS Lambda fungsi Anda terdiri dari file.rb yang berisi kode handler fungsi Anda, bersama dengan dependensi tambahan (permata) yang bergantung pada kode Anda. Untuk menerapkan kode fungsi ini ke Lambda, Anda menggunakan paket penerapan. Paket ini dapat berupa arsip file.zip atau gambar kontainer. Untuk informasi selengkapnya tentang menggunakan gambar kontainer dengan Ruby, lihat Menye barkan fungsi Ruby Lambda dengan gambar kontainer.

Untuk membuat paket penerapan sebagai arsip file.zip, Anda dapat menggunakan utilitas arsip file.zip bawaan alat baris perintah Anda, atau utilitas file.zip lainnya seperti 7zip. https://www.7-zip.org/download.html Contoh yang ditunjukkan pada bagian berikut mengasumsikan Anda menggunakan zip alat baris perintah di lingkungan Linux atau macOS. Untuk menggunakan perintah yang sama di Windows, Anda dapat menginstal Windows Subsistem untuk Linux untuk mendapatkan Windows-integrated versi Ubuntu dan Bash.

Perhatikan bahwa Lambda menggunakan izin berkas POSIX, jadi Anda mungkin perlu mengatur izin untuk folder paket penerapan sebelum membuat arsip file.zip.

Contoh perintah di bagian berikut menggunakan utilitas Bundler untuk menambahkan dependensi ke paket penerapan Anda. Untuk menginstal bundler, jalankan perintah berikut.


gem install bundler

Bagian-bagian

Ketergantungan dalam Ruby
Membuat paket penyebaran.zip tanpa dependensi
Membuat paket penyebaran.zip dengan dependensi
Membuat layer Ruby untuk dependensi Anda
Membuat paket penyebaran.zip dengan pustaka asli
Membuat dan memperbarui fungsi Ruby Lambda menggunakan file.zip

Ketergantungan dalam Ruby

Untuk fungsi Lambda yang menggunakan runtime Ruby, dependensi dapat berupa permata Ruby apa pun. Saat Anda menerapkan fungsi Anda menggunakan arsip.zip, Anda dapat menambahkan dependensi ini ke file.zip Anda dengan kode fungsi Anda atau menggunakan lapisan Lambda. Layer adalah file.zip terpisah yang dapat berisi kode tambahan dan konten lainnya. Untuk mempelajari lebih lanjut tentang menggunakan lapisan Lambda, lihatMengelola dependensi Lambda dengan lapisan.

Runtime Ruby mencakup AWS SDK untuk Ruby. Jika fungsi Anda menggunakan SDK, Anda tidak perlu menggabungkannya dengan kode Anda. Namun, untuk mempertahankan kontrol penuh atas dependensi Anda, atau untuk menggunakan versi SDK tertentu, Anda dapat menambahkannya ke paket penerapan fungsi Anda.

Anda dapat menyertakan SDK dalam file.zip Anda, atau menambahkannya menggunakan lapisan Lambda. Dependensi dalam file.zip Anda atau di lapisan Lambda diutamakan daripada versi yang disertakan dalam runtime. Untuk mengetahui versi SDK untuk Ruby yang disertakan dalam versi runtime Anda, lihatRuntime-included Versi SDK.

Di bawah model tanggung jawab AWS bersama, Anda bertanggung jawab atas pengelolaan dependensi apa pun dalam paket penerapan fungsi Anda. Ini termasuk menerapkan pembaruan dan patch keamanan. Untuk memperbarui dependensi dalam paket penerapan fungsi Anda, pertama buat file.zip baru dan kemudian unggah ke Lambda. Lihat Membuat paket penyebaran.zip dengan dependensi dan Membuat dan memperbarui fungsi Ruby Lambda menggunakan file.zip untuk informasi lebih lanjut.

Membuat paket penyebaran.zip tanpa dependensi

Jika kode fungsi Anda tidak memiliki dependensi, file.zip Anda hanya berisi file.rb dengan kode handler fungsi Anda. Gunakan utilitas zip pilihan Anda untuk membuat file.zip dengan file.rb Anda di root. Jika file.rb tidak berada di root file.zip Anda, Lambda tidak akan dapat menjalankan kode Anda.

Untuk mempelajari cara menerapkan file.zip Anda untuk membuat fungsi Lambda baru atau memperbarui fungsi yang sudah ada, lihat. Membuat dan memperbarui fungsi Ruby Lambda menggunakan file.zip

Membuat paket penyebaran.zip dengan dependensi

Jika kode fungsi Anda bergantung pada permata Ruby tambahan, Anda dapat menambahkan dependensi ini ke file.zip Anda dengan kode fungsi Anda atau menggunakan lapisan Lambda. Petunjuk di bagian ini menunjukkan cara menyertakan dependensi dalam paket penerapan.zip Anda. Untuk petunjuk tentang cara memasukkan dependensi Anda dalam lapisan, lihatMembuat layer Ruby untuk dependensi Anda.

Misalkan kode fungsi Anda disimpan dalam file bernama lambda_function.rb di direktori proyek Anda. Contoh perintah CLI berikut membuat file.zip bernama my_deployment_package.zip berisi kode fungsi Anda dan dependensinya.

Untuk membuat paket deployment

Di direktori proyek Anda, buat a Gemfile untuk menentukan dependensi Anda.
```
bundle init
```
Menggunakan editor teks pilihan Anda, edit Gemfile untuk menentukan dependensi fungsi Anda. Misalnya, untuk menggunakan permata TZinfo, edit Anda Gemfile agar terlihat seperti berikut ini.
```
source "https://rubygems.org"
gem "tzinfo"
```
Jalankan perintah berikut untuk menginstal permata yang ditentukan Gemfile di direktori proyek Anda. Perintah ini vendor/bundle ditetapkan sebagai jalur default untuk instalasi permata.
```
bundle config set --local path 'vendor/bundle' && bundle install
```
Anda akan melihat output seperti yang berikut ini.
```
Fetching gem metadata from https://rubygems.org/...........
Resolving dependencies...
Using bundler 2.4.13
Fetching tzinfo 2.0.6
Installing tzinfo 2.0.6
...
```
catatan
Untuk menginstal permata secara global lagi nanti, jalankan perintah berikut.
```
bundle config set --local system 'true'
```

Buat arsip file.zip yang berisi lambda_function.rb file dengan kode handler fungsi Anda dan dependensi yang Anda instal pada langkah sebelumnya.


zip -r my_deployment_package.zip lambda_function.rb vendor

Anda akan melihat output seperti yang berikut ini.


adding: lambda_function.rb (deflated 37%)
  adding: vendor/ (stored 0%)
  adding: vendor/bundle/ (stored 0%)
  adding: vendor/bundle/ruby/ (stored 0%)
  adding: vendor/bundle/ruby/3.2.0/ (stored 0%)
  adding: vendor/bundle/ruby/3.2.0/build_info/ (stored 0%)
  adding: vendor/bundle/ruby/3.2.0/cache/ (stored 0%)
  adding: vendor/bundle/ruby/3.2.0/cache/aws-eventstream-1.0.1.gem (deflated 36%)
...

Membuat layer Ruby untuk dependensi Anda

Untuk mempelajari cara mengemas dependensi Ruby Anda ke dalam lapisan Lambda, lihat. Bekerja dengan lapisan untuk fungsi Ruby Lambda

Membuat paket penyebaran.zip dengan pustaka asli

Banyak permata Ruby umum sepertinokogiri,nio4r, dan mysql berisi ekstensi asli yang ditulis dalam C. Ketika Anda menambahkan pustaka yang berisi kode C ke paket penerapan Anda, Anda harus membangun paket Anda dengan benar untuk memastikan bahwa itu kompatibel dengan lingkungan eksekusi Lambda.

Untuk aplikasi produksi, kami sarankan untuk membangun dan menerapkan kode Anda menggunakan AWS Serverless Application Model (AWS SAM). Dalam AWS SAM menggunakan sam build --use-container opsi untuk membangun fungsi Anda di dalam wadah Lambda-like Docker. Untuk mempelajari lebih lanjut tentang menggunakan AWS SAM untuk menerapkan kode fungsi Anda, lihat Membangun aplikasi di Panduan AWS SAM Pengembang.

Untuk membuat paket penerapan.zip yang berisi permata dengan ekstensi asli tanpa menggunakan AWS SAM, Anda dapat menggunakan wadah untuk menggabungkan dependensi Anda dalam lingkungan yang sama dengan lingkungan runtime Lambda Ruby. Untuk menyelesaikan langkah-langkah ini, Anda harus menginstal Docker pada mesin build Anda. Untuk mempelajari lebih lanjut tentang menginstal Docker, lihat Meng instal Mesin Docker.

Untuk membuat paket penerapan.zip dalam wadah Docker

Buat folder di mesin build lokal Anda untuk menyimpan wadah Anda. Di dalam folder itu, buat file bernama dockerfile dan tempel kode berikut ke dalamnya.
```
FROM public.ecr.aws/sam/build-ruby3.2:latest-x86_64
RUN gem update bundler 
CMD "/bin/bash"
```
Di dalam folder tempat Anda dockerfile membuat, jalankan perintah berikut untuk membuat wadah Docker.
```
docker build -t awsruby32 .
```
Arahkan ke direktori proyek yang berisi .rb file dengan kode handler fungsi Anda dan Gemfile menentukan dependensi fungsi Anda. Dari dalam direktori itu, jalankan perintah berikut untuk memulai wadah Lambda Ruby.
Linux/MacOS
```
docker run --rm -it -v $PWD:/var/task -w /var/task awsruby32
```
catatan
Di macOS, Anda mungkin melihat peringatan yang memberi tahu Anda bahwa platform gambar yang diminta tidak cocok dengan platform host yang terdeteksi. Abaikan peringatan ini.
Windows PowerShell
```
docker run --rm -it -v ${pwd}:/var/task -w /var/task awsruby32
```
Saat wadah Anda dimulai, Anda akan melihat prompt bash.
```
bash-4.2#
```
Konfigurasikan utilitas bundel untuk menginstal permata yang ditentukan Gemfile di vendor/bundle direktori lokal Anda dan menginstal dependensi Anda.
```
bash-4.2# bundle config set --local path 'vendor/bundle' && bundle install
```
Buat paket penerapan.zip dengan kode fungsi Anda dan dependensinya. Dalam contoh ini, file yang berisi kode handler fungsi Anda diberi namalambda_function.rb.
```
bash-4.2# zip -r my_deployment_package.zip lambda_function.rb vendor
```
Keluar dari wadah dan kembali ke direktori proyek lokal Anda.
```
bash-4.2# exit
```
Anda sekarang dapat menggunakan paket penerapan file.zip untuk membuat atau memperbarui fungsi Lambda Anda. Lihat Membuat dan memperbarui fungsi Ruby Lambda menggunakan file.zip

Membuat dan memperbarui fungsi Ruby Lambda menggunakan file.zip

Setelah membuat paket penerapan.zip, Anda dapat menggunakannya untuk membuat fungsi Lambda baru atau memperbarui yang sudah ada. Anda dapat menerapkan paket.zip Anda menggunakan konsol Lambda, AWS Command Line Interface, dan Lambda API. Anda juga dapat membuat dan memperbarui fungsi Lambda menggunakan AWS Serverless Application Model (AWS SAM) dan CloudFormation.

Ukuran maksimum untuk paket penerapan.zip untuk Lambda adalah 250 MB (unzip). Perhatikan bahwa batas ini berlaku untuk ukuran gabungan semua file yang Anda unggah, termasuk lapisan Lambda apa pun.

Runtime Lambda membutuhkan izin untuk membaca file dalam paket deployment Anda. Dalam notasi oktal izin Linux, Lambda memerlukan 644 izin untuk file yang tidak dapat dieksekusi (rw-r--r--) dan 755 izin (rwxr-xr-x) untuk direktori dan file yang dapat dieksekusi.

Di Linux dan macOS, gunakan chmod perintah untuk mengubah izin file pada file dan direktori dalam paket penerapan Anda. Misalnya, untuk memberikan file yang tidak dapat dieksekusi izin yang benar, jalankan perintah berikut.


chmod 644 <filepath>

Untuk mengubah izin file di Windows, lihat Meng atur, Melihat, Mengubah, atau Menghapus Izin pada Objek dalam dokumentasi Microsoft Windows.

catatan

Jika Anda tidak memberikan Lambda izin yang diperlukan untuk mengakses direktori dalam paket penerapan Anda, Lambda menetapkan izin untuk direktori tersebut ke 755 (rwxr-xr-x).

Membuat dan memperbarui fungsi dengan file.zip menggunakan konsol

Untuk membuat fungsi baru, Anda harus terlebih dahulu membuat fungsi di konsol, lalu mengunggah arsip.zip Anda. Untuk memperbarui fungsi yang ada, buka halaman untuk fungsi Anda, lalu ikuti prosedur yang sama untuk menambahkan file.zip yang diperbarui.

Jika file.zip Anda kurang dari 50MB, Anda dapat membuat atau memperbarui fungsi dengan mengunggah file langsung dari mesin lokal Anda. Untuk file.zip yang lebih besar dari 50MB, Anda harus mengunggah paket Anda ke bucket Amazon S3 terlebih dahulu. Untuk petunjuk tentang cara mengunggah file ke bucket Amazon S3 menggunakan Konsol Manajemen AWS, lihat Memulai dengan Amazon S3. Untuk mengunggah file menggunakan AWS CLI, lihat Memindahkan objek di Panduan AWS CLI Pengguna.

catatan

Anda tidak dapat mengubah jenis paket penerapan (.zip atau image container) untuk fungsi yang ada. Misalnya, Anda tidak dapat mengonversi fungsi gambar kontainer untuk menggunakan arsip berkas.zip. Anda harus membuat fungsi baru.

Untuk membuat fungsi baru (konsol)

Buka halaman Functions pada konsol Lambda dan pilih Create Func tion.
Pilih Tulis dari awal.
Di bagian Informasi dasar, lakukan hal berikut:
1. Untuk Nama fungsi, masukkan nama untuk fungsi Anda.
2. Untuk Runtime, pilih runtime yang ingin Anda gunakan.
3. (Opsional) Untuk Ar sitektur, pilih arsitektur set instruksi untuk fungsi Anda. Arsitektur default adalah x86_64. Pastikan paket penerapan.zip untuk fungsi Anda kompatibel dengan arsitektur set instruksi yang Anda pilih.
(Opsional) Di bagian Izin, luaskan Ubah peran eksekusi default. Anda dapat membuat peran Ek sekusi baru atau menggunakan yang sudah ada.
Pilih Buat fungsi. Lambda membuat fungsi dasar 'Hello world' menggunakan runtime pilihan Anda.

Untuk mengunggah arsip.zip dari mesin lokal Anda (konsol)

Di halaman Functions pada konsol Lambda, pilih fungsi yang ingin Anda unggah file.zip.
Pilih tab Kode.
Di panel sumber kode, pilih Unggah dari.
Pilih fil e.zip.
Untuk mengunggah file.zip, lakukan hal berikut:
1. Pilih Unggah, lalu pilih file.zip Anda di pemilih file.
2. Pilih Buka.
3. Pilih Simpan.

Untuk mengunggah arsip.zip dari bucket Amazon S3 (konsol)

Di halaman Functions pada konsol Lambda, pilih fungsi yang ingin Anda unggah file.zip baru.
Pilih tab Kode.
Di panel sumber kode, pilih Unggah dari.
Pilih lokasi Amazon S3.
Rekatkan URL tautan Amazon S3 dari file.zip Anda dan pilih S impan.

Memperbarui fungsi file.zip menggunakan editor kode konsol

Untuk beberapa fungsi dengan paket penyebaran.zip, Anda dapat menggunakan editor kode bawaan konsol Lambda untuk memperbarui kode fungsi Anda secara langsung. Untuk menggunakan fitur ini, fungsi Anda harus memenuhi kriteria berikut:

Fungsi Anda harus menggunakan salah satu runtime bahasa yang ditafsirkan (Python, Node.js, atau Ruby)
Paket penerapan fungsi Anda harus lebih kecil dari 50 MB (unzip).

Kode fungsi untuk fungsi dengan paket penyebaran gambar kontainer tidak dapat diedit langsung di konsol.

Untuk memperbarui kode fungsi menggunakan editor kode konsol

Buka halaman Functions pada konsol Lambda dan pilih fungsi Anda.
Pilih tab Kode.
Di panel sumber kode, pilih file kode sumber Anda dan edit di editor kode terintegrasi.
Di bagian DEPLOY, pilih De ploy untuk memperbarui kode fungsi Anda:

Membuat dan memperbarui fungsi dengan file.zip menggunakan AWS CLI

Anda dapat menggunakan AWS CLI untuk membuat fungsi baru atau memperbarui yang sudah ada menggunakan file.zip. Gunakan perintah create-function dan update-function-code untuk menerapkan paket.zip Anda. Jika file.zip Anda lebih kecil dari 50MB, Anda dapat mengunggah paket.zip dari lokasi file di mesin build lokal Anda. Untuk file yang lebih besar, Anda harus mengunggah paket.zip Anda dari bucket Amazon S3. Untuk petunjuk tentang cara mengunggah file ke bucket Amazon S3 menggunakan AWS CLI, lihat Mem indahkan objek di Panduan AWS CLI Pengguna.

catatan

Jika Anda mengunggah file.zip dari bucket Amazon S3 menggunakan AWS CLI, bucket harus ditempatkan di tempat yang Wilayah AWS sama dengan fungsi Anda.

Untuk membuat fungsi baru menggunakan file.zip dengan AWS CLI, Anda harus menentukan yang berikut:

Nama fungsi Anda (--function-name)
runtime fungsi Anda (--runtime)
Nama Sumber Daya Amazon (ARN) dari peran eksekusi fungsi Anda (--role)
Nama metode handler dalam kode fungsi Anda (--handler)

Anda juga harus menentukan lokasi file.zip Anda. Jika file.zip Anda terletak di folder pada mesin build lokal Anda, gunakan --zip-file opsi untuk menentukan jalur file, seperti yang ditunjukkan pada contoh perintah berikut.


aws lambda create-function --function-name myFunction \
--runtime ruby3.2 --handler lambda_function.lambda_handler \
--role arn:aws:iam::111122223333:role/service-role/my-lambda-role \
--zip-file fileb://myFunction.zip

Untuk menentukan lokasi file.zip dalam bucket Amazon S3, gunakan --code opsi seperti yang ditunjukkan pada contoh perintah berikut. Anda hanya perlu menggunakan S3ObjectVersion parameter untuk objek berversi.


aws lambda create-function --function-name myFunction \
--runtime ruby3.2 --handler lambda_function.lambda_handler \
--role arn:aws:iam::111122223333:role/service-role/my-lambda-role \
--code S3Bucket=amzn-s3-demo-bucket,S3Key=myFileName.zip,S3ObjectVersion=myObjectVersion

Untuk memperbarui fungsi yang ada menggunakan CLI, Anda menentukan nama fungsi Anda menggunakan --function-name parameter. Anda juga harus menentukan lokasi file.zip yang ingin Anda gunakan untuk memperbarui kode fungsi Anda. Jika file.zip Anda terletak di folder pada mesin build lokal Anda, gunakan --zip-file opsi untuk menentukan jalur file, seperti yang ditunjukkan pada contoh perintah berikut.


aws lambda update-function-code --function-name myFunction \
--zip-file fileb://myFunction.zip

Untuk menentukan lokasi file.zip dalam bucket Amazon S3, gunakan --s3-key opsi --s3-bucket dan seperti yang ditunjukkan pada perintah contoh berikut. Anda hanya perlu menggunakan --s3-object-version parameter untuk objek berversi.


aws lambda update-function-code --function-name myFunction \
--s3-bucket amzn-s3-demo-bucket --s3-key myFileName.zip --s3-object-version myObject Version

Membuat dan memperbarui fungsi dengan file.zip menggunakan API Lambda

Untuk membuat dan memperbarui fungsi menggunakan arsip file.zip, gunakan operasi API berikut:

Membuat dan memperbarui fungsi dengan file.zip menggunakan AWS SAM

AWS Serverless Application Model (AWS SAM) adalah toolkit yang membantu merampingkan proses membangun dan menjalankan aplikasi tanpa server. AWS Anda menentukan sumber daya untuk aplikasi Anda dalam templat YAML atau JSON dan menggunakan antarmuka baris AWS SAM perintah (AWS SAM CLI) untuk membangun, mengemas, dan menyebarkan aplikasi Anda. Saat Anda membangun fungsi Lambda dari AWS SAM template, AWS SAM secara otomatis membuat paket penerapan.zip atau image wadah dengan kode fungsi Anda dan dependensi apa pun yang Anda tentukan. Untuk mempelajari selengkapnya tentang menggunakan AWS SAM untuk membangun dan menerapkan fungsi Lambda, lihat Memulai dengan AWS SAM di Panduan Peng AWS Serverless Application Model embang.

Anda juga dapat menggunakan AWS SAM untuk membuat fungsi Lambda menggunakan arsip file.zip yang ada. Untuk membuat fungsi Lambda menggunakan AWS SAM, Anda dapat menyimpan file.zip Anda di bucket Amazon S3 atau di folder lokal di mesin build Anda. Untuk petunjuk tentang cara mengunggah file ke bucket Amazon S3 menggunakan AWS CLI, lihat Mem indahkan objek di Panduan AWS CLI Pengguna.

Dalam AWS SAM template Anda, AWS::Serverless::Function sumber daya menentukan fungsi Lambda Anda. Di sumber daya ini, atur properti berikut untuk membuat fungsi menggunakan arsip file.zip:

PackageType- diatur ke Zip
CodeUri- diatur ke kode fungsi Amazon S3 URI, jalur ke folder lokal, atau FunctionCode objek
Runtime- Atur ke runtime pilihan Anda

Dengan AWS SAM, jika file.zip Anda lebih besar dari 50MB, Anda tidak perlu mengunggahnya ke bucket Amazon S3 terlebih dahulu. AWS SAM dapat mengunggah paket.zip hingga ukuran maksimum yang diizinkan 250MB (unzip) dari lokasi di mesin build lokal Anda.

Untuk mempelajari selengkapnya tentang menerapkan fungsi menggunakan file.zip di AWS SAM, lihat AWS::Serverless: :Fungsi di Panduan Peng AWS SAM embang.

Membuat dan memperbarui fungsi dengan file.zip menggunakan CloudFormation

Anda dapat menggunakan CloudFormation untuk membuat fungsi Lambda menggunakan arsip file.zip. Untuk membuat fungsi Lambda dari file.zip, Anda harus terlebih dahulu mengunggah file Anda ke bucket Amazon S3. Untuk petunjuk tentang cara mengunggah file ke bucket Amazon S3 menggunakan AWS CLI, lihat Mem indahkan objek di Panduan AWS CLI Pengguna.

Dalam CloudFormation template Anda, AWS::Lambda::Function sumber daya menentukan fungsi Lambda Anda. Di sumber daya ini, atur properti berikut untuk membuat fungsi menggunakan arsip file.zip:

PackageType- Setel ke Zip
Code- Masukkan nama bucket Amazon S3 dan nama file.zip di bidang S3Bucket dan S3Key
Runtime- Atur ke runtime pilihan Anda

File.zip yang CloudFormation menghasilkan tidak boleh melebihi 4MB. Untuk mempelajari selengkapnya tentang menerapkan fungsi menggunakan file.zip di CloudFormation, lihat AWS::Lambda: :Fungsi di Panduan Pengguna. CloudFormation

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Handler

Deploy gambar kontainer