nikelab222/pterradactyl

Pterradactyl

镜像概述

Pterradactyl是一个用于抽象Terraform（TF）配置与环境设置的库，支持创建TF环境/栈的层次结构，允许无限数量的云账户和栈共享继承配置。它解决了多TF栈管理中重复变量、配置条件复杂及意外应用等痛点。

核心功能

• 通过分层YAML文件结构生成TF代码，仅需在栈文件中覆盖差异部分，保持配置简洁。
• 利用层次结构统一管理标签等公共属性。
• 支持通过sops和AWS KMS管理secrets。
• 保持不同栈之间的Terraform版本一致。
• 避免TF配置的意外覆盖。

使用场景

• 管理多云账户下的Terraform栈。
• 需要统一配置和标签的基础设施部署。
• 需要安全管理secrets的TF项目。
• 希望简化多栈TF代码维护的场景。

配置说明

安装方式

从PyPi安装

shell
pip install pterradactyl

从GitHub安装

shell
pip install git+https://github.com/Nike-Inc/pterradactyl#egg=pterradactyl

从源码构建

shell
poetry install
poetry build
python3 -m pip install dist/*.whl

基本使用

Pterradactyl支持所有Terraform命令，CLI使用示例：

bash
# 应用栈
pt apply <stack-name>
# 生成计划
pt plan <stack-name>
# 销毁资源
pt destroy <stack-name>
# 查看状态列表
pt state list <stack-name>

Docker部署示例

假设镜像已包含Pterradactyl，可通过以下命令运行：

shell
# 执行plan命令
docker run --rm -v $(pwd):/workspace nikelab222/pterradactyl pt plan <stack-name>
# 执行apply命令
docker run --rm -v $(pwd):/workspace nikelab222/pterradactyl pt apply <stack-name>

目录结构

执行pt apply后生成的目录结构：

.pterradactyl
├── terraform
│     └── 0.13.1
│         ├── terraform
│         └── terraform-provider-kubectl_v1.13.1
└── workspace
    └── bt-projectc0-na-useast1
        ├── facts.json
        └── main.tf.json

与其他Terraform工具对比