im2nguyen/rover

Rover - Terraform可视化工具

Rover是一个Terraform可视化工具。

其工作流程如下：

1. 生成plan文件并解析根目录中的配置。
2. 解析plan和配置文件，生成三项内容：资源概述（rso）、资源映射（map）和资源图（graph）。
3. 利用rso、map和graph生成交互式配置和状态可视化，并托管在localhost:9000。

核心功能和特性

• 自动解析Terraform配置文件和plan文件
• 生成资源概述（rso）、资源映射（map）和资源图（graph）三种可视化资产
• 提供交互式Web界面，可在localhost:9000访问
• 支持通过环境变量注入云服务凭证

使用场景和适用范围

适用于任何Terraform工作空间，帮助用户：

• 直观理解Terraform资源配置和依赖关系
• 可视化展示基础设施状态
• 简化复杂Terraform项目的分析和调试过程

使用方法和配置说明

快速启动

在Terraform工作目录中执行以下命令，启动Rover并生成可视化：

bash
docker run --rm -it -p 9000:9000 -v $(pwd):/src im2nguyen/rover

命令参数说明：

• --rm：容器退出后自动删除
• -it：交互式终端
• -p 9000:9000：将容器的9000端口映射到主机的9000端口
• -v $(pwd):/src：将当前目录挂载到容器的/src目录

执行后，Rover会输出以下日志并在localhost:9000启动服务：

2021/07/02 06:46:23 Starting Rover...
2021/07/02 06:46:23 Initializing Terraform...
2021/07/02 06:46:24 Generating plan...
2021/07/02 06:46:25 Parsing configuration...
2021/07/02 06:46:25 Generating resource overview...
2021/07/02 06:46:25 Generating resource map...
2021/07/02 06:46:25 Generating resource graph...
2021/07/02 06:46:25 Done generating assets.
2021/07/02 06:46:25 Rover is running on localhost:9000

配置环境变量

如需传递环境变量（如云服务凭证），可使用--env或--env-file参数：

1. 创建包含环境变量的.env文件（以AWS为例）：

   bash
   printenv | grep "AWS" > .env
   

2. 使用--env-file加载环境变量：

   bash
   docker run --rm -it -p 9000:9000 -v $(pwd):/src --env-file ./.env im2nguyen/rover
   

后续步骤

完整文档请访问https://github.com/im2nguyen/rover%E3%80%82