Introdução aos testes em nuvem com evento de teste remoto do sam

Use o AWS Serverless Application Model comando Command Line Interface (AWS SAM CLI) sam remote test-event para acessar e gerenciar eventos de teste compartilháveis para suas AWS Lambda funções de eventos.

Para saber mais sobre eventos de teste compartilháveis, consulte Eventos de teste compartilháveis no Guia do desenvolvedor do AWS Lambda .

Pré-requisitos

Para usar o sam remote test-event, instale o AWS SAM CLI fazendo o seguinte:

• AWS SAM Pré-requisitos   .

• Instale o AWS SAM CLI.

Se você já tem o AWS SAM CLI instalado, recomendamos atualizar para a versão mais recente da AWS SAMCLI versão. Para saber mais, consulte Atualizar o AWS SAM CLI.

Antes de usar sam remote test-event, recomendamos uma compreensão básica do seguinte:

• Configurando o AWS SAM CLI.

• Crie seu aplicativo em AWS SAM.

• Introdução à construção com AWS SAM.

• Introdução à implantação com AWS SAM.

• Introdução ao uso mesma sincronização para sincronizar com Nuvem AWS.

Configure o AWS SAM CLI para usar evento de teste remoto do sam

Conclua as seguintes etapas de configuração para usar o AWS SAM CLI sam remote test-event comando:

1. Configure o AWS SAM CLI para usar seu Conta da AWS — Os eventos de teste compartilháveis do Lambda podem ser acessados e gerenciados por usuários dentro do mesmo. Conta da AWS Para configurar o AWS SAM CLI para usar o seu Conta da AWS, consulteConfigurando o AWS SAM CLI.

2. Configurar permissões para eventos de teste compartilháveis – Para acessar e gerenciar eventos de teste compartilháveis, você deve ter as permissões adequadas. Para saber mais, consulte Eventos de teste compartilháveis no Guia do desenvolvedor do AWS Lambda .

Usar o evento de teste remoto do sam command

O AWS SAM CLI sam remote test-event comando fornece os seguintes subcomandos que você pode usar para acessar e gerenciar seus eventos de teste compartilháveis:

• delete— Exclua um evento de teste compartilhável do registro de EventBridge esquemas da Amazon.

• get— Obtenha um evento de teste compartilhável do registro do EventBridge esquema.

• list— Liste os eventos de teste compartilháveis existentes para uma função do registro do EventBridge esquema.

• put— Salve um evento de um arquivo local no registro do EventBridge esquema.

Para listar esses subcomandos usando o AWS SAM CLI, execute o seguinte:

$ sam remote test-event --help

Excluindo eventos de teste compartilháveis

Você pode excluir um evento de teste compartilhável usando o subcomando delete junto com o seguinte:

• Forneça o nome do evento compartilhável de teste a ser excluído.

• Forneça uma identificação aceitável da função do Lambda associada ao evento.

• Se você estiver fornecendo o ID lógico da função Lambda, também deverá fornecer o nome da AWS CloudFormation pilha associado à função Lambda.

Este é um exemplo:

$ sam remote test-event delete HelloWorldFunction --stack-name sam-app --name demo-event

Para obter uma lista de opções a serem usadas com o subcomando delete, consulte exclusão remota de eventos de teste do sam. Você também pode executar o seguinte a partir do AWS SAM CLI:

$ sam remote test-event delete --help

Obtendo eventos de teste compartilháveis

Você pode obter um evento de teste compartilhável do registro do EventBridge esquema usando o get subcomando junto com o seguinte:

• Forneça o nome do evento de teste compartilhável a ser obtido.

• Forneça uma identificação aceitável da função do Lambda associada ao evento.

• Se você estiver fornecendo o ID lógico da função Lambda, também deverá fornecer o nome da AWS CloudFormation pilha associado à função Lambda.

Veja a seguir um exemplo que obtém um evento de teste compartilhável chamado demo-event associado à função do Lambda HelloWorldFunction da pilha sam-app. Esse comando imprimirá o evento em seu console.

$ sam remote test-event get HelloWorldFunction --stack-name sam-app --name demo-event

Para obter um evento de teste compartilhável e salvá-lo em sua máquina local, use a opção --output-file e forneça um nome e um caminho de arquivo. Veja a seguir um exemplo que salva demo-event como demo-event.json no diretório de trabalho atual:

$ sam remote test-event get HelloWorldFunction --stack-name sam-app --name demo-event --output-file demo-event.json

Para obter uma lista de opções a serem usadas com o subcomando get, consulte sam remote test-event get. Você também pode executar o seguinte a partir do AWS SAM CLI:

$ sam remote test-event get --help

Listando eventos de teste compartilháveis

Você pode listar todos os eventos de teste compartilháveis para uma função do Lambda específica no registro do esquema. Use o subcomando list junto com o seguinte:

• Forneça um ID aceitável da função do Lambda associada aos eventos.

• Se você estiver fornecendo o ID lógico da função Lambda, também deverá fornecer o nome da CloudFormation pilha associado à função Lambda.

Veja a seguir um exemplo que obtém uma lista de todos os eventos de teste compartilháveis associados à função do Lambda HelloWorldFunction da pilha sam-app:

$ sam remote test-event list HelloWorldFunction --stack-name sam-app

Para obter uma lista de opções a serem usadas com o subcomando list, consulte lista de eventos de teste remotos sam. Você também pode executar o seguinte a partir do AWS SAM CLI:

$ sam remote test-event list --help

Salvando eventos de teste compartilháveis

Você pode salvar eventos de teste compartilháveis no registro do EventBridge esquema. Use o subcomando put junto com o seguinte:

• Forneça uma ID aceitável da função do Lambda associada ao evento de teste compartilhável.

• Forneça um nome para o evento compartilhável de teste.

• Forneça o caminho e o nome do arquivo para o evento local a ser carregado.

Veja a seguir um exemplo que salva o evento local demo-event.json como demo-event e o associa à função do Lambda HelloWorldFunction da pilha sam-app:

$ sam remote test-event put HelloWorldFunction --stack-name sam-app --name demo-event --file demo-event.json

Se existir um evento de teste compartilhável com o mesmo nome no registro do EventBridge esquema, AWS SAM CLI ele não o substituirá. Para sobrescrever, adicione a opção --force ao seu comando.

Para obter uma lista de opções a serem usadas com o subcomando put, consulte mesma saída remota de eventos de teste. Você também pode executar o seguinte a partir do AWS SAM CLI:

$ sam remote test-event put --help

Usando eventos de teste compartilháveis

Use eventos de teste compartilháveis para testar suas funções do Lambda com Nuvem AWS sam remote invoke o comando. Para saber mais, consulte Transmita eventos de teste compartilháveis para uma função de evento Lambda na nuvem.

Usando eventos de teste compartilháveis

Este tópico contém exemplos de como você pode gerenciar e usar eventos de teste compartilháveis.

Obtenha um evento de teste compartilhável, modifique-o e use-o

Você pode obter um evento de teste compartilhável do registro do EventBridge esquema, modificá-lo localmente e usar o evento de teste local com sua função Lambda no. Nuvem AWS Este é um exemplo:

1. Recupere o evento de teste compartilhável – Use o subcomando sam remote test-event get para recuperar um evento de teste compartilhável para uma função do Lambda específica e salvá-lo localmente:

   $ sam remote test-event get HelloWorldFunction --stack-name sam-app --name demo-event --output-file demo-event.json

2. Modificar o evento de teste compartilhável – Use um editor de texto de sua escolha para modificar o evento de teste compartilhável.

3. Use o evento de teste compartilhável – Use o comando sam remote invoke e forneça o caminho do arquivo e o nome do evento com --event-file:

   $ sam remote invoke HelloWorldFunction --stack-name sam-app --event-file demo-event.json

Obtenha um evento de teste compartilhável, modifique-o, carregue-o e use-o

Você pode obter um evento de teste compartilhável do registro do EventBridge esquema, modificá-lo localmente e carregá-lo. Em seguida, você pode passar o evento de teste compartilhável diretamente para sua função do Lambda no Nuvem AWS. Este é um exemplo:

1. Recupere o evento de teste compartilhável – Use o subcomando sam remote test-event get para recuperar um evento de teste compartilhável para uma função do Lambda específica e salvá-lo localmente:

   $ sam remote test-event get HelloWorldFunction --stack-name sam-app --name demo-event --output-file demo-event.json

2. Modificar o evento de teste compartilhável – Use um editor de texto de sua escolha para modificar o evento de teste compartilhável.

3. Carregar o evento de teste compartilhável — Use o sam remote test-event put subcomando para carregar e salvar o evento de teste compartilhável no registro do EventBridge esquema. Neste exemplo, usamos a opção --force de sobrescrever uma versão mais antiga do nosso teste compartilhável:

   $ sam remote test-event put HelloWorldFunction --stack-name sam-app --name demo-event --file demo-event.json --force

4. Passe o evento de teste compartilhável para sua função do Lambda – Use o comando sam remote invoke para passar o evento de teste compartilhável diretamente para sua função do Lambda no Nuvem AWS:

   $ sam remote invoke HelloWorldFunction --stack-name sam-app --test-event-name demo-event