localstack-persist

LocalStack 社区版，支持资源持久化功能。

![Docker pulls]([] ![CI Build]([]

概述

自LocalStack 1.0起，持久化功能成为专业版专属特性，社区版无法使用。localstack-persist为社区版添加了开箱即用的持久化能力，资源修改时自动保存数据，并在容器启动时自动恢复。

使用方法

localstack-persist以Docker镜像形式分发，可直接替代***LocalStack社区版Docker镜像。例如，使用docker-compose时，可创建如下docker-compose.yml文件：

yaml
version: "3.8"
services:
  localstack:
    image: gresau/localstack-persist:3 # 替代 localstack/localstack:3
    ports:
      - "4566:4566"
    volumes:
      - "./my-localstack-data:/persisted-data"

上述示例使用semver主版本3的最新镜像，也可固定到特定版本（如3.0.1）。其他可用标签见Docker Hub或GitHub releases。localstack-persist镜像标签的Major.Minor版本会跟踪其基于的LocalStack版本，例如gresau/localstack-persist:2.2.X始终基于localstack/localstack:2.2.Y（X和Y可能不同）。还可使用latest镜像，每日从main分支构建，基于localstack/localstack:latest（LocalStack nightly镜像），但该镜像可能不稳定。

持久化数据存储在容器内的/persisted-data路径，通常需在此路径挂载卷。上述示例将持久化数据保存在主机的my-localstack-data目录中。

配置

默认所有服务均会将资源持久化到磁盘。要禁用特定服务的持久化，可将容器的PERSIST_[SERVICE]环境变量设为0（如PERSIST_CLOUDWATCH=0）。若仅需为特定服务启用持久化，可设置PERSIST_DEFAULT=0并将PERSIST_[SERVICE]设为1。例如，仅为DynamoDB和S3启用持久化：

yaml
    ...
    image: gresau/localstack-persist
    ports:
      - "4566:4566"
    volumes:
      - "./my-localstack-data:/persisted-data"
    environment:
      - PERSIST_DEFAULT=0
      - PERSIST_DYNAMODB=1
      - PERSIST_S3=1

仍可按常规方式设置LocalStack的所有配置选项，但无需设置PERSISTENCE=1（该选项控制LocalStack内置持久化，社区版中无效）。

支持的服务

localstack-persist使用与持久化机制基本相同的钩子，因此所有持久化支持的（非专业版）服务均应兼容，详见此处。

以下服务已通过自动化测试验证基本的保存/恢复功能：

• ACM
• DynamoDB
• Elasticsearch
• IAM
• Lambda
• SQS
• S3

许可证

localstack-persist基于Apache License 2.0发布。LocalStack基于Apache License 2.0使用。