Announcing the LocalStack 3.7 release!

LocalStack 3.7 is now available! This minor release introduces several new features, enhancements, and bug fixes, with a focus on improved parity with AWS, new DevX features, and enhanced local developer tooling.

Introduction

LocalStack 3.7 is now available! This minor release introduces several new features, enhancements, and bug fixes. The highlights include a new Lambda Debug Mode, state merging for Cloud Pods, support for DMS Serverless, and a new Lambda Event Source Mapping implementation.

Additionally, the Chaos Engineering dashboard now uses the Chaos API, and LocalStack now supports fetching logs for Ephemeral Instances. The Extensions interface is now embedded in the Web Application, and the CloudFormation provider has received new enhancements. The EC2 Libvirt VM manager and SES provider have also been updated with new features.

Get your free LocalStack account to access the latest features and enhancements in LocalStack 3.7!

How to upgrade?

To upgrade to LocalStack 3.7 using the LocalStack CLI, run the following command to update both the LocalStack Docker image and CLI to the latest version:

$ localstack update all

If using LocalStack with Docker CLI or Docker Compose, update the Docker image by running:

$ docker pull localstack/localstack:3.7.0 # Community Edition
$ docker pull localstack/localstack-pro:3.7.0 # Pro Edition

Pin the LocalStack version in your docker run command or Docker Compose file to 3.7.0.

What’s new in LocalStack 3.7?

• New Lambda Debug Mode (Preview)
• State merging for Cloud Pods
• Dry run for loading Cloud Pods
• Support for DMS Serverless
• Chaos Engineering dashboard now uses Chaos API
• Support for fetching LocalStack Ephemeral Instances logs
• Extensions interface is now embedded in the Web Application
• Support for LocalStack managed DevContainer Templates
• New Lambda Event Source Mapping implementation (Preview)
• Support for SSE-C validation in S3
• New EKS_K8S_PROVIDER environment variable
• New operations in the Resource Access Manager (RAM) provider
• Tagging operations in the EventBridge Pipes provider
• New enhancements in the CloudFormation provider
• New template option for the LocalStack Extensions CLI
• New enhancements in the EC2 Libvirt VM manager
• New EC2 Kubernetes executor (Preview)
• New enhancements in the SES provider
• Miscellaneous

New Lambda Debug Mode

You can now access a specialized set of features for debugging Lambda functions through the new Lambda Debug Mode, which is currently available in preview. This execution mode for LocalStack can be activated by setting LAMBDA_DEBUG_MODE=1.

The new Lambda Debug Mode introduces several enhancements aimed at improving the debugging experience for Lambda functions. These enhancements include automatic management of execution timeouts, integration with API Gateway, and the ability to assign specific ports to each Lambda function version for remote debugging. This setup allows for simultaneous debugging of Lambda functions within the same runtime environment.

To configure your debugging session, use a configuration file that LocalStack will recognize when you set LAMBDA_DEBUG_MODE_CONFIG_PATH to the file’s path. This configuration is effective only when Lambda Debug Mode is active. To begin, specify the qualified ARN of the Lambda function versions you wish to debug and assign each a dedicated debug port. For example:

functions:
    arn:aws:lambda:eu-central-1:000000000000:function:function-name:1
        debug-port: 19891
    ...

Learn more about Lambda Debug Mode in the LocalStack documentation.

State merging for Cloud Pods (Teams & Enterprise)

LocalStack Cloud Pods now offer different strategies for state merging into your LocalStack container. The available strategies include:

• overwrite: This strategy deletes the existing state and replaces it with the new state from the Cloud Pod, effectively resetting the LocalStack state.
• account-region-merge (default): This strategy merges services by account and region pairs, combining states from both the existing and the Cloud Pod for the same account and region.
• service-merge: This strategy merges services at the account-region level, assuming no resource overlap exists. It prioritizes the resources from the loaded state during the merge.

To activate these strategies, use --strategy <strategy> when loading the Cloud Pod, where <strategy> is one of the strategies mentioned above. For example, to use the service-merge strategy, run:

$ localstack pod load my-test-pod --strategy service-merge

To learn more about how it works, check out the Cloud Pods documentation.

Dry run for loading Cloud Pods (Teams & Enterprise)

To preview the changes that would occur when loading a Cloud Pod, you can now use the --dry-run flag. The result will depend on the selected merge strategy. The result will be displayed in the console, and no changes will be made to the LocalStack state. Here is a quick example:

$ localstack pod load my-test-pod --dry-run

This load operation modifies one or more resources in the application runtime.
The result will depend on the selected merge strategy. Use the --help option to
read more about it.

This load operation will modify the runtime state as follows:

──────────────────────────── sns ────────────────────────────
+ 2 resources added.
~ 1 resources modified.

──────────────────────── cognito-idp ────────────────────────
+ 1 resources added.
~ 0 resources modified.

──────────────────────────── sqs ────────────────────────────
+ 1 resources added.
~ 1 resources modified.

Support for DMS Serverless (Enterprise)

LocalStack now supports AWS Database Migration Service (DMS) Serverless. DMS serverless can be used for the sources and targets that LocalStack already supports, and that are also supported by AWS. To simulate the different states that a replication config experiences during provisioning, you can set the DMS_SERVERLESS_STATUS_CHANGE_WAITING_TIME environment variable. This setting delays each state change for the configured number of seconds until the replication is actively running. Refer to the official documentation for details on the different states.

Note that on AWS, replication table statistics are automatically deleted after the replication finishes and the configuration is deprovisioned. For parity, the same applies in LocalStack. To delay this de-provisioning process, you can set the DMS_SERVERLESS_DEPROVISIONING_DELAY environment variable, which defaults to 60 seconds.

Learn more about DMS in the LocalStack documentation.

Chaos Engineering dashboard now uses Chaos API (Enterprise)

The LocalStack Chaos Engineering dashboard now leverages the Chaos API to provide the following features:

• DynamoDB Error: Injects ProvisionedThroughputExceededException errors randomly into DynamoDB API responses.
• Kinesis Error: Injects ProvisionedThroughputExceededException errors randomly into Kinesis API responses.
• 500 Internal Error: Terminates incoming requests randomly, returning an Internal Server Error with a response code of 500.
• Service Unavailable: Causes a specific percentage of service API calls to receive a 503 Service Unavailable response.
• AWS Region Unavailable: Simulates regional outages and failovers by disabling entire AWS regions.
• Latency: Adds specified latency to every API call, useful for simulating network latency or degraded network performance.

Learn more about the Chaos Engineering Dashboard in the LocalStack documentation.

Support for fetching LocalStack Ephemeral Instances logs (Starter, Teams & Enterprise)

Ephemeral Instances in LocalStack now support fetching logs from the LocalStack container. You can navigate to the Ephemeral Instances page on the LocalStack Web Application and click on the Logs tab to view the logs for the running instance.

To learn more about Ephemeral Instances, check out the LocalStack documentation.

Extensions interface is now embedded in the Web Application (Starter, Teams & Enterprise)

The LocalStack Extensions interface is now embedded in the LocalStack Web Application. You can now use extensions, such as AWS Replicator and Mailhog, directly from our Web Application, consolidating all necessary tools in one interface. You can access the Extensions library by navigating to the Extensions section on the Web Application.

To learn more about LocalStack Extensions, check out the LocalStack documentation.

Support for LocalStack managed DevContainer Templates

LocalStack now offers a set of managed DevContainer Templates. The following templates are available:

• LocalStack Docker-in-Docker: Set up a DevContainer with LocalStack operating within an internal Docker service.
• LocalStack Docker-outside-of-Docker: Set up a DevContainer that communicates with a separate LocalStack instance running on the same Docker network.

Both variations of the Templates automatically add the official LocalStack DevContainer Feature, which installs the CLI and, on demand, the most popular local toolings (cdklocal, tflocal, awslocal, etc). Currently, this requires a Debian-based DevContainer image.

To learn more about LocalStack DevContainer Templates, check out the LocalStack documentation.

New Lambda Event Source Mapping implementation

LocalStack now supports a new implementation for Lambda Event Source Mapping (ESM) with improved reliability, performance, and AWS parity. You can use the LAMBDA_EVENT_SOURCE_MAPPING=v2 configuration variable to use the new ESM implementation. The ESM v2 implementation is also compatible with the Java-based event pattern rule engine (EVENT_RULE_ENGINE=java). However, the new ESM implementation is still in preview and may not support all features.

The improvements over ESM v1 include:

• Improved reliability through internal retries and separation of concern such that single exceptions or timeouts don’t affect other event source mappings.
• Improved performance by enabling concurrent event source mappings rather than having a single thread handling everything.
• Improved AWS parity, for example, related to filtering and SQS polling.

The limitations compared to ESM v1 include:

• Lambda Failure Destinations do not yet support FIFO SQS queues and SNS topics.
• Lambda Failure Destination Messages do not yet match the AWS structure, using a context similar to EventBridge Pipes instead of requestContext and responseContext.
• Partial Batch Responses using FunctionResponseTypes are not yet fully supported.
• Managed Streaming for Apache Kafka (MSK) event source is not yet supported.
• ESM Lifecycle State Updates only provide basic support for state updates, such as no failure states, and LastProcessingResult is not consistently updated.
• Persistence is not yet supported.

The limitations compared to AWS include:

• Lambda Success Destinations are not supported.
• Only very basic validations are performed upon creating and updating ESM.
• Streaming Pollers for Kinesis and DynamoDB do not implement features like:
  • BisectBatchOnFunctionError
  • MaximumBatchingWindowInSeconds
  • ParallelizationFactor
  • ScalingConfig
  • TumblingWindowInSeconds.

Support for SSE-C validation in S3

LocalStack’s S3 provider now supports SSE-C parameter validation for the following S3 APIs:

• PutObject
• GetObject
• HeadObject
• GetObjectAttributes
• CopyObject
• CreateMultipartUpload
• UploadPart

However, it’s important to note that LocalStack does not support the actual encryption and decryption of objects using SSE-C. Learn more about S3 in the LocalStack documentation.

New EKS_K8S_PROVIDER environment variable (Starter, Teams & Enterprise)

A new configuration variable EKS_K8S_PROVIDER has been introduced with two options:

• k3s (default, using k3d)
• local (using a mounted kubeconfig).

The kubeconfig inside the LocalStack container at /root/.kube/config no longer influences provider selection, but a warning is issued if it’s missing when using the local option. Kubeconfig files located on the host at ~/.kube/config are not automatically mounted; users must manually mount them if necessary.

Learn more about EKS in the LocalStack documentation.

Tagging operations in the EventBridge Pipes provider (Starter, Teams & Enterprise)

The following tagging operations for EventBridge Pipes have now been implemented:

Learn more about EventBridge Pipes in the LocalStack documentation.

New operations in the Resource Access Manager (RAM) provider (Starter, Teams & Enterprise)

The following operations have been implemented in the RAM provider:

Learn more about RAM in the LocalStack documentation.

New enhancements in the CloudFormation provider

LocalStack’s CloudFormation provider now supports the following enhancements:

• Users can now specify MFA configurations directly in the resource definition for AWS::Cognito::UserPool.
• ArchivePolicy settings are now supported in AWS::SNS::Topic resources.
• Default tags can now be configured for AWS::EC2::SecurityGroup.
• Users can now import existing EC2 SSH key pairs using the AWS::EC2::KeyPair resource.

Learn more about CloudFormation in the LocalStack documentation.

New template option for the LocalStack Extensions CLI (Starter, Teams & Enterprise)

Support has been added for the --template option in the localstack extensions dev new command. This option allows users to specify a template to use from the selection available at LocalStack Extensions Templates. Currently, the available templates include:

• basic
• react

To create a new extension using the react template, run:

$ localstack extensions dev new --template=react

The generated template will contain a simple Python distribution configuration and some boilerplate extension code.

New enhancements in the EC2 Libvirt VM manager (Starter, Teams & Enterprise)

The EC2 Libvirt VM manager now supports the following enhancements:

• You can use the EC2_HYPERVISOR_URI configuration variable to set the Libvirt connection URI, specifying the hypervisor host for the EC2 Libvirt VM manager. Currently, only QEMU drivers are supported.
• You can set the UserData field of the RunInstances API to a shell script that will be executed at the time of VM startup in the EC2 Libvirt VM manager.

New EC2 Kubernetes executor (Enterprise)

You can now run EC2 instances on Kubernetes. You can do so by setting the EC2_VM_MANAGER environment variable to kubernetes in the LocalStack container. Each EC2 instance in the Kubernetes VM manager is backed by a Pod.

The following operations are supported:

The current implementation is in preview and does not support volumes, custom AMIs, or networking features available in other VM managers.

New enhancements in the SES provider

The SES provider now supports the following enhancements:

• Improved SES provider to match AWS functionality more closely.
• DescribeActiveReceiptRuleSet now handles absent rule sets appropriately.
• DeleteReceiptRuleSet now requires prior deactivation.
• Enhanced error messaging and input validation for SetActiveReceiptRuleSet.

Miscellaneous

• Users should be able to use LocalStack in any region, encompassing standard AWS regions as well as specialized regions such as those in China, GovCloud, and ISO-partitions. (Enterprise)
• Cloud Pods now have folder support for S3 remote storage. Users would need to set their custom remote, and then specify the destination bucket with folders. (Teams & Enterprise)
• Support for custom URL aliases for Lambda Function URLs is now available in LocalStack. This feature allows users to assign custom IDs to either the $LATEST version of a function or to an existing version alias.
• LocalStack now supports prebuilding Lambda images before execution with the LAMBDA_PREBUILD_IMAGES configuration variable. This approach increases the cold start time but reduces the duration until the Lambda function becomes ACTIVE. (Preview)
• LocalStack now supports idempotent StartExecution operations against already running STANDARD Step Functions state machines with identical input.
• LocalStack’s S3 provider now supports conditional writes. You can use the PutObject or CompleteMultipartUpload API requests to check for an object’s existence before creating it to prevent accidental overwrites in both general-purpose and directory buckets.
• LocalStack now supports setting an SQS queue’s RedrivePolicy to an empty string, which will completely remove it from the queue’s Attributes map.
• LocalStack now includes more robust checks for the Lambda provider’s function_name and qualifier validations, enhancing AWS parity and coverage of naming edge cases.
• CloudFormation provider now emits *_IN_PROGRESS events, improving the visuals when using CDK with LocalStack.

Conclusion

This minor release underpins our commitment to providing a robust and feature-rich local cloud environment for developers, with a strong focus on improving parity with AWS, introducing new DevX features, and bringing new local developer tools to the LocalStack ecosystem. Upgrade to LocalStack 3.7 today to take advantage of these new features and enhancements!