Distribuzione delle funzioni .NET Lambda con immagini di container

Installa il pacchetto Amazon.Lambda.Templates. NuGet

dotnet new install Amazon.Lambda.Templates

Crea un progetto .NET utilizzando il modello lambda.image.EmptyFunction.

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

Passa alla directory MyFunction/src/MyFunction. Qui sono archiviati i file del progetto. Esamina i seguenti file di log:

Esamina il Dockerfile nella directory src/MyFunction. A fini di test, puoi utilizzare il Dockerfile fornito o sostituirlo con un file personalizzato. Se utilizzi un file personalizzato, assicurati di:

Nota che l'esempio Dockerfile non include un'istruzione USER. Quando implementi un'immagine di container su Lambda, Lambda definisce automaticamente un utente Linux predefinito con autorizzazioni con privilegi minimi. Questo è diverso dal comportamento standard di Docker, che per impostazione predefinita è l'utente root quando non viene fornita alcuna istruzione USER.

# 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" ]

Installa lo strumento globale .NET Amazon.Lambda.Tools.

dotnet tool install -g Amazon.Lambda.Tools

Se Amazon.Lambda.Tools è già installato, assicurati di disporre della versione più recente.

dotnet tool update -g Amazon.Lambda.Tools

Passa alla directory MyFunction/src/MyFunction, se non lo hai ancora fatto.

cd src/MyFunction

Utilizza Amazon.Lambda.Tools per creare l'immagine Docker, trasferirla in un nuovo repository Amazon ECR e implementare la funzione Lambda.

Per --function-role, specifica il nome del ruolo, non il nome della risorsa Amazon (ARN), del ruolo di esecuzione della funzione. Ad esempio lambda-role.

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

Per ulteriori informazioni sullo strumento globale Amazon.Lambda.Tools, consulta l'archivio Extensions AWS for .NET CLI su. GitHub

Richiama la funzione.

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

In caso di esito positivo, viene visualizzato quanto segue:

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

Elimina la funzione Lambda.

dotnet lambda delete-function MyFunction

Installa il pacchetto Amazon.Lambda.Templates. NuGet

dotnet new install Amazon.Lambda.Templates

Crea un progetto .NET utilizzando il modello lambda.CustomRuntimeFunction. Questo modello include Amazon.Lambda. RuntimeSupportpacchetto.

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

Passa alla directory MyFunction/src/MyFunction. Qui sono archiviati i file del progetto. Esamina i seguenti file di log:

Apri il file aws-lambda-tools-defaults.json e aggiungi le righe seguenti.

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

Crea un Dockerfile nella directory MyFunction/src/MyFunction. Il seguente Dockerfile di esempio utilizza un'immagine di base Microsoft .NET anziché un'immagine di base AWS.

Nota che l'esempio Dockerfile non include un'istruzione USER. Quando implementi un'immagine di container su Lambda, Lambda definisce automaticamente un utente Linux predefinito con autorizzazioni con privilegi minimi. Questo è diverso dal comportamento standard di Docker, che per impostazione predefinita è l'utente root quando non viene fornita alcuna istruzione USER.

# 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"]

Installa lo strumento globale .NET Core Amazon.Lambda.Tools.

dotnet tool install -g Amazon.Lambda.Tools

Se Amazon.Lambda.Tools è già installato, assicurati di disporre della versione più recente.

dotnet tool update -g Amazon.Lambda.Tools

Utilizza Amazon.Lambda.Tools per creare l'immagine Docker, trasferirla in un nuovo repository Amazon ECR e implementare la funzione Lambda.

Per --function-role, specifica il nome del ruolo, non il nome della risorsa Amazon (ARN), del ruolo di esecuzione della funzione. Ad esempio lambda-role.

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

Per ulteriori informazioni sull'estensione CLI di Amazon.Lambda.Tools, consulta l'archivio Extensions for .NET CLI su.AWS GitHub

Richiama la funzione.

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

In caso di esito positivo, viene visualizzato quanto segue:

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

Elimina la funzione Lambda.

dotnet lambda delete-function MyFunction