dwpdigital/jinja-yaml-aws

镜像概述

本Docker镜像集成了Jinja2模板引擎、YAML处理工具及AWS SDK，旨在提供从AWS服务获取数据并动态填充Jinja2模板的能力，适用于自动化生成配置文件、文档或其他需要动态数据注入的场景。

核心功能和特性

• Jinja2模板支持：完整支持Jinja2语法，包括变量替换、条件判断、循环语句等模板功能
• YAML处理：内置YAML解析与生成工具，可处理YAML格式的模板输入和输出
• AWS SDK集成：集成AWS SDK for Python (boto3)，支持从AWS服务（如S3、DynamoDB、EC2等）获取数据
• 灵活配置：通过环境变量设置AWS凭证、模板路径、输出路径及数据来源
• 轻量级设计：基于Python官方镜像构建，体积小巧，运行高效

使用场景和适用范围

• 云环境配置文件生成：动态生成AWS CloudFormation模板、Kubernetes配置文件或Terraform变量文件
• 动态文档生成：从AWS获取资源信息（如EC2实例列表、S3存储桶信息）生成运维报告或架构文档
• CI/CD流水线集成：在CI/CD流程中自动填充环境特定参数，实现配置模板的环境差异化部署
• 多环境配置管理：为开发、测试、生产等不同环境动态生成针对性配置文件

使用方法和配置说明

基本使用（docker run）

bash
docker run -d \
  -v /path/to/templates:/app/templates \
  -v /path/to/output:/app/output \
  -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 TEMPLATE_PATH=/app/templates/config.j2 \
  -e OUTPUT_PATH=/app/output/config.yaml \
  -e DATA_SOURCE=s3:bucket=my-config-bucket,key=parameters.json \
  docker.xuanyuan.run/your-image-name

Docker Compose配置

yaml
version: '3'
services:
  template-processor:
    image: docker.xuanyuan.run/your-image-name
    volumes:
      - ./templates:/app/templates
      - ./output:/app/output
    environment:
      - AWS_ACCESS_KEY_ID=your_aws_access_key
      - AWS_SECRET_ACCESS_KEY=your_aws_secret_key
      - AWS_REGION=us-east-1
      - TEMPLATE_PATH=/app/templates/config.j2
      - OUTPUT_PATH=/app/output/config.yaml
      - DATA_SOURCE=dynamodb:table=config-parameters,key=environment:prod

环境变量说明

模板示例

Jinja2模板文件（config.j2）：

yaml
environment: {{ environment }}
instances:
{% for instance in ec2_instances %}
  - name: {{ instance.name }}
    id: {{ instance.id }}
    ip: {{ instance.private_ip_address }}
{% endfor %}
s3_buckets:
{% for bucket in s3_buckets %}
  - name: {{ bucket.name }}
    creation_date: {{ bucket.creation_date.strftime('%Y-%m-%d') }}
{% endfor %}

数据来源配置： 若DATA_SOURCE设置为ec2:filters=tag:Environment=prod，则模板将获取所有带有Environment=prod标签的EC2实例数据，并填充到ec2_instances变量中。