Acelere testes Serverless com integração do LocalStack no VS Code IDE

Por Micah Walter, Sr. Solutions Architect na AWS.

Hoje, estamos anunciando a integração do LocalStack no AWS Toolkit for Visual Studio Code que torna mais fácil do que nunca para desenvolvedores testarem e depurarem aplicações Serverless localmente. Esta melhoria complementa nossas melhorias recentes na experiência de desenvolvimento do AWS Lambda, incluindo a integração do console ao IDE e capacidades de depuração remota que lançamos em julho de 2025, continuando nosso compromisso de simplificar o desenvolvimento Serverless na Amazon Web Services (AWS).

Ao construir aplicações Serverless, desenvolvedores geralmente focam em três áreas principais para otimizar sua experiência de teste: testes unitários, testes de integração e depuração de recursos em execução na nuvem. Embora o AWS Serverless Application Model Command Line Interface (AWS SAM CLI) forneça excelentes capacidades de teste local unitário para funções Lambda individuais, desenvolvedores trabalhando com arquiteturas orientadas a eventos que envolvem múltiplos serviços AWS, como Amazon Simple Queue Service (Amazon SQS), Amazon EventBridge e Amazon DynamoDB, precisam de uma solução abrangente para testes de integração locais. Embora o LocalStack oferecia emulação local de serviços AWS, desenvolvedores precisavam gerenciá-lo anteriormente como uma ferramenta independente, exigindo configuração complexa e trocas frequentes de contexto entre múltiplas interfaces, o que desacelerava o ciclo de desenvolvimento.

Integração do LocalStack no AWS Toolkit for VS Code

Para resolver esses desafios, estamos introduzindo a integração do LocalStack para que desenvolvedores possam conectar o AWS Toolkit for VS Code diretamente aos endpoints do LocalStack. Com esta integração, desenvolvedores podem testar e depurar aplicações Serverless sem trocar de ferramentas ou gerenciar configurações complexas do LocalStack. Desenvolvedores agora podem emular fluxos de trabalho orientados a eventos de ponta a ponta envolvendo serviços como Lambda, Amazon SQS e EventBridge localmente, sem precisar gerenciar várias ferramentas, realizar configurações complexas de endpoints ou lidar com problemas de limites de serviço que anteriormente exigiam conexão com recursos na nuvem.

O principal benefício desta integração é que o AWS Toolkit for VS Code agora pode se conectar a endpoints personalizados como o LocalStack, algo que não era possível antes. Anteriormente, para apontar o AWS Toolkit for VS Code para seu ambiente LocalStack, desenvolvedores tinham que fazer configuração manual e troca de contexto entre ferramentas.

Começar com o LocalStack no VS Code é simples. Desenvolvedores podem começar com a versão Free do LocalStack, que fornece emulação local para serviços AWS principais, ideal para desenvolvimento e testes em estágio inicial. Usando o tutorial guiado de aplicação no VS Code, desenvolvedores podem instalar o LocalStack diretamente da interface do toolkit, que instala automaticamente a extensão do LocalStack e os guia através do processo de configuração. Quando está configurado, desenvolvedores podem implantar aplicações Serverless diretamente no ambiente emulado e testar suas funções localmente, tudo sem sair do seu IDE.

Vamos experimentar

Primeiro, vou atualizar minha cópia do AWS Toolkit for VS Code para a versão mais recente. Após fazer isso, posso ver uma nova opção quando vou para Application Builder e clico em Walkthrough of Application Builder. Isso me permite instalar o LocalStack com um único clique.

Após completar a configuração do LocalStack, posso iniciá-lo a partir da barra de status e então poderei selecionar o LocalStack da lista dos meus perfis AWS configurados. Neste exemplo, estou usando o Application Composer para construir uma arquitetura Serverless simples usando Amazon API Gateway, Lambda e DynamoDB. Normalmente, eu implantaria isso na AWS usando AWS SAM. Neste caso, vou usar o mesmo comando AWS SAM para implantar minha stack localmente.

Eu apenas faço `sam deploy –guided –profile localstack` da linha de comando e sigo os prompts usuais. Implantar no LocalStack usando AWS SAM CLI fornece exatamente a mesma experiência que estou acostumado ao implantar na AWS. Na captura de tela abaixo, posso ver a saída padrão do AWS SAM, assim como meus novos recursos do LocalStack listados no AWS Toolkit Explorer.

Posso até entrar em uma função Lambda e editar o código da função que implantei localmente!

No site do LocalStack, posso fazer login e verificar todos os recursos que tenho executando localmente. Na captura de tela abaixo, você pode ver a tabela DynamoDB local que acabei de implantar.

Fluxo de trabalho de desenvolvimento aprimorado

Essas novas capacidades complementam nossa integração console-para-IDE recentemente lançada e recursos de depuração remota, criando uma experiência de desenvolvimento abrangente que atende diferentes necessidades de teste ao longo do ciclo de vida de desenvolvimento. O AWS SAM CLI fornece excelente teste local para funções Lambda individuais, lidando com cenários de teste unitário de forma eficaz. Para testes de integração, a integração do LocalStack permite testar fluxos de trabalho de múltiplos serviços localmente sem a complexidade de permissões do AWS Identity and Access Management (IAM), configurações do Amazon Virtual Private Cloud (Amazon VPC) ou problemas de limites de serviço que podem desacelerar a velocidade de desenvolvimento.

Quando desenvolvedores precisam testar usando serviços AWS em ambientes de desenvolvimento, eles podem usar nossas capacidades de depuração remota, que fornecem acesso completo a recursos do Amazon VPC e funções IAM. Esta abordagem em camadas libera desenvolvedores para se concentrarem na lógica de negócios durante as fases iniciais de desenvolvimento usando o LocalStack, e então fazer a transição perfeitamente para testes baseados na nuvem quando precisam validar contra comportamentos e configurações de serviços AWS. A integração elimina a necessidade de trocar entre várias ferramentas e ambientes, para que desenvolvedores possam identificar e corrigir problemas mais rapidamente enquanto mantêm a flexibilidade de escolher a abordagem de teste certa para suas necessidades específicas.

Agora disponível

Você pode começar a usar esses novos recursos através do AWS Toolkit for VS Code atualizando para v3.74.0. A integração do LocalStack está disponível em todas as Regiões AWS comerciais, exceto nas Regiões AWS GovCloud (US). Para saber mais, visite a documentação do AWS Toolkit for VS Code e Lambda.

Para desenvolvedores que precisam de cobertura de serviços mais ampla ou capacidades avançadas, o LocalStack oferece camadas adicionais com recursos expandidos. Não há custos adicionais da AWS para usar esta integração.

Essas melhorias representam mais um passo significativo em nosso compromisso contínuo de simplificar a experiência de desenvolvimento Serverless. No último ano, nos concentramos em fazer do VS Code a ferramenta de escolha para desenvolvedores Serverless, e esta integração do LocalStack continua essa jornada fornecendo ferramentas para desenvolvedores construírem e testarem aplicações Serverless de forma mais eficiente do que nunca.

Este conteúdo foi traduzido do post original do blog, que pode ser encontrado aqui.

Autor

Micah Walter é um Sr. Solutions Architect apoiando clientes corporativos na região de Nova York e além. Ele aconselha executivos, engenheiros e arquitetos em cada etapa de sua jornada para a nuvem, com um foco profundo em sustentabilidade e design prático. Em seu tempo livre, Micah gosta de atividades ao ar livre, fotografia e brincar com seus filhos pela casa.

Tradutores

	Rodrigo Peres é Arquiteto de Soluções na AWS, com mais de 20 anos de experiência trabalhando com arquitetura de soluções, desenvolvimento de sistemas e modernização de sistemas legados.
	Daniel Abib é arquiteto de soluções sênior na AWS, com mais de 25 anos trabalhando com gerenciamento de projetos, arquiteturas de soluções escaláveis, desenvolvimento de sistemas e CI/CD, microsserviços, arquitetura Serverless & Containers e segurança. Ele trabalha apoiando clientes corporativos, ajudando-os em sua jornada para a nuvem. https://www.linkedin.com/in/danielabib/