네이티브 런타임 형식으로 .NET Lambda 함수 코드 컴파일

네이티브 AOT 컴파일된 Lambda 함수를 초기화하고 배포하기

1. 네이티브 AOT 템플릿을 사용하여 새 프로젝트를 초기화한 다음 생성된 .cs 및 .csproj 파일이 포함된 디렉토리로 이동합니다. 이 예제에서는 함수 NativeAotSample의 이름을 지정합니다.

   dotnet new lambda.NativeAOT -n NativeAotSample
   cd ./NativeAotSample/src/NativeAotSample

   네이티브 AOT 템플릿으로 생성한 Function.cs 파일에는 다음 함수 코드가 포함되어 있습니다.

   using Amazon.Lambda.Core;
   using Amazon.Lambda.RuntimeSupport;
   using Amazon.Lambda.Serialization.SystemTextJson;
   using System.Text.Json.Serialization;
   
   namespace NativeAotSample;
   
   public class Function
   {
       /// <summary>
       /// The main entry point for the Lambda function. The main function is called once during the Lambda init phase. It
       /// initializes the .NET Lambda runtime client passing in the function handler to invoke for each Lambda event and
       /// the JSON serializer to use for converting Lambda JSON format to the .NET types.
       /// </summary>
       private static async Task Main()
       {
           Func<string, ILambdaContext, string> handler = FunctionHandler;
           await LambdaBootstrapBuilder.Create(handler, new SourceGeneratorLambdaJsonSerializer<LambdaFunctionJsonSerializerContext>())
               .Build()
               .RunAsync();
       }
   
       /// <summary>
       /// A simple function that takes a string and does a ToUpper.
       ///
       /// To use this handler to respond to an AWS event, reference the appropriate package from
       /// https://github.com/aws/aws-lambda-dotnet#events
       /// and change the string input parameter to the desired event type. When the event type
       /// is changed, the handler type registered in the main method needs to be updated and the LambdaFunctionJsonSerializerContext
       /// defined below will need the JsonSerializable updated. If the return type and event type are different then the
       /// LambdaFunctionJsonSerializerContext must have two JsonSerializable attributes, one for each type.
       ///
       // When using Native AOT extra testing with the deployed Lambda functions is required to ensure
       // the libraries used in the Lambda function work correctly with Native AOT. If a runtime
       // error occurs about missing types or methods the most likely solution will be to remove references to trim-unsafe
       // code or configure trimming options. This sample defaults to partial TrimMode because currently the AWS
       // SDK for .NET does not support trimming. This will result in a larger executable size, and still does not
       // guarantee runtime trimming errors won't be hit.
       /// </summary>
       /// <param name="input"></param>
       /// <param name="context"></param>
       /// <returns></returns>
       public static string FunctionHandler(string input, ILambdaContext context)
       {
           return input.ToUpper();
       }
   }
   
   /// <summary>
   /// This class is used to register the input event and return type for the FunctionHandler method with the System.Text.Json source generator.
   /// There must be a JsonSerializable attribute for each type used as the input and return type or a runtime error will occur
   /// from the JSON serializer unable to find the serialization information for unknown types.
   /// </summary>
   [JsonSerializable(typeof(string))]
   public partial class LambdaFunctionJsonSerializerContext : JsonSerializerContext
   {
       // By using this partial class derived from JsonSerializerContext, we can generate reflection free JSON Serializer code at compile time
       // which can deserialize our class and properties. However, we must attribute this class to tell it what types to generate serialization code for.
       // See https://docs.microsoft.com/en-us/dotnet/standard/serialization/system-text-json-source-generation

   네이티브 AOT는 애플리케이션을 단일 네이티브 바이너리로 컴파일합니다. 해당 바이너리의 엔트리포인트는 static Main 메서드입니다. static Main 내에서 Lambda 런타임이 부트스트랩되고 FunctionHandler 메서드가 설정됩니다. 런타임 부트스트랩의 일부로 소스 생성 시리얼라이저는 new SourceGeneratorLambdaJsonSerializer<LambdaFunctionJsonSerializerContext>()을(를) 사용하여 구성됩니다

2. Lambda에 애플리케이션을 배포하려면 도커가 로컬 환경에서 실행되고 있는지 확인하고 다음 명령을 실행하십시오.

   dotnet lambda deploy-function

   .NET 글로벌 CLI는 백그라운드에서 AL2023 도커 이미지를 다운로드하고 실행 중인 컨테이너 내에서 애플리케이션 코드를 컴파일합니다. 컴파일된 바이너리는 Lambda에 배포되기 전에 로컬 파일 시스템으로 다시 출력됩니다.

3. 다음 명령을 실행하여 함수를 테스트하십시오. <FUNCTION_NAME>을(를) 배포 마법사에서 함수에 선택한 이름으로 바꾸십시오.

   dotnet lambda invoke-function <FUNCTION_NAME> --payload "hello world"

   CLI의 응답에는 콜드 시작(초기화 기간)에 대한 성과 세부 정보와 함수 간접 호출의 총 실행 시간이 포함됩니다.

4. 이전 단계에 따라 생성한 AWS 리소스를 삭제하려면 다음 명령을 실행하십시오. <FUNCTION_NAME>을(를) 배포 마법사에서 함수에 선택한 이름으로 바꾸십시오. 더 이상 사용하지 않는 AWS 리소스를 삭제하면 AWS 계정에 불필요한 요금이 청구되는 것을 방지할 수 있습니다.

   dotnet lambda delete-function <FUNCTION_NAME>