Menyebarkan. NETFungsi Lambda dengan gambar kontainer

Instal paket Amazon.Lambda.Templates. NuGet

dotnet new install Amazon.Lambda.Templates

Buat a. NETproyek menggunakan lambda.image.EmptyFunction template.

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

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

Periksa Dockerfile di direktori. src/MyFunction Anda dapat menggunakan Dockerfile yang disediakan untuk pengujian, atau menggantinya dengan milik Anda sendiri. Jika Anda menggunakan sendiri, pastikan untuk:

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.

# You can also pull these images from DockerHub amazon/aws-lambda-dotnet:8
FROM public.ecr.aws/lambda/dotnet:8
  
# Copy function code to Lambda-defined environment variable
COPY publish/* ${LAMBDA_TASK_ROOT}
  
# Set the CMD to your handler (could also be done as a parameter override outside of the Dockerfile)
CMD [ "MyFunction::MyFunction.Function::FunctionHandler" ]

Instal Amazon.Lambda.Tools. NETAlat Global.

dotnet tool install -g Amazon.Lambda.Tools

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

dotnet tool update -g Amazon.Lambda.Tools

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

cd src/MyFunction

Gunakan Amazon.Lambda.Tools untuk membuat image Docker, mendorongnya ke repositori ECR Amazon baru, dan menerapkan 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 lebih lanjut tentang Amazon.Lambda.Tools. NETGlobal Tool, lihat AWS Ekstensi untuk. NETCLIrepositori aktif. GitHub

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

Hapus fungsi Lambda.

dotnet lambda delete-function MyFunction

Instal paket Amazon.Lambda.Templates. NuGet

dotnet new install Amazon.Lambda.Templates

Buat a. NETproyek menggunakan lambda.CustomRuntimeFunction template. Template ini termasuk Amazon.Lambda. RuntimeSupportpaket.

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

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

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

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

{
  "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"
}

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

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.

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

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

Instal Amazon.Lambda.Tools. NETEkstensi Alat Global.

dotnet tool install -g Amazon.Lambda.Tools

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

dotnet tool update -g Amazon.Lambda.Tools

Gunakan Amazon.Lambda.Tools untuk membuat image Docker, mendorongnya ke repositori ECR Amazon baru, dan menerapkan 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 lebih lanjut tentang Amazon.Lambda.Tools. NETCLIekstensi, lihat AWS Ekstensi untuk. NETCLIrepositori aktif. GitHub

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

Hapus fungsi Lambda.

dotnet lambda delete-function MyFunction