From 791e05b090199cfe22ebf0bbdbf34c3c842b73ca Mon Sep 17 00:00:00 2001 From: HarshCasper Date: Mon, 14 Jul 2025 17:01:06 +0530 Subject: [PATCH 1/2] more persistence coverage table to persistence docs --- public/_redirects | 8 +++---- .../state-management/persistence-coverage.mdx | 21 ------------------- .../state-management/persistence.mdx | 15 ++++++++++++- 3 files changed, 18 insertions(+), 26 deletions(-) delete mode 100644 src/content/docs/aws/capabilities/state-management/persistence-coverage.mdx diff --git a/public/_redirects b/public/_redirects index 1cb722e..56c9882 100644 --- a/public/_redirects +++ b/public/_redirects @@ -136,7 +136,7 @@ /user-guide/aws/s3/ /aws/services/s3 301 /user-guide/lambda-tools/vscode-extension/ /aws/tooling/lambda-tools/vscode-extension 301 /user-guide/chaos-engineering/ /aws/capabilities/chaos-engineering/ 301 -/persistence/supported/ /aws/capabilities/state-management/persistence-coverage 301 +/persistence/supported/ /aws/capabilities/state-management/persistence 301 /user-guide/aws/ce/ /aws/services/ce 301 /user-guide/aws/kinesisanalyticsv2/ /aws/services/kinesisanalyticsv2 301 /user-guide/state-management/cloud-pods/ /aws/capabilities/state-management/cloud-pods 301 @@ -199,7 +199,7 @@ /user-guide/web-application/resource-browser/ /aws/capabilities/web-app/resource-browser 301 /applications/loan-broker-application-with-aws-step-functions-dynamodb-lambda-sqs-and-sns/ https://github.com/localstack-samples/sample-loan-broker-stepfunctions-lambda 301 /references/coverage/coverage_resource-groups/ /aws/services/resourcegroups 301 -/user-guide/state-management/support/ /aws/capabilities/state-management/persistence-coverage 301 +/user-guide/state-management/support/ /aws/capabilities/state-management/persistence 301 /references/coverage/coverage_redshift/ /aws/services/redshift 301 /user-guide/integrations/lambdatest-hyperexecute/ /aws/integrations/testing/lambdatest-hyperexecute/ 301 /applications/ /aws/sample-apps/ 301 @@ -546,7 +546,7 @@ /user-guide/aws/s3 /aws/services/s3 301 /user-guide/lambda-tools/vscode-extension /aws/tooling/lambda-tools/vscode-extension 301 /user-guide/chaos-engineering /aws/capabilities/chaos-engineering/ 301 -/persistence/supported /aws/capabilities/state-management/persistence-coverage 301 +/persistence/supported /aws/capabilities/state-management/persistence 301 /user-guide/aws/ce /aws/services/ce 301 /user-guide/aws/kinesisanalyticsv2 /aws/services/kinesisanalyticsv2 301 /user-guide/state-management/cloud-pods /aws/capabilities/state-management/cloud-pods 301 @@ -609,7 +609,7 @@ /user-guide/web-application/resource-browser /aws/capabilities/web-app/resource-browser 301 /applications/loan-broker-application-with-aws-step-functions-dynamodb-lambda-sqs-and-sns https://github.com/localstack-samples/sample-loan-broker-stepfunctions-lambda 301 /references/coverage/coverage_resource-groups /aws/services/resourcegroups 301 -/user-guide/state-management/support /aws/capabilities/state-management/persistence-coverage 301 +/user-guide/state-management/support /aws/capabilities/state-management/persistence 301 /references/coverage/coverage_redshift /aws/services/redshift 301 /user-guide/integrations/lambdatest-hyperexecute /aws/integrations/testing/lambdatest-hyperexecute/ 301 /applications /aws/sample-apps/ 301 diff --git a/src/content/docs/aws/capabilities/state-management/persistence-coverage.mdx b/src/content/docs/aws/capabilities/state-management/persistence-coverage.mdx deleted file mode 100644 index ed7e897..0000000 --- a/src/content/docs/aws/capabilities/state-management/persistence-coverage.mdx +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: Persistence Coverage -description: Overview of the persistence coverage across the implemented AWS services. -template: doc -sidebar: - order: 7 -tags: ["Base"] ---- - -import PersistenceCoverage from '../../../../../components/persistence-coverage/PersistenceCoverage.tsx'; - -## Persistence Coverage Overview - - - -### Terminology - -- **Persistence Test Suite**: tested by LocalStack's internal persistence test suite. -To test persistence, we use an approach similar to snapshot parity test: -we first record API responses from LocalStack, we then reset and restore the snapshotted state, -and finally verify that the same API responses matches with the initial ones. diff --git a/src/content/docs/aws/capabilities/state-management/persistence.mdx b/src/content/docs/aws/capabilities/state-management/persistence.mdx index a230b93..c2f821f 100644 --- a/src/content/docs/aws/capabilities/state-management/persistence.mdx +++ b/src/content/docs/aws/capabilities/state-management/persistence.mdx @@ -159,4 +159,17 @@ When we restore server backends (like an RDS server or DynamoDB server), we make When LocalStack saves snapshots, it has to lock the particular service to avoid state pollution. That means that, while a snapshot for a particular service is created, all requests to the service are blocked. Depending on what you are building, you may find this behavior is slowing down your application. -In most cases, the `ON_SHUTDOWN` save strategy should solve this problem. \ No newline at end of file +In most cases, the `ON_SHUTDOWN` save strategy should solve this problem. + +import PersistenceCoverage from '../../../../../components/persistence-coverage/PersistenceCoverage.tsx'; + +## Persistence Coverage Overview + + + +### Terminology + +- **Persistence Test Suite**: tested by LocalStack's internal persistence test suite. +To test persistence, we use an approach similar to snapshot parity test: +we first record API responses from LocalStack, we then reset and restore the snapshotted state, +and finally verify that the same API responses matches with the initial ones. From 20196b02947e86932288b4f26f0891f961f93775 Mon Sep 17 00:00:00 2001 From: HarshCasper Date: Mon, 14 Jul 2025 17:05:08 +0530 Subject: [PATCH 2/2] fix broken build --- .../docs/aws/capabilities/state-management/persistence.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/aws/capabilities/state-management/persistence.mdx b/src/content/docs/aws/capabilities/state-management/persistence.mdx index c2f821f..9ba50a4 100644 --- a/src/content/docs/aws/capabilities/state-management/persistence.mdx +++ b/src/content/docs/aws/capabilities/state-management/persistence.mdx @@ -120,7 +120,7 @@ curl -X POST localhost:4566/_localstack/state/save Although we are working to support both snapshot-based persistence and Cloud pods for all AWS services, there are some common issues, known limitations, and also services that are not well tested for persistence support. -An overview is available [here](/aws/capabilities/state-management/persistence-coverage). +An overview is available [here](#persistence-coverage-overview). Please help us improve persistence support by reporting bugs on our [GitHub issue tracker](https://github.com/localstack/localstack/issues/new/choose).