seiso/easy_infra

easy_infra[structure as Code]

镜像概述和主要用途

easy_infra是一个Docker容器，旨在简化和保护基础设施即代码(IaC)部署，通过在运行IaC工具前执行安全扫描实现。它支持三个主要使用场景：

1. 实验：支持交互式使用和安全故障排除
2. 持续集成：作为拉取/合并请求验证的一部分
3. 持续部署：作为自动化部署工具

核心功能和特性

默认安全

容器默认提供安全功能，在执行IaC命令时会自动运行安全扫描。例如使用Terraform部署环境时，容器会：

1. 运行checkov安全扫描
2. 执行terraform init
3. 检测文件系统是否变更，若变更则再次运行checkov安全扫描
4. 执行terraform apply -auto-approve

学习模式

学习模式会抑制任何注入的验证、钩子或安全工具的退出码，确保提供的命令能够运行。可通过将环境变量LEARNING_MODE设置为true启用。

调试功能

通过设置环境变量LOG_LEVEL为DEBUG，可在运行时启用调试日志。

使用场景和适用范围

• 开发实验：开发人员在本地环境中安全地测试IaC代码，进行交互式故障排除
• CI流程集成：在代码合并前自动验证IaC配置的安全性和正确性
• CD自动化：作为自动化部署流程的一部分，确保部署前的安全检查

使用方法和配置说明

基本使用

将IaC文件挂载到容器的/iac目录，并传递命令即可运行。例如：

bash
docker run -v .:/iac seiso/easy_infra:latest-terraform terraform validate

使用别名简化工作流

可通过设置别名进一步简化命令。例如在.zshrc、.bashrc或类似文件中添加：

bash
alias terraform="docker run -v .:/iac seiso/easy_infra:latest-terraform terraform"

之后即可直接运行Terraform命令，这些命令会在easy_infra容器中透明执行：

bash
terraform validate
terraform plan
terraform apply

安全部署示例

使用Terraform部署环境的典型命令：

bash
docker run -v .:/iac seiso/easy_infra:latest-terraform /bin/bash -c "terraform init && terraform apply -auto-approve"

学习模式配置

设置LEARNING_MODE=true环境变量启用学习模式：

bash
docker run -e LEARNING_MODE=true -v .:/iac seiso/easy_infra:latest-terraform terraform apply -auto-approve

调试配置

设置LOG_LEVEL=DEBUG环境变量启用调试日志：

bash
docker run -e LOG_LEVEL=DEBUG -v .:/iac seiso/easy_infra:latest-terraform terraform validate

要了解更多信息，请查看我们的文档和CONTRIBUTING.md。