Skip to content

feat(aws): add LocalStack configuration skill for local AWS services emulation #119

@giuseppe-trisciuoglio

Description

@giuseppe-trisciuoglio

Summary

  • Add a new skill for configuring LocalStack to emulate AWS services locally
  • Enable developers to test cloud applications locally before deploying to production
  • Support for major AWS services: Lambda, S3, SQS, SNS, DynamoDB, API Gateway, and more

Context

LocalStack is a fully functional local AWS cloud stack that provides an emulated environment for AWS services. It allows developers to develop and test cloud applications entirely on their local machine without connecting to AWS, reducing:

  • Development costs (no AWS usage fees during development)
  • CI/CD pipeline execution time
  • Dependency on external cloud connectivity

Changes Made

The new skill will provide:

  • Docker & Docker Compose Setup: Pre-configured docker-compose.yml files for both Community and Pro editions
  • Service Configuration: Endpoint mappings for AWS services (Lambda, S3, SQS, SNS, DynamoDB, API Gateway, etc.)
  • Hot Reloading: Configuration for Lambda hot-reloading during development
  • Multi-language SDK Integration: Examples for JavaScript (v3), Python (boto3), Java, and TypeScript
  • CI/CD Integration: Travis CI, GitHub Actions, and generic CI pipeline templates
  • State Management: Persistence and Cloud Pods configuration for state snapshot/restore
  • Testing Tools: Integration with Testcontainers and testing frameworks

Technical Details

LocalStack runs on localhost:4566 by default and supports:

  • Port range 4510-4559 for external services
  • S3 virtual host addressing at s3.localhost.localstack.cloud:4566
  • Mock AWS credentials (access_key: test, secret_key: test)
  • Lambda execution via Docker-in-Docker

References

Test Plan

  • Create skill structure in plugins/developer-kit-aws/skills/localstack/
  • Add SKILL.md with comprehensive usage instructions
  • Include Docker Compose templates (Community & Pro)
  • Add SDK configuration examples for Java, Python, TypeScript, JavaScript
  • Document CI/CD integration patterns
  • Validate with MCP scan checker
  • Test on local environment with sample Lambda function
  • Verify hot-reloading functionality
  • Add integration with existing AWS skills (Lambda, S3, SQS, SNS, DynamoDB)

Acceptance Criteria

  1. Skill follows DevKit validation standards
  2. Complete documentation for all major AWS services
  3. Working examples for at least 3 programming languages (Java, Python, TypeScript)
  4. Integration with existing developer-kit-aws plugin
  5. Security scan passes without critical warnings

Metadata

Metadata

Labels

enhancementNew feature or request

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions