如何在LocalStack Docker容器启动后执行Shell脚本及S3桶创建命令

针对你想要启动LocalStack并自动创建S3存储桶的需求，先分析下当前配置的问题，再给出几种可靠的解决方案：

问题根源 #

你的配置有两个核心问题：

1. 脚本未被加载到容器中：你编写了Dockerfile来拷贝脚本，但docker-compose里依然使用官方localstack/localstack:latest镜像，导致自定义的脚本根本不在运行的容器内。
2. 命令覆盖了LocalStack启动逻辑：你设置的command: sh -c "/usr/local/bin/create_bucket.sh"替换了LocalStack默认的启动命令，容器只会执行这个脚本，不会启动LocalStack服务——这也是为什么脚本里的AWS命令无法生效的原因。

解决方案（推荐官方初始化机制） #

LocalStack提供了内置的初始化脚本目录，会在服务完全就绪后自动执行指定脚本，这是最稳定的方式：

步骤1：编写带就绪等待的脚本 #

在本地创建./scripts/create_bucket.sh文件，内容如下（添加等待逻辑确保LocalStack服务就绪）：

#!/bin/bash
# 等待LocalStack S3服务就绪
until aws --endpoint-url=http://localhost:4566 s3 ls; do
  echo "等待LocalStack S3服务就绪..."
  sleep 2
done

# 创建目标存储桶
aws --endpoint-url=http://localhost:4566 s3 mb s3://my-bucket
echo "S3存储桶my-bucket已成功创建"

给脚本添加可执行权限：

chmod +x ./scripts/create_bucket.sh

步骤2：修改docker-compose.yml #

挂载脚本到LocalStack的ready.d初始化目录，并通过环境变量指定执行：

version: '3.8'
services:
  localstack:
    image: localstack/localstack:latest
    environment:
      - INIT_SCRIPTS=/etc/localstack/init/ready.d/create_bucket.sh  # 指定就绪后执行的脚本
      - SERVICES=s3  # 可选：只启动S3服务，加快启动速度
    ports:
      - '4566-4583:4566-4583'
    volumes:
      - ./scripts/create_bucket.sh:/etc/localstack/init/ready.d/create_bucket.sh
      - /var/run/docker.sock:/var/run/docker.sock  # LocalStack运行所需的权限挂载

其他可选方案 #

方案二：在docker-compose命令中串联启动逻辑 #

如果你不想用官方初始化目录，可以在command中先后台启动LocalStack，等待就绪后执行脚本：

version: '3.8'
services:
  localstack:
    image: localstack/localstack:latest
    environment:
      - SERVICES=s3
    ports:
      - '4566-4583:4566-4583'
    volumes:
      - ./scripts/create_bucket.sh:/usr/local/bin/create_bucket.sh
      - /var/run/docker.sock:/var/run/docker.sock
    command: >
      sh -c "
        # 后台启动LocalStack
        localstack start -d &&
        # 等待S3服务就绪
        until aws --endpoint-url=http://localhost:4566 s3 ls; do
          echo '等待LocalStack就绪...'
          sleep 2
        done &&
        # 执行创建桶脚本
        /usr/local/bin/create_bucket.sh &&
        # 保持容器运行
        localstack wait
      "

方案三：构建自定义LocalStack镜像 #

如果需要把脚本打包到镜像中，修改你的Dockerfile：

FROM localstack/localstack:latest
# 把脚本拷贝到官方就绪脚本目录
COPY create_bucket.sh /etc/localstack/init/ready.d/
# 添加可执行权限
RUN chmod +x /etc/localstack/init/ready.d/create_bucket.sh

然后修改docker-compose.yml使用自定义镜像：

version: '3.8'
services:
  localstack:
    build: .  # 构建当前目录的Dockerfile
    environment:
      - SERVICES=s3
    ports:
      - '4566-4583:4566-4583'
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock

内容的提问来源于stack exchange，提问作者Dave