ivacko/localstack

Localstack

概述

Localstack是一个用于模拟AWS云服务的本地开发环境镜像，包含更新的CLI工具，支持通过Cloud Pods实现数据持久化，便于在本地开发和测试过程中保持服务状态。

核心功能和特性

• 更新的CLI工具：支持Cloud Pods功能，实现数据持久化
• 本地AWS服务模拟：提供本地版AWS服务，如S3、DynamoDB等
• 数据持久化：通过Cloud Pods保存和恢复服务状态，避免开发测试过程中数据丢失
• 灵活配置：支持通过环境变量和脚本自定义初始化和关闭行为

使用场景和适用范围

• 本地AWS服务开发与测试
• 需要持久化服务状态的开发环境
• CI/CD流程中的本地测试环节
• 学习AWS服务的本地实验环境

使用方法和配置说明

1. 准备初始化和关闭脚本

创建初始化脚本 init-aws.sh

该脚本用于在Localstack启动时检查并恢复Cloud Pods数据：

sh
#!/bin/bash

echo Init
FILE=/pods/main

if test -f "$FILE"; then
  echo "Restoring data from pod"
  /usr/local/bin/localstack pod load file://${FILE}
else
  echo No pod state found
fi

创建关闭脚本 shutdown-aws.sh

该脚本用于在Localstack关闭时保存Cloud Pods数据：

sh
#!/bin/bash

echo Saving data to pod
/usr/local/bin/localstack pod save file:///pods/main

设置脚本可执行权限

sh
chmod +x init-aws.sh shutdown-aws.sh

2. 创建Docker Compose配置文件

创建 docker-compose.yaml 文件，内容如下：

yaml
version: "3.8"

services:
  localstack:
    container_name: "${LOCALSTACK_DOCKER_NAME-localstack_main}"
    image: ivacko/localstack:latest
    ports:
      - "127.0.0.1:4566:4566"            # LocalStack Gateway
      - "127.0.0.1:4510-4559:4510-4559"  # 外部服务端口范围
    environment:
      - DEBUG=1                          # 启用调试模式
      - DOCKER_HOST=unix:///var/run/docker.sock  # Docker主机连接
    volumes:
      - localstack-pods:/pods            # 用于存储Cloud Pods数据的卷
      - ./init-aws.sh:/etc/localstack/init/ready.d/init-aws.sh  # 初始化脚本挂载
      - ./shutdown-aws.sh:/etc/localstack/init/shutdown.d/shutdown-aws.sh  # 关闭脚本挂载
volumes:
  localstack-pods:                        # 持久化卷定义

3. 启动Localstack服务

执行以下命令启动服务：

sh
docker-compose up -d

配置说明

环境变量

• DEBUG=1：启用调试模式，输出详细日志
• DOCKER_HOST=unix:///var/run/docker.sock：指定Docker主机连接地址，用于与Docker守护进程通信

端口映射

• 4566：LocalStack Gateway端口，用于访问所有模拟AWS服务
• 4510-4559：外部服务端口范围，对应不同AWS服务的独立端口

卷挂载

• localstack-pods:/pods：持久化卷，用于存储Cloud Pods数据
• 脚本挂载：将本地的初始化和关闭脚本挂载到容器内指定目录，实现启动和关闭时的自动执行