Skip to content

more persistence coverage table to persistence docs #116

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions public/_redirects
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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
Expand Down

This file was deleted.

17 changes: 15 additions & 2 deletions src/content/docs/aws/capabilities/state-management/persistence.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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).

Expand Down Expand Up @@ -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.
In most cases, the `ON_SHUTDOWN` save strategy should solve this problem.

import PersistenceCoverage from '../../../../../components/persistence-coverage/PersistenceCoverage.tsx';

## Persistence Coverage Overview

<PersistenceCoverage client:load />

### 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.