Usando integrações de serviços simulados

Crie um arquivo chamado MockConfigFile.json para configurar testes com integrações de serviços simuladas.

O exemplo a seguir mostra um arquivo de configuração simulado referenciando uma máquina de estados com dois estados definidos chamados LambdaState e SQSState.

Você pode executar a definição da máquina de estado LambdaSQSIntegration referenciada no arquivo de configuração simulado usando um dos seguintes casos de teste:

Para obter informações sobre como iniciar execuções de teste com integrações de serviços simuladas, consulte Etapa 3: executar testes de integração de serviços simulados.

Certifique-se de que a estrutura das respostas simuladas esteja em conformidade com a estrutura das respostas de serviço reais que você recebe ao fazer chamadas de serviço integradas. Para obter informações sobre os requisitos estruturais para respostas simuladas, consulte Configurando integrações de serviços simuladas.

No exemplo anterior do arquivo de configuração simulado, as respostas simuladas são definidas em MockedLambdaSuccess e MockedLambdaRetry está em conformidade com a estrutura das respostas reais que são retornadas da chamada HelloFromLambda.

Crie uma máquina de estado com base na definição mencionada anteriormente no arquivo de configuração simulado.

aws stepfunctions create-state-machine \
    --endpoint http://localhost:8083 \
    --definition "{\"Comment\":\"Thisstatemachineiscalled:LambdaSQSIntegration\",\"StartAt\":\"LambdaState\",\"States\":{\"LambdaState\":{\"Type\":\"Task\",\"Resource\":\"arn:aws:states:::lambda:invoke\",\"Parameters\":{\"Payload.$\":\"$\",\"FunctionName\":\"arn:aws:lambda:us-east-1:123456789012:function:HelloWorldFunction\"},\"Retry\":[{\"ErrorEquals\":[\"States.ALL\"],\"IntervalSeconds\":2,\"MaxAttempts\":3,\"BackoffRate\":2}],\"Next\":\"SQSState\"},\"SQSState\":{\"Type\":\"Task\",\"Resource\":\"arn:aws:states:::sqs:sendMessage\",\"Parameters\":{\"QueueUrl\":\"https://sqs.us-east-1.amazonaws.com/123456789012/myQueue\",\"MessageBody.$\":\"$\"},\"End\":true}}}" \
    --name "LambdaSQSIntegration" --role-arn "arn:aws:iam::123456789012:role/service-role/LambdaSQSIntegration"

Execute a máquina de estado usando integrações de serviços simuladas.

Para usar o arquivo de configuração simulado, faça uma chamada de API StartExecution em uma máquina de estado configurada no arquivo de configuração simulado. Para fazer isso, anexe o sufixo, #test_name, ao ARN da máquina de estado usado por StartExecution. test_name é um caso de teste, configurado para a máquina de estado no mesmo arquivo de configuração simulado.

O comando a seguir é um exemplo que usa a máquina de estado LambdaSQSIntegration e a configuração simulada. Neste exemplo, a máquina de estado LambdaSQSIntegration é executada usando o teste HappyPath definido em Etapa 1: especificar integrações de serviços simulados em um arquivo de configuração simulado. O teste HappyPath contém a configuração da execução para lidar com chamadas simuladas de integração de serviços que os estados LambdaState e SQSState fazem usando as respostas de serviço simuladas MockedLambdaSuccess e MockedSQSSuccess.

aws stepfunctions start-execution \
    --endpoint http://localhost:8083 \
    --name executionWithHappyPathMockedServices \
    --state-machine arn:aws:states:us-east-1:123456789012:stateMachine:LambdaSQSIntegration#HappyPath

Veja a resposta de execução da máquina de estado.

A resposta à chamada StartExecution usando um teste simulado de integração de serviços é a mesma resposta à chamada StartExecution normal, que retorna o ARN da execução e a data de início.

Veja a seguir um exemplo de resposta à chamada StartExecution usando o teste simulado de integração de serviços:

{
   "startDate":"2022-01-28T15:03:16.981000-05:00",
   "executionArn":"arn:aws:states:us-east-1:123456789012:execution:LambdaSQSIntegration:executionWithHappyPathMockedServices"
}

Verifique os resultados da execução fazendo uma chamada de API ListExecutions, DescribeExecution ou GetExecutionHistory.

aws stepfunctions get-execution-history \
    --endpoint http://localhost:8083 \
    --execution-arn arn:aws:states:us-east-1:123456789012:execution:LambdaSQSIntegration:executionWithHappyPathMockedServices

O exemplo a seguir demonstra partes de uma resposta à chamada GetExecutionHistory usando o ARN de execução do exemplo de resposta mostrado na etapa 2. Neste exemplo, a saída de LambdaState e SQSState são os dados simulados definidos no arquivo de configuração simulado MockedLambdaSuccess e MockedSQSSuccess. Além disso, os dados simulados são usados da mesma forma que os dados retornados pela execução de chamadas reais de integração de serviços seriam usados. Além disso, neste exemplo, a saída de LambdaState é passada a SQSState como entrada.

{
    "events": [
        ...
        {
            "timestamp": "2021-12-02T19:39:48.988000+00:00",
            "type": "TaskStateEntered",
            "id": 2,
            "previousEventId": 0,
            "stateEnteredEventDetails": {
                "name": "LambdaState",
                "input": "{}",
                "inputDetails": {
                    "truncated": false
                }
            }
        },
        ...
        {
            "timestamp": "2021-11-25T23:39:10.587000+00:00",
            "type": "LambdaFunctionSucceeded",
            "id": 5,
            "previousEventId": 4,
            "lambdaFunctionSucceededEventDetails": {
                "output": "{\"statusCode\":200,\"body\":\"\\\"Hello from Lambda!\\\"\"}",
                "outputDetails": {
                    "truncated": false
                }
            }
        },
        ...
            "timestamp": "2021-12-02T19:39:49.464000+00:00",
            "type": "TaskStateEntered",
            "id": 7,
            "previousEventId": 6,
            "stateEnteredEventDetails": {
                "name": "SQSState",
                "input": "{\"statusCode\":200,\"body\":\"\\\"Hello from Lambda!\\\"\"}",
                "inputDetails": {
                    "truncated": false
                }
            }
        },
        ...
        {
            "timestamp": "2021-11-25T23:39:10.652000+00:00",
            "type": "TaskSucceeded",
            "id": 10,
            "previousEventId": 9,
            "taskSucceededEventDetails": {
                "resourceType": "sqs",
                "resource": "sendMessage",
                "output": "{\"MD5OfMessageBody\":\"3bcb6e8e-7h85-4375-b0bc-1a59812c6e51\",\"MessageId\":\"3bcb6e8e-8b51-4375-b0bc-1a59812c6e51\"}",
                "outputDetails": {
                    "truncated": false
                }
            }
        },
        ...
    ]
}