Skip to content

v4.0.0
Compare
Choose a tag to compare
@localstack-bot localstack-bot released this 21 Nov 15:45
· 522 commits to master since this release
v4.0.0
2daa733

Summary

This is our fourth major release for LocalStack, bringing a host of new features, enhancements, and breaking changes designed to improve local cloud development & test experience! With LocalStack 4.0, we’re introducing support for foundation models through the new Bedrock provider, enhanced EventBridge & API Gateway support via a native implementation, and opening up the AWS “black box” with Event Studio to give developers the tools to understand, debug, and quickly iterate over their cloud applications.

Additionally, LocalStack's Web Application now includes new features like an improved IAM Policy Stream to generate security policies on the fly, a Stack Overview for quick insights into local cloud resources, and expanded Cloud Pods capabilities for better state management.

Breaking changes include the deprecation of legacy service providers and deprecated FIS actions alongside various Ubuntu AMI, Airflow & PostgreSQL versions. Deprecations are also aimed at improving security and compatibility, such as replacing legacy API keys with Auth Tokens and streamlining environment variable management.

This release reinforces our commitment to creating a comprehensive, reliable local cloud development platform, and continues our mission to become a drop-in replacement for AWS in your local environment, as well as meeting all your enterprise needs.

AWS Features

  • LocalStack now supports a new Bedrock provider that locally emulates foundation models (FMs) with features like Invoke API, Converse API & Batch processing. (🌟 enterprise)
  • LocalStack has switched the default implementation for the EventBridge to a new native provider offering improved reliability, performance, and AWS parity. The old EventBridge provider is temporarily available in LocalStack using PROVIDER_OVERRIDE_EVENTS=v1.
  • LocalStack has switched the default implementation for the API Gateway to a new native provider offering improved reliability, performance, and AWS parity. The old API Gateway provider is temporarily available in LocalStack using PROVIDER_OVERRIDE_APIGATEWAY=legacy.
  • Python 3.13 Lambda runtime is now supported in LocalStack.

LocalStack Features

  • LocalStack now features Event Studio in preview, which allows you to view data exchanges between AWS services, collect all events, inspect payloads and metadata, and replay events for all supported services at key steps. (🌟 pro)
  • Support for the official LocalStack SDK for Python is now available, enabling interaction with emulated services, along with proprietary features through our internal developer endpoints.
  • Support for hot reloading is now available for the Lambda Debug Mode configuration file. This feature updates the configuration every time modifications are detected, allowing for multiple debugging sessions of the same Lambda function.
  • Several user experience improvements have been introduced to the preview IAM Policy Stream feature in the LocalStack Web Application. This simplifies permission management by generating a continuous flow of IAM policies based on the AWS API calls your application infrastructure makes. (🌟 pro)
  • Support for a new Stack Overview feature that provides a summary of deployed resources, categorized services with configurations, and quick access to resource details like identifiers and endpoints. (🌟 pro)
  • Support for a new EventBridge Pipes Resource Browser, enabling you to set up direct integrations between event producers and consumers directly from your Web Browser or the LocalStack Desktop application. (🌟 pro)
  • Several new Cloud Pods capabilities have been introduced in the LocalStack Web Application: (🌟 teams)
  • Support for a new Ephemeral Instances CLI experience that allows users to run a LocalStack instance in the cloud, enabling instance creation & management directly from your terminal. (🌟 pro)
  • Users can now create a Cloud Pod at the shutdown of an Ephemeral Instance, allowing you to resume your application at the state where you left it off. (🌟 teams)
  • LocalStack Enterprise users can now automatically assign licenses to new workspace members through Single Sign-On. (🌟 enterprise)
  • Several new features have been introduced in the LocalStack Resource Browsers:
  • Kubernetes support for major computing and database services has been unified in LocalStack, allowing you to run a broader range of services on Kubernetes. These services include Lambda, ECS, DocumentDB, MWAA, and RDS (MySQL & MSSQL). Use the configuration variable CONTAINER_RUNTIME=kubernetes when starting LocalStack to enable Kubernetes executors for these services. (🌟 enterprise)

Enhancements

Breaking Changes

  • The following legacy service providers are being removed. Please update your configurations to use the latest versions by removing the specified settings.

    Service Configuration Being Removed
    Step Functions PROVIDER_OVERRIDE_STEPFUNCTIONS=legacy
    S3 (v2 Provider) PROVIDER_OVERRIDE_S3=legacy_v2
    ElastiCache PROVIDER_OVERRIDE_ELASTICACHE=legacy
    Event Source Mapping LAMBDA_EVENT_SOURCE_MAPPING=v1

  • The following custom LocalStack FIS actions are now removed:

    • localstack:generic:api-error
    • localstack:kms:inject-api-internal-error
    • localstack:log-debug
    • localstack:generic:latency

  • Outages Extension is no longer published on PyPI and will not be maintained anymore. Please follow our documentation to migrate to the Chaos API.

  • Support for the following deprecated Airflow versions for MWAA have been removed from LocalStack:

    • v1.10.12
    • v2.0.2
    • v2.2.2

  • Support for RDS PostgreSQL 10 has been removed from LocalStack.

  • Support for Ubuntu 20.04 AMI (ami-ff0fea8310f3) for EC2 has been removed from LocalStack.

  • Support for Python 3.8 in the Python distribution of the LocalStack CLI has been removed.

Deprecations

  • Auth tokens have fully replaced legacy API and CI keys for both personal and CI use, increasing security and enabling more detailed access control. Existing API and CI keys will function until early 2025, after which only Auth Tokens will be supported.
  • Lambda Kubernetes Executor has been migrated into LocalStack Enterprise.
  • Non-prefixed environment variables are now deprecated and users are encouraged to use a variable prefix (LOCALSTACK_) to better manage environment variables across different LocalStack versions.
  • LocalStack CLI will now exclusively use Auth Tokens for user identification and authentication. The localstack auth login command will be removed.
  • AWS credentials are no longer automatically set during Init Hooks execution. Scripts must now explicitly define these credentials due to LocalStack's shift to multi-account support to manage them based on request context.
  • In addition to the LocalStack runtime, the LocalStack CLI also adheres to semantic versioning. While running localstack --version, the output would point to LocalStack CLI before the version number.

What's Changed

New Contributors

Full Changelog: v3.8.1...v4.0.0

Contributors

simonrw, kjagiello, and 28 other contributors
Assets 2
Loading