inseefrlab/s3-operator

S3动态存储桶与策略操作器镜像

镜像概述与主要用途

该镜像是一个轻量级操作器工具，核心功能为动态创建Amazon S3存储桶及其关联访问策略。它通过自动化流程简化S3资源配置，减少手动操作成本，适用于需要快速部署和管理云存储资源的场景。

核心功能与特性

• 动态创建机制：支持按需自动创建S3存储桶，无需手动通过AWS控制台操作
• 策略集成能力：可同步生成并应用存储桶访问策略，实现权限控制自动化
• 轻量化设计：镜像体积小巧，部署便捷，易于集成到现有工作流
• 配置灵活性：支持通过环境变量自定义存储桶名称、策略内容等关键参数

使用场景与适用范围

• DevOps自动化流程：在CI/CD pipeline中自动配置应用所需的S3存储资源
• 云原生应用部署：为容器化应用提供动态存储桶创建能力
• 多环境资源管理：在开发、测试、生产等不同环境中快速复制存储桶配置
• 批量资源配置：需要一次性创建多个带有特定策略的S3存储桶场景

使用方法与配置说明

前提条件

• 已安装Docker引擎
• 拥有具备S3操作权限的AWS访问凭证（Access Key ID和Secret Access Key）
• 网络环境可访问AWS S3服务端点

Docker运行命令示例

bash
docker run -d \
  -e AWS_ACCESS_KEY_ID="your_aws_access_key" \
  -e AWS_SECRET_ACCESS_KEY="your_aws_secret_key" \
  -e AWS_REGION="us-east-1" \
  -e S3_BUCKET_NAME="my-app-bucket-01" \
  -e S3_POLICY_JSON='{"Version":"2012-10-17","Statement":[{"Effect":"Allow","Principal":{"AWS":"arn:aws:iam::123456789012:user/app-user"},"Action":"s3:*","Resource":["arn:aws:s3:::my-app-bucket-01","arn:aws:s3:::my-app-bucket-01/*"]}]}' \
  s3-bucket-operator:latest

环境变量配置说明

Docker Compose配置示例

yaml
version: '3.8'
services:
  s3-operator:
    image: s3-bucket-operator:latest
    environment:
      - AWS_ACCESS_KEY_ID=${AWS_ACCESS_KEY_ID}
      - AWS_SECRET_ACCESS_KEY=${AWS_SECRET_ACCESS_KEY}
      - AWS_REGION=us-west-2
      - S3_BUCKET_NAME=app-data-bucket-${ENVIRONMENT}
      - S3_POLICY_JSON=${S3_POLICY_CONTENT}
    restart: on-failure

注意事项

• 存储桶名称需满足AWS S3全局唯一性要求，创建前建议检查名称可用性
• 策略内容需符合IAM策略语***范，错误格式将导致策略应用失败
• 确保AWS访问凭证具有足够权限，最小权限集应包含s3:CreateBucket和s3:PutBucketPolicy
• 生产环境中建议通过密钥管理服务传递敏感凭证，避免明文配置