Introdução aos testes locais

Este tópico descreve o que você precisa para usar o AWS SAM CLI com AWS CDK aplicativos e fornece instruções para criar e testar localmente um AWS CDK aplicativo simples.

Pré-requisitos

Para testar localmente, você deve instalar o AWS SAM CLI. consulte Instalar o AWS SAM CLIpara obter instruções de instalação.

Criando e testando localmente um AWS CDK aplicativo

Para testar localmente um AWS CDK aplicativo usando o AWS SAM CLI, você deve ter um AWS CDK aplicativo que contenha uma função Lambda. Use as etapas a seguir para criar um AWS CDK aplicativo básico com uma função Lambda. Para obter mais informações, consulte Criar seu aplicativo sem servidor usando AWS CDK no Guia do desenvolvedor do AWS Cloud Development Kit (AWS CDK) .

Etapa 1: Criar um aplicativo do AWS CDK

Para este tutorial, inicialize um AWS CDK aplicativo que usa TypeScript.

Comando a ser executado:

$ mkdir cdk-sam-example
$ cd cdk-sam-example
$ cdk init app --language typescript

Etapa 2: adicionar uma função do Lambda ao seu aplicativo

Substitua o código em lib/cdk-sam-example-stack.ts pelo seguinte:

import { Stack, StackProps } from 'aws-cdk-lib';
import { Construct } from 'constructs';
import * as lambda from 'aws-cdk-lib/aws-lambda';

export class CdkSamExampleStack extends Stack {
  constructor(scope: Construct, id: string, props?: StackProps) {
    super(scope, id, props);

    new lambda.Function(this, 'MyFunction', {
      runtime: lambda.Runtime.PYTHON_3_12,
      handler: 'app.lambda_handler',
      code: lambda.Code.fromAsset('./my_function'),
    });
  }
}

Etapa 3: adicionar o código da função do Lambda

Crie um diretório chamado my_function. Nesse diretório, crie um arquivo chamado app.py.

Comando a ser executado:

$ mkdir my_function
$ cd my_function
$ touch app.py

Adicione o seguinte código a app.py:

def lambda_handler(event, context):
    return "Hello from SAM and the CDK!"

Etapa 4: testar sua função do Lambda

Você pode usar o AWS SAM CLI para invocar localmente uma função Lambda que você define em AWS CDK um aplicativo. Para fazer isso, você precisa do identificador de construção da função e do caminho para seu modelo sintetizado AWS CloudFormation .

Execute o comando a seguir para voltar ao lib diretório:

$  cd ..

Comando a ser executado:

$  cdk synth --no-staging

$  sam local invoke MyFunction --no-event -t ./cdk.out/CdkSamExampleStack.template.json

Exemplos de resultado:

Invoking app.lambda_handler (python3.9)
     
START RequestId: 5434c093-7182-4012-9b06-635011cac4f2 Version: $LATEST
"Hello from SAM and the CDK!"
END RequestId: 5434c093-7182-4012-9b06-635011cac4f2
REPORT RequestId: 5434c093-7182-4012-9b06-635011cac4f2	Init Duration: 0.32 ms	Duration: 177.47 ms	Billed Duration: 178 ms	Memory Size: 128 MB	Max Memory Used: 128 MB