View a markdown version of this page

Menyebarkan Fungsi Event .NET Lambda dengan gambar kontainer - AWS Lambda
AWS gambar dasar untuk .NETMenggunakan gambar AWS dasarMenggunakan gambar AWS non-dasar

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Menyebarkan Fungsi Event .NET Lambda dengan gambar kontainer

Ada tiga cara untuk membangun image kontainer untuk Fungsi Event .NET Lambda:

Tip

Untuk mengurangi waktu yang dibutuhkan agar fungsi kontainer Lambda menjadi aktif, lihat Menggunakan build multi-tahap dalam dokumentasi Docker. Untuk membuat gambar kontainer yang efisien, ikuti Praktik terbaik untuk menulis Dockerfiles.

Halaman ini menjelaskan cara membuat, menguji, dan menyebarkan gambar kontainer untuk Lambda.

AWS gambar dasar untuk .NET

AWS menyediakan gambar dasar berikut untuk .NET:

Tanda Waktu berjalan Sistem operasi Dockerfile penghentian

10

 .NET 10 Amazon Linux 2023 Dockerfile untuk .NET 10 di GitHub

Nov 14, 2028

9

 .NET 9 Amazon Linux 2023 Dockerfile untuk .NET 9 di GitHub

Nov 10, 2026

8

 .NET 8 Amazon Linux 2023 Dockerfile untuk .NET 8 di GitHub

Nov 10, 2026

Repositori Amazon ECR: gallery.ecr. aws/lambda/dotnet

Menggunakan sebuah AWS gambar dasar untuk .NET

Prasyarat

Untuk menyelesaikan langkah-langkah di bagian ini, Anda harus memiliki hal-hal berikut:

  • .NET SDK — Langkah-langkah berikut menggunakan gambar dasar.NET 8. Pastikan versi.NET Anda cocok dengan versi gambar dasar yang Anda tentukan di Dockerfile Anda.

  • Docker (versi minimum 25.0.0)

  • Plugin buildx Docker.

Membuat dan menyebarkan gambar menggunakan gambar dasar

Dalam langkah-langkah berikut, Anda menggunakan Amazon.Lambda.Templatesdan Amazon.Lambda.Toolsmembuat proyek .NET. Kemudian, Anda membuat gambar Docker, mengunggah gambar ke Amazon ECR, dan menerapkannya ke fungsi Lambda.

  1. Instal paket Amazon.Lambda.Templates NuGet .

    dotnet new install Amazon.Lambda.Templates

  2. Buat proyek.NET menggunakan lambda.image.EmptyFunction template.

    dotnet new lambda.image.EmptyFunction --name MyFunction --region us-east-1

    File proyek disimpan dalam MyFunction/src/MyFunction direktori:

    • aws-lambda-tools-defaults.json: Menentukan opsi baris perintah untuk menerapkan fungsi Lambda Anda.

    • Function.cs: Kode fungsi penangan Lambda Anda. Ini adalah template C # yang mencakup Amazon.Lambda.Core pustaka default dan LambdaSerializer atribut default. Untuk informasi selengkapnya tentang persyaratan dan opsi serialisasi, lihatSerialisasi dalam Fungsi Acara C# Lambda. Anda dapat menggunakan kode yang disediakan untuk pengujian, atau menggantinya dengan kode Anda sendiri.

    • MyFunction.csproj: File proyek.NET, yang mencantumkan file dan rakitan yang terdiri dari aplikasi Anda.

    • Dockerfile: Anda dapat menggunakan Dockerfile yang disediakan untuk pengujian, atau menggantinya dengan milik Anda sendiri. Jika Anda menggunakan sendiri, pastikan untuk:

      • Mengatur FROM properti ke URI dari gambar dasar. Gambar dasar dan TargetFramework dalam MyFunction.csproj file harus menggunakan versi.NET yang sama. Misalnya, untuk menggunakan .NET 9:

        • Dockerfile: FROM public.ecr.aws/lambda/dotnet:9

        • MyFunction.csproj: <TargetFramework>net9.0</TargetFramework>

      • Atur CMD argumen ke penangan fungsi Lambda. Ini harus cocok dengan image-command inaws-lambda-tools-defaults.json.

  3. Instal Alat Amazon.Lambda.Tools Global.NET.

    dotnet tool install -g Amazon.Lambda.Tools

    Jika Amazon.Lambda.Tools sudah terinstal, pastikan Anda memiliki versi terbaru.

    dotnet tool update -g Amazon.Lambda.Tools

  4. Ubah direktori keMyFunction/src/MyFunction, jika Anda belum ada di sana.

    cd src/MyFunction

  5. Gunakan Amazon.Lambda.Tools untuk membuat image Docker, dorong ke repositori Amazon ECR baru, dan gunakan fungsi Lambda.

    Untuk--function-role, tentukan nama peran—bukan Amazon Resource Name (ARN) —dari peran eksekusi untuk fungsi tersebut. Misalnya, lambda-role.

    dotnet lambda deploy-function MyFunction --function-role lambda-role

    Untuk informasi selengkapnya tentang Amazon.Lambda.Tools .NET Global Tool, lihat AWS Ekstensi untuk repositori.NET CLI di. GitHub

  6. Memanggil fungsi.

    dotnet lambda invoke-function MyFunction --payload "Testing the function"

    Jika semuanya berhasil, Anda melihat respons yang mirip dengan yang berikut:

    Payload:
{"Lower":"testing the function","Upper":"TESTING THE FUNCTION"}

Log Tail:
INIT_REPORT Init Duration: 9999.81 ms   Phase: init     Status: timeout
START RequestId: 12378346-f302-419b-b1f2-deaa1e8423ed Version: $LATEST
END RequestId: 12378346-f302-419b-b1f2-deaa1e8423ed
REPORT RequestId: 12378346-f302-419b-b1f2-deaa1e8423ed  Duration: 3173.06 ms    Billed Duration: 3174 ms        Memory Size: 512 MB     Max Memory Used: 24 MB

  7. Hapus fungsi Lambda.

    dotnet lambda delete-function MyFunction

Menggunakan gambar dasar alternatif dengan klien antarmuka runtime

Jika Anda menggunakan gambar OS-only dasar atau gambar dasar alternatif, Anda harus menyertakan klien antarmuka runtime dalam gambar Anda. Klien antarmuka runtime memperluasAPI runtime, yang mengelola interaksi antara Lambda dan kode fungsi Anda.

Contoh berikut menunjukkan cara membangun image container untuk.NET menggunakan image AWS non-base, dan cara menambahkan Amazon.Lambda.RuntimeSupport paket, yang merupakan klien antarmuka runtime Lambda untuk.NET. Contoh Dockerfile menggunakan gambar dasar Microsoft .NET 8.

Prasyarat

Untuk menyelesaikan langkah-langkah di bagian ini, Anda harus memiliki hal-hal berikut:

  • .NET SDK — Langkah-langkah berikut menggunakan gambar dasar.NET 9. Pastikan versi.NET Anda cocok dengan versi gambar dasar yang Anda tentukan di Dockerfile Anda.

  • Docker (versi minimum 25.0.0)

  • Plugin buildx Docker.

Membuat dan menyebarkan gambar menggunakan gambar dasar alternatif

  1. Instal paket Amazon.Lambda.Templates NuGet .

    dotnet new install Amazon.Lambda.Templates

  2. Buat proyek.NET menggunakan lambda.CustomRuntimeFunction template. Template ini termasuk Amazon.Lambda.RuntimeSupportpaket.

    dotnet new lambda.CustomRuntimeFunction --name MyFunction --region us-east-1

  3. Buka direktori MyFunction/src/MyFunction tersebut. Di sinilah file proyek disimpan. Periksa file-file berikut:

    • aws-lambda-tools-defaults.json — File ini adalah tempat Anda menentukan opsi baris perintah saat menerapkan fungsi Lambda Anda.

    • Function.cs— Kode berisi kelas dengan Main metode yang menginisialisasi Amazon.Lambda.RuntimeSupport perpustakaan sebagai bootstrap. MainMetode ini adalah titik masuk untuk proses fungsi. MainMetode ini membungkus fungsi handler dalam pembungkus yang dapat digunakan bootstrap. Untuk informasi selengkapnya, lihat Menggunakan Amazon.Lambda.RuntimeSupport sebagai pustaka kelas di GitHub repositori.

    • MyFunction.csproj— File proyek.NET, yang mencantumkan file dan rakitan yang terdiri dari aplikasi Anda.

    • Readme.md— File ini berisi informasi lebih lanjut tentang fungsi Lambda sampel.

  4. Buka aws-lambda-tools-defaults.json file dan Tambahkan baris berikut:

      "package-type": "image",
  "docker-host-build-output-dir": "./bin/Release/lambda-publish"

    • package-type: Mendefinisikan paket deployment sebagai image container.

    • docker-host-build-output-dir: Menyetel direktori keluaran untuk proses pembuatan.

    contoh aws-lambda-alat-defaults.json
    {
  "Information": [
    "This file provides default values for the deployment wizard inside Visual Studio and the AWS Lambda commands added to the .NET Core CLI.",
    "To learn more about the Lambda commands with the .NET Core CLI execute the following command at the command line in the project root directory.",
    "dotnet lambda help",
    "All the command line options for the Lambda command can be specified in this file."
  ],
  "profile": "",
  "region": "us-east-1",
  "configuration": "Release",
  "function-runtime": "provided.al2023",
  "function-memory-size": 256,
  "function-timeout": 30,
  "function-handler": "bootstrap",
  "msbuild-parameters": "--self-contained true",
  "package-type": "image",
  "docker-host-build-output-dir": "./bin/Release/lambda-publish"
}

  5. Buat Dockerfile di direktori. MyFunction/src/MyFunction Contoh berikut Dockerfile menggunakan gambar dasar Microsoft .NET bukan gambar AWS dasar.

    • Atur FROM properti ke pengenal gambar dasar. Gambar dasar dan TargetFramework dalam MyFunction.csproj file harus menggunakan versi.NET yang sama.

    • Gunakan COPY perintah untuk menyalin fungsi ke /var/task direktori.

    • Atur ENTRYPOINT ke modul yang Anda inginkan untuk menjalankan wadah Docker saat dimulai. Dalam hal ini, modul adalah bootstrap, yang menginisialisasi Amazon.Lambda.RuntimeSupport perpustakaan.

    Perhatikan bahwa contoh Dockerfile tidak menyertakan instruksi USER. Saat Anda menyebarkan gambar kontainer ke Lambda, Lambda secara otomatis mendefinisikan pengguna Linux default dengan izin yang paling tidak memiliki hak istimewa. Ini berbeda dari perilaku Docker standar yang default ke root pengguna ketika tidak ada USER instruksi yang diberikan.

    contoh Dockerfile
    # You can also pull these images from DockerHub amazon/aws-lambda-dotnet:8
FROM mcr.microsoft.com/dotnet/runtime:9.0

# Set the image's internal work directory
WORKDIR /var/task
  
# Copy function code to Lambda-defined environment variable
COPY "bin/Release/net9.0/linux-x64"  .
  
# Set the entrypoint to the bootstrap
ENTRYPOINT ["/usr/bin/dotnet", "exec", "/var/task/bootstrap.dll"]

  6. Instal Amazon.Lambda.Tools ekstensi.NET Global Tools.

    dotnet tool install -g Amazon.Lambda.Tools

    Jika Amazon.Lambda.Tools sudah terinstal, pastikan Anda memiliki versi terbaru.

    dotnet tool update -g Amazon.Lambda.Tools

  7. Gunakan Amazon.Lambda.Tools untuk membuat image Docker, dorong ke repositori Amazon ECR baru, dan gunakan fungsi Lambda.

    Untuk--function-role, tentukan nama peran—bukan Amazon Resource Name (ARN) —dari peran eksekusi untuk fungsi tersebut. Misalnya, lambda-role.

    dotnet lambda deploy-function MyFunction --function-role lambda-role

    Untuk informasi selengkapnya tentang Amazon.Lambda.Tools ekstensi.NET CLI, lihat AWS Ekstensi untuk repositori.NET CLI di. GitHub

  8. Memanggil fungsi.

    dotnet lambda invoke-function MyFunction --payload "Testing the function"

    Jika semuanya berhasil, Anda akan melihat hal berikut:

    Payload:
"TESTING THE FUNCTION"

Log Tail:
START RequestId: id Version: $LATEST
END RequestId: id
REPORT RequestId: id  Duration: 0.99 ms       Billed Duration: 1 ms         Memory Size: 256 MB     Max Memory Used: 12 MB

  9. Hapus fungsi Lambda.

    dotnet lambda delete-function MyFunction