gresau/localstack-persist

localstack-persist

https://github.com/localstack/localstack 社区版，支持资源持久化功能。

https://github.com/GREsau/localstack-persist/actions/workflows/test.yml/badge.svg](https://github.com/GREsau/localstack-persist/actions/workflows/test.yml)

概述

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

使用方法

localstack-persist以Docker镜像形式分发，可直接替代官方https://hub.docker.com/r/localstack/localstack%E3%80%82%E4%BE%8B%E5%A6%82%EF%BC%8C%E4%BD%BF%E7%94%A8docker-compose%E6%97%B6%EF%BC%8C%E5%8F%AF%E5%88%9B%E5%BB%BA%E5%A6%82%E4%B8%8B%60docker-compose.yml%60%E6%96%87%E4%BB%B6%EF%BC%9A

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）。其他可用标签见https://hub.docker.com/r/gresau/localstack-persist/tags%E6%88%96https://github.com/GREsau/localstack-persist/releases%E3%80%82localstack-persist%E9%95%9C%E5%83%8F%E6%A0%87%E7%AD%BE%E7%9A%84Major.Minor%E7%89%88%E6%9C%AC%E4%BC%9A%E8%B7%9F%E8%B8%AA%E5%85%B6%E5%9F%BA%E4%BA%8E%E7%9A%84LocalStack%E7%89%88%E6%9C%AC%EF%BC%8C%E4%BE%8B%E5%A6%82%60gresau/localstack-persist:2.2.X%60%E5%A7%8B%E7%BB%88%E5%9F%BA%E4%BA%8E%60localstack/localstack:2.2.Y%60%EF%BC%88X%E5%92%8CY%E5%8F%AF%E8%83%BD%E4%B8%8D%E5%90%8C%EF%BC%89%E3%80%82%E8%BF%98%E5%8F%AF%E4%BD%BF%E7%94%A8%60latest%60%E9%95%9C%E5%83%8F%EF%BC%8C%E6%AF%8F%E6%97%A5%E4%BB%8E%60main%60%E5%88%86%E6%94%AF%E6%9E%84%E5%BB%BA%EF%BC%8C%E5%9F%BA%E4%BA%8E%60localstack/localstack:latest%60%EF%BC%88LocalStack 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基于https://github.com/GREsau/localstack-persist/blob/main/LICENSE%E5%8F%91%E5%B8%83%E3%80%82LocalStack%E5%9F%BA%E4%BA%8Ehttps://github.com/localstack/localstack/blob/master/LICENSE.txt%E4%BD%BF%E7%94%A8%E3%80%82