Skip to content

Ministack: Free, open-source local AWS emulator - 60+ services, Terraform compatible, real databases. Free forever. MIT licensed.

Release/v1.4.6 (#1198)

Nahuel Nuceraf73fa4fe9b10
diff --git a/CHANGELOG.md b/CHANGELOG.md
index cc57dad2..bae8cef3 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,8 +7,24 @@ Versioning follows [Semantic Versioning](https://semver.org/).
## [Unreleased]
+## [1.4.6] — 2026-07-24
+
+### Added
+- **EC2 — `AWS::EC2::VPCEndpoint` CloudFormation support** — VPC endpoints now provision through CloudFormation into the shared EC2 state, so `DescribeVpcEndpoints` returns them; `Ref` returns the `vpce-` id and `Fn::GetAtt` exposes `Id`. Endpoint type, VPC/route/subnet/security-group associations, tags, and in-place updates are supported. Contributed by @robert-pitt-foodhub.
+- **API Gateway v1 — `AWS::ApiGateway::DocumentationVersion` CloudFormation support** — documentation versions now create, update, and replace through CloudFormation; `Ref` returns the `{RestApiId}/{DocumentationVersion}` identity, and a version change triggers replacement. Contributed by @robert-pitt-foodhub.
+- **API Gateway v1 — `AWS::ApiGateway::RequestValidator` CloudFormation support** — request validators now provision through CloudFormation; both `Ref` and `Fn::GetAtt RequestValidatorId` return the validator id. A `Name` or `RestApiId` change triggers replacement while the validation flags update in place. Contributed by @robert-pitt-foodhub.
+- **AppSync — `AWS::AppSync::FunctionConfiguration` CloudFormation support** — pipeline functions now provision through CloudFormation; `Ref` returns the function ARN and `Fn::GetAtt` exposes `FunctionArn`, `FunctionId`, `Name`, and `DataSourceName`. An `ApiId` change triggers replacement. Contributed by @robert-pitt-foodhub.
+- **Lambda — `AWS::Lambda::Url` CloudFormation support** — function URLs now provision through CloudFormation and share the Function URL API state; `Fn::GetAtt` exposes `FunctionArn` and `FunctionUrl`, `AuthType`/`InvokeMode`/`Cors` update in place, and a `TargetFunctionArn` or `Qualifier` change triggers replacement. `UpdateFunctionUrlConfig` now also applies `InvokeMode`. Contributed by @robert-pitt-foodhub.
+- **CloudWatch Logs — `AWS::Logs::ResourcePolicy` CloudFormation support** — resource policies now provision through CloudFormation; `Ref` returns the `PolicyName`, a policy-document change updates in place, and a `PolicyName` change triggers replacement. Contributed by @robert-pitt-foodhub.
+- **CloudFront — `AWS::CloudFront::CloudFrontOriginAccessIdentity` CloudFormation support** — origin access identities now provision through CloudFormation; `Ref` returns the identity id (`E…`) and `Fn::GetAtt` exposes `Id` and `S3CanonicalUserId`, both retained across comment updates. Contributed by @robert-pitt-foodhub.
+- **API Gateway v1 — `GetExport`** — a REST API stage can now be exported as OpenAPI 3 (`oas30`) or Swagger 2 (`swagger`), in JSON or YAML, with the optional `integrations` extension included on request. Contributed by @robert-pitt-foodhub.
+- **RDS — Aurora MySQL global replication** — Aurora MySQL 8 global clusters now replicate from the global writer to secondary-region readers over GTID-based binary log replication, with binlog retention bounded on the source and fail-closed handling for volumes initialized by an older version. Contributed by @Areson.
+- **Region scoping — Athena, Auto Scaling, Cloud Map, EFS, EMR, Inspector2, Amazon MQ, AppSync, and S3 Files** — state is now isolated by account and region, so same-named resources in different regions no longer collide. Persisted state carries a versioned regional schema (on-disk format v3) that an older binary refuses rather than misreads, and legacy state migrates by recovering each record's region from its stored ARNs. Contributed by @Areson.
+
### Fixed
- **API Gateway v2 — `queryStringParameters`/`body` sent as `null` instead of omitted** — the HTTP API v2 Lambda proxy event included `queryStringParameters`/`body` with a `null` value when a request had no query string or no payload, rather than omitting the key entirely as real AWS does. Strict event-shape validators (e.g. AWS Lambda Powertools' `isAPIGatewayProxyEventV2`) accept `undefined` or a proper value but reject `null`, so every bodyless or querystring-less request against such a validator failed with an unhandled `InvalidEventError`, even though the invocation itself succeeded and the Lambda's own business logic never ran. Contributed by @ryan-bennett.
+- **Cognito — Hosted UI bound the authorization code to the raw email alias instead of the resolved Username** — in pools with `UsernameAttributes` or `AliasAttributes`, the email entered on the Hosted UI login page was bound to the authorization code verbatim, so the code exchange keyed off the alias rather than the user's real Username. The login and new-password submit paths now bind the code to the Username resolved by the alias lookup. Contributed by @kjdev.
+- **CloudFormation/Lambda — Docker-executed custom resources hung because the `ResponseURL` used `localhost`** — with `LAMBDA_EXECUTOR=docker`, a Lambda-backed custom resource completed its work but could not post its completion callback: the `ResponseURL` pointed at `localhost`, which inside the Lambda container resolves to the container itself rather than the host running MiniStack, so the PUT failed with connection refused and the stack sat in `CREATE_IN_PROGRESS` until the one-hour service timeout. The `ResponseURL` handed to a container-executed custom resource now rewrites `localhost`/`127.0.0.1` to `host.docker.internal`, the same host already used for `AWS_ENDPOINT_URL`; explicitly configured hostnames are left untouched. Reported by @robert-pitt-foodhub.
## [1.4.5] — 2026-07-22
diff --git a/README.md b/README.md
index 3024da70..61833ccf 100644
--- a/README.md
+++ b/README.md
@@ -215,7 +215,7 @@ use1.list_tables()["TableNames"] # → ["users"]
euw1.list_tables()["TableNames"] # → [] — eu-west-1 is independent
```
-**Region-isolated services:** AppConfig, Bedrock (all four services), CloudWatch, CloudWatch Logs, DynamoDB (tables, metadata, Streams), Lambda (functions, event source mappings, durable executions), MSK, RDS, S3 Tables, Secrets Manager, SQS, SSM Parameter Store, and Step Functions (1.4.0); EventBridge Pipes (1.4.1); SNS, Kinesis, KMS, and ElastiCache (1.4.2); EventBridge, ECS, and Firehose (1.4.3); EventBridge Scheduler, CodeBuild, and Resource Groups (1.4.4); Batch and SES (1.4.5).
+**Region-isolated services:** AppConfig, Bedrock (all four services), CloudWatch, CloudWatch Logs, DynamoDB (tables, metadata, Streams), Lambda (functions, event source mappings, durable executions), MSK, RDS, S3 Tables, Secrets Manager, SQS, SSM Parameter Store, and Step Functions (1.4.0); EventBridge Pipes (1.4.1); SNS, Kinesis, KMS, and ElastiCache (1.4.2); EventBridge, ECS, and Firehose (1.4.3); EventBridge Scheduler, CodeBuild, and Resource Groups (1.4.4); Batch and SES (1.4.5); Athena, Auto Scaling, Cloud Map, EFS, EMR, Inspector2, Amazon MQ, AppSync, and S3 Files (1.4.6).
Cross-resource references resolve in the referenced ARN's own account and region (SNS→SQS fanout, EventBridge targets, event source mappings), and cross-region references that real AWS rejects return the same errors AWS returns — e.g. invoking a `eu-west-1` Lambda from a `us-east-1` Step Functions task fails with `Functions from 'eu-west-1' are not reachable in this region`, exactly as on AWS.
diff --git a/ministack/services/rds.py b/ministack/services/rds.py
index c87b9b01..c4fb8aa9 100644
--- a/ministack/services/rds.py
+++ b/ministack/services/rds.py
@@ -93,10 +93,11 @@ _MYSQL_CONTROL_USER = "rdsadmin"
_MYSQL_CONTROL_PASSWORD = "ministack-rds-control"
_MYSQL_REPLICATION_RETRY_ATTEMPTS = 60
_MYSQL_REPLICATION_RETRY_INTERVAL = 1
-_MYSQL_BINLOG_RETENTION_SECONDS = max(
- 1,
- int(os.environ.get("RDS_MYSQL_BINLOG_RETENTION_SECONDS", "604800")),
-)
+# Internal binlog retention for the local MySQL container, long enough for
+# replicas to catch up. Not an AWS-facing knob: Aurora exposes retention per
+# cluster through the mysql.rds_set_configuration stored procedure (hours),
+# not an environment variable.
+_MYSQL_BINLOG_RETENTION_SECONDS = 604800 # 7 days
# Aurora MySQL versions are the creatable set returned by AWS RDS as of
# 2026-07-09. Refresh with:
diff --git a/pyproject.toml b/pyproject.toml
index 7ec5c85e..9cf67d72 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
[project]
name = "ministack"
-version = "1.4.5"
+version = "1.4.6"
description = "Free, open-source local AWS emulator — drop-in LocalStack replacement"
readme = "README.md"
license = { file = "LICENSE" }