Skip to content

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

release v1.3.62 (#894)

Nahuel Nucera2bcfaae89862
diff --git a/CHANGELOG.md b/CHANGELOG.md
index db6d5f0e..55941eaa 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,21 +5,18 @@ All notable changes to MiniStack will be documented here.
Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
Versioning follows [Semantic Versioning](https://semver.org/).
-Unreleased
+## [1.3.62] — 2026-06-11
-- **Glue — Iceberg REST catalog data plane** — read-path subset of the Apache Iceberg REST OpenAPI spec at `/iceberg/v1/...`, mirroring AWS Glue's `glue.<region>.amazonaws.com/iceberg` endpoint (prefix shape `catalogs/{catalog}`). `GET /v1/config`, ListNamespaces, GetNamespace, ListTables, LoadTable, HEAD TableExists; writes return 501. Glue tables participate when `Parameters["metadata_location"]` points at an Iceberg metadata.json on MiniStack S3 (written by an external engine such as Trino/Spark); the metadata.json is passed through verbatim. Routed by the `glue` SigV4 credential scope — distinct from the S3 Tables Iceberg surface, exactly as on real AWS. Lets DuckDB's `iceberg` extension `ATTACH '<account_id>' (TYPE iceberg, ENDPOINT 'localhost:4566/iceberg', AUTHORIZATION_TYPE 'sigv4')` (requires `USE_SSL=1`; DuckDB hardcodes HTTPS).
-
----
-- **IAM — `GenerateServiceLastAccessedDetails`, `GetServiceLastAccessedDetails`** — Access Advisor generate→get job handshake. Returns a UUID `JobId`. `GetServiceLastAccessedDetails` returns `JobStatus=COMPLETED` and an empty `ServicesLastAccessed` list (no CloudTrail data).
-
-
----
-
-## [Unreleased]
+### Added
+- **Glue — Iceberg REST Catalog (Glue-backed)** — read-path subset of the Apache Iceberg REST OpenAPI at `/iceberg`, mirroring AWS Glue's `glue.<region>.amazonaws.com/iceberg` endpoint (prefix shape `catalogs/{catalog}`), served on the `glue` credential scope — distinct from the S3 Tables Iceberg surface, exactly as on real AWS. `GET /v1/config`, `ListNamespaces`, `GetNamespace`, `ListTables`, `LoadTable`, `HEAD` `TableExists`; writes return 501. A Glue table participates when its `Parameters["metadata_location"]` points at an Iceberg `metadata.json` on MiniStack S3 (written by an external engine such as Trino/Spark; passed through verbatim). Lets DuckDB's `iceberg` extension `ATTACH` against MiniStack (requires `USE_SSL=1`). Contributed by @yonatoasis.
+- **Glue — `ColumnStatistics` API family (Table + Partition)** — `UpdateColumnStatisticsForTable` / `GetColumnStatisticsForTable` / `DeleteColumnStatisticsForTable` and the `*ForPartition` equivalents, with AWS's `{ColumnStatisticsList, Errors}` / `{Errors}` response shapes and per-column `EntityNotFoundException` error entries. Stats are account-scoped, persisted, and cleared when the owning table/partition is deleted. Contributed by @yonatoasis.
### Fixed
-- **CloudFormation — `DescribeStackEvents` returns the initial `REVIEW_IN_PROGRESS` event for change-set-created stacks** — creating a stack via `CreateChangeSet` with `--change-set-type CREATE` left the placeholder stack in `REVIEW_IN_PROGRESS` but seeded an empty event list, so `DescribeStackEvents` returned `[]`. AWS records an initial `REVIEW_IN_PROGRESS` event for the `AWS::CloudFormation::Stack` resource at this point; tools that read `StackEvents[0]`, notably `sam deploy`, crashed with `IndexError: list index out of range`. The placeholder stack now emits the `REVIEW_IN_PROGRESS` event on creation.
-- **Step Functions — `ecs:runTask` / `ecs:runTask.sync` no longer drop `ContainerOverrides`** — the Pascal→camelCase conversion at the SFN→ECS hand-off only covered top-level Parameters keys, so `Overrides.ContainerOverrides` (including resolved `"Value.$"` entries) stayed PascalCase and was silently ignored: the container ran with task-definition env only while the task launched and the `.sync` state succeeded. The conversion is now recursive; nested `NetworkConfiguration` is covered by the same pass. (#886)
+- **CloudFormation — `DescribeStackEvents` returns the initial `REVIEW_IN_PROGRESS` event for change-set-created stacks** — `CreateChangeSet` with `--change-set-type CREATE` left the placeholder stack in `REVIEW_IN_PROGRESS` but seeded an empty event list, so `DescribeStackEvents` returned `[]` and tools reading `StackEvents[0]` (notably `sam deploy`) crashed with `IndexError`. The placeholder stack now emits the `REVIEW_IN_PROGRESS` event for the `AWS::CloudFormation::Stack` resource on creation. Contributed by @maximoosemine.
+- **Step Functions — `ecs:runTask` / `ecs:runTask.sync` no longer drop `ContainerOverrides`** — the Pascal→camelCase conversion at the SFN→ECS hand-off only covered top-level `Parameters` keys, so nested `Overrides.ContainerOverrides` (including resolved `"Value.$"` entries) and `NetworkConfiguration` stayed PascalCase and were silently ignored — the container ran with task-definition environment only while the `.sync` state still succeeded. The conversion is now recursive. Contributed by @lucasmfraser.
+- **Lambda — layers are reachable in the docker executor, and zip permissions are preserved** — the docker RIE executor extracted each layer to `/opt/layer_N`, which is not on the runtime's search path, so `import` from a layer failed; layer contents now merge into `/opt` (so `/opt/python`, `/opt/lib`, `/opt/bin` resolve), exactly as on real AWS. Layer and function zip extraction now also restores unix mode bits, so `/opt/bin` tools and bundled binaries keep their `+x`. Reported by @omargr299.
+- **`awslocal` works in TLS mode without `--no-verify-ssl`** — the wrapper now resolves MiniStack's TLS certificate (the auto-generated `${TMPDIR}/ministack-tls/server.crt`, or a `MINISTACK_SSL_CERT` / `MINISTACK_CA_BUNDLE` override) and exports `AWS_CA_BUNDLE` only when it points at a real file, so the AWS CLI verifies the cert instead of failing — plain-HTTP usage is untouched. Reported by @ChronosMasterOfAllTime.
+- **Lambda — restored SQS event source mappings resume polling after a warm restart** — the ESM poller is started from `lambda_svc`'s import-time restore, but the module was imported lazily only on a Lambda request, so after a persisted restart a pure-SQS workload (just sending to a mapped queue) never started the poller and the restored mapping sat `Enabled` but unpolled while messages piled up. `lambda_svc` is now eager-imported at boot when persisted ESMs exist, so polling resumes exactly like a fresh `CreateEventSourceMapping`. Reported by @ChronosMasterOfAllTime.
---
diff --git a/README.md b/README.md
index 7eb45298..ade45ded 100644
--- a/README.md
+++ b/README.md
@@ -499,7 +499,7 @@ Unsupported resource types fail with `CREATE_FAILED` (or `ROLLBACK_COMPLETE` if
| **ECS** | CreateCluster, DeleteCluster, DescribeClusters, ListClusters, UpdateCluster, UpdateClusterSettings, PutClusterCapacityProviders, RegisterTaskDefinition, DeregisterTaskDefinition, DescribeTaskDefinition, ListTaskDefinitions, ListTaskDefinitionFamilies, DeleteTaskDefinitions, CreateService, DeleteService, DescribeServices, UpdateService, ListServices, ListServicesByNamespace, RunTask, StopTask, DescribeTasks, ListTasks, ExecuteCommand, UpdateTaskProtection, GetTaskProtection, CreateCapacityProvider, UpdateCapacityProvider, DeleteCapacityProvider, DescribeCapacityProviders, TagResource, UntagResource, ListTagsForResource, ListAccountSettings, PutAccountSetting, PutAccountSettingDefault, DeleteAccountSetting, PutAttributes, DeleteAttributes, ListAttributes, DescribeServiceDeployments, ListServiceDeployments, DescribeServiceRevisions, SubmitTaskStateChange, SubmitContainerStateChange, SubmitAttachmentStateChanges, DiscoverPollEndpoint | 47 actions; `RunTask` starts real Docker containers via Docker socket; full Terraform ECS coverage |
| **RDS** | CreateDBInstance, DeleteDBInstance, DescribeDBInstances, ModifyDBInstance, StartDBInstance, StopDBInstance, RebootDBInstance, CreateDBInstanceReadReplica, RestoreDBInstanceFromDBSnapshot, CreateDBCluster, DeleteDBCluster, DescribeDBClusters, ModifyDBCluster, StartDBCluster, StopDBCluster, CreateDBSnapshot, DeleteDBSnapshot, DescribeDBSnapshots, CreateDBClusterSnapshot, DescribeDBClusterSnapshots, DeleteDBClusterSnapshot, CreateDBSubnetGroup, DeleteDBSubnetGroup, DescribeDBSubnetGroups, ModifyDBSubnetGroup, CreateDBParameterGroup, DeleteDBParameterGroup, DescribeDBParameterGroups, DescribeDBParameters, ModifyDBParameterGroup, CreateDBClusterParameterGroup, DescribeDBClusterParameterGroups, DeleteDBClusterParameterGroup, DescribeDBClusterParameters, ModifyDBClusterParameterGroup, CreateOptionGroup, DeleteOptionGroup, DescribeOptionGroups, DescribeOptionGroupOptions, ListTagsForResource, AddTagsToResource, RemoveTagsFromResource, DescribeDBEngineVersions, DescribeOrderableDBInstanceOptions, CreateGlobalCluster, DescribeGlobalClusters, DeleteGlobalCluster, RemoveFromGlobalCluster, ModifyGlobalCluster | `CreateDBInstance` spins up real Postgres/MySQL Docker container, returns actual `host:port` endpoint |
| **ElastiCache** | CreateCacheCluster, DeleteCacheCluster, DescribeCacheClusters, ModifyCacheCluster, RebootCacheCluster, CreateReplicationGroup, DeleteReplicationGroup, DescribeReplicationGroups, ModifyReplicationGroup, IncreaseReplicaCount, DecreaseReplicaCount, CreateCacheSubnetGroup, DescribeCacheSubnetGroups, ModifyCacheSubnetGroup, DeleteCacheSubnetGroup, CreateCacheParameterGroup, DescribeCacheParameterGroups, ModifyCacheParameterGroup, ResetCacheParameterGroup, DeleteCacheParameterGroup, DescribeCacheParameters, DescribeCacheEngineVersions, CreateUser, DescribeUsers, DeleteUser, ModifyUser, CreateUserGroup, DescribeUserGroups, DeleteUserGroup, ModifyUserGroup, ListTagsForResource, AddTagsToResource, RemoveTagsFromResource, CreateSnapshot, DeleteSnapshot, DescribeSnapshots, DescribeEvents | `CreateCacheCluster` spins up real Redis/Memcached Docker container |
-| **Glue** | CreateDatabase, DeleteDatabase, GetDatabase, GetDatabases, UpdateDatabase, CreateTable, DeleteTable, GetTable, GetTables, UpdateTable, BatchDeleteTable, CreatePartition, DeletePartition, GetPartition, GetPartitions, BatchCreatePartition, BatchGetPartition, CreatePartitionIndex, GetPartitionIndexes, CreateConnection, DeleteConnection, GetConnection, GetConnections, CreateCrawler, DeleteCrawler, GetCrawler, GetCrawlers, UpdateCrawler, StartCrawler, StopCrawler, GetCrawlerMetrics, CreateJob, DeleteJob, GetJob, GetJobs, UpdateJob, StartJobRun, GetJobRun, GetJobRuns, BatchStopJobRun, CreateTrigger, GetTrigger, DeleteTrigger, UpdateTrigger, StartTrigger, StopTrigger, ListTriggers, BatchGetTriggers, GetTriggers, CreateWorkflow, GetWorkflow, DeleteWorkflow, UpdateWorkflow, StartWorkflowRun, CreateUserDefinedFunction, UpdateUserDefinedFunction, DeleteUserDefinedFunction, GetUserDefinedFunction, GetUserDefinedFunctions, CreateSecurityConfiguration, DeleteSecurityConfiguration, GetSecurityConfiguration, GetSecurityConfigurations, CreateClassifier, GetClassifier, GetClassifiers, DeleteClassifier, TagResource, UntagResource, GetTags | Python shell jobs actually execute via subprocess; Spark jobs run on the official `amazon/aws-glue-libs` PySpark image (`GlueVersion: 4.0` / `3.0`) on MiniStack's Docker network; Glue-backed Iceberg REST catalog at `/iceberg` (signed with the `glue` credential scope, prefix `catalogs/{catalog}`) — read path for tables whose `metadata_location` parameter points at a metadata.json on MiniStack S3, e.g. DuckDB `ATTACH ... (TYPE iceberg, ENDPOINT 'localhost:4566/iceberg', AUTHORIZATION_TYPE 'sigv4')` with `USE_SSL=1` |
+| **Glue** | CreateDatabase, DeleteDatabase, GetDatabase, GetDatabases, UpdateDatabase, CreateTable, DeleteTable, GetTable, GetTables, UpdateTable, BatchDeleteTable, CreatePartition, DeletePartition, GetPartition, GetPartitions, BatchCreatePartition, BatchGetPartition, CreatePartitionIndex, GetPartitionIndexes, GetColumnStatisticsForTable, UpdateColumnStatisticsForTable, DeleteColumnStatisticsForTable, GetColumnStatisticsForPartition, UpdateColumnStatisticsForPartition, DeleteColumnStatisticsForPartition, CreateConnection, DeleteConnection, GetConnection, GetConnections, CreateCrawler, DeleteCrawler, GetCrawler, GetCrawlers, UpdateCrawler, StartCrawler, StopCrawler, GetCrawlerMetrics, CreateJob, DeleteJob, GetJob, GetJobs, UpdateJob, StartJobRun, GetJobRun, GetJobRuns, BatchStopJobRun, CreateTrigger, GetTrigger, DeleteTrigger, UpdateTrigger, StartTrigger, StopTrigger, ListTriggers, BatchGetTriggers, GetTriggers, CreateWorkflow, GetWorkflow, DeleteWorkflow, UpdateWorkflow, StartWorkflowRun, CreateUserDefinedFunction, UpdateUserDefinedFunction, DeleteUserDefinedFunction, GetUserDefinedFunction, GetUserDefinedFunctions, CreateSecurityConfiguration, DeleteSecurityConfiguration, GetSecurityConfiguration, GetSecurityConfigurations, CreateClassifier, GetClassifier, GetClassifiers, DeleteClassifier, TagResource, UntagResource, GetTags | Python shell jobs actually execute via subprocess; Spark jobs run on the official `amazon/aws-glue-libs` PySpark image (`GlueVersion: 4.0` / `3.0`) on MiniStack's Docker network; Glue-backed Iceberg REST catalog at `/iceberg` (signed with the `glue` credential scope, prefix `catalogs/{catalog}`) — read path for tables whose `metadata_location` parameter points at a metadata.json on MiniStack S3, e.g. DuckDB `ATTACH ... (TYPE iceberg, ENDPOINT 'localhost:4566/iceberg', AUTHORIZATION_TYPE 'sigv4')` with `USE_SSL=1` |
| **S3 Tables** | CreateTableBucket, ListTableBuckets, GetTableBucket, DeleteTableBucket, CreateNamespace, ListNamespaces, GetNamespace, DeleteNamespace, CreateTable, ListTables, GetTable, DeleteTable, GetTableMetadataLocation, UpdateTableMetadataLocation | Iceberg-format tables; embedded Iceberg REST catalog at `/iceberg` so Spark jobs (`spark.sql.catalog.*.type=rest`) can create / load / commit without an external catalog; data files in S3, metadata in memory |
| **Athena** | StartQueryExecution, GetQueryExecution, GetQueryResults, StopQueryExecution, ListQueryExecutions, BatchGetQueryExecution, CreateWorkGroup, DeleteWorkGroup, GetWorkGroup, ListWorkGroups, UpdateWorkGroup, CreateNamedQuery, DeleteNamedQuery, GetNamedQuery, ListNamedQueries, BatchGetNamedQuery, CreateDataCatalog, GetDataCatalog, ListDataCatalogs, DeleteDataCatalog, UpdateDataCatalog, CreatePreparedStatement, GetPreparedStatement, DeletePreparedStatement, ListPreparedStatements, GetTableMetadata, ListTableMetadata, TagResource, UntagResource, ListTagsForResource | Real SQL via **DuckDB** when installed (`pip install duckdb`), otherwise returns mock results; result pagination; column type metadata |
| **Firehose** | CreateDeliveryStream, DeleteDeliveryStream, DescribeDeliveryStream, ListDeliveryStreams, PutRecord, PutRecordBatch, UpdateDestination, TagDeliveryStream, UntagDeliveryStream, ListTagsForDeliveryStream, StartDeliveryStreamEncryption, StopDeliveryStreamEncryption | S3 destinations write records to the local S3 emulator; all other destination types buffer in-memory; concurrency-safe `UpdateDestination` via `VersionId`; `DeliveryStreamType=KinesisStreamAsSource` consumes records from the source Kinesis stream on `PutRecord` / `PutRecords` and forwards them to the configured S3 destination, honoring `Prefix` and `DeliveryStartTimestamp`; `ProcessingConfiguration.Processors[].Type=Lambda` invoked per-batch with the AWS-shape event (`{invocationId, deliveryStreamArn, region, records:[{recordId, approximateArrivalTimestamp, data}]}`) — `Ok` records ship the transformed data downstream, `Dropped`/`ProcessingFailed` are omitted, Lambda failures pass records through unchanged (best-effort per AWS) |
diff --git a/pyproject.toml b/pyproject.toml
index 422f5594..a759e161 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
[project]
name = "ministack"
-version = "1.3.61"
+version = "1.3.62"
description = "Free, open-source local AWS emulator — drop-in LocalStack replacement"
readme = "README.md"
license = { file = "LICENSE" }