Terraform Plan Visualizer: Generate Beautiful HTML Reports with AI Analysis

A Complete Guide to Visualizing Terraform Changes Like a Pro

A Complete Guide to Visualizing Terraform Changes Like a Pro

Terraform plans are incredibly powerful, but they can quickly become overwhelming. When you are managing complex infrastructure across AWS, Azure, or GCP, reading raw command-line stdout or digging through hundreds of lines of nested JSON isn't practical—especially during peer architecture reviews or security compliance audits.

In this guide, I'll show you how to transform raw Terraform plans into beautiful, professional HTML dashboards featuring optional AI-powered explanations using local LLMs (completely private and free).

What you'll build: Interactive HTML dashboards of your changes, AI-generated plain-English explanations of impacts, color-coded resource states (Create/Update/Delete), and a fully responsive layout ready to share with your team.

Why This Matters

Before: CLI Chaos 🔴

# Raw 500 lines of messy JSON
$ terraform plan
# Good luck explaining this to your manager!

After: Visual Clarity 🟢

✔ One portable, lightweight HTML file
✔ Visual summary of exactly what's modifying
✔ AI analysis highlighting critical risks & impacts
✔ Zero "what does this code block do?" questions

Prerequisites

To run the visualizer, make sure you have Terraform and Python installed, along with Ollama if you'd like to use the local AI features:

# Required: Core setup
terraform --version
python3 --version

# Optional but recommended: Ollama for local AI
curl -fsSL https://ollama.com/install.sh | sh
ollama pull llama3.1

The Script

Below is the script configuration placeholder. Save this as clone this terraform_viz.py on your local machine and run it to compile your Terraform details into the clean visual layout shown above.

# Run this command in your terminal to parse your plan and generate your report:
clone this https://gitlab.com/praveen.balla41/ami-ml-playground/-/blob/main/tf_diff_analyzer.py?ref_type=heads python3 terraform_viz.py --path ./terraform_dir --output plan_report.html

Usage & Examples

You can execute the script with various options to fit your workflow needs:

# Basic usage - generate a simple report
python3 terraform_viz.py --path ./terraform

# Generate with AI risk analysis (requires Ollama running)
python3 terraform_viz.py --path ./terraform --llm-model llama3.1

# Fast mode (no AI processing)
python3 terraform_viz.py --path ./terraform --no-llm

Performance Quick-Reference

Depending on the footprint of your architecture deployments, use this operational index to optimize execution speeds:

Plan Complexity Recommended Flag Expected Processing Time
< 50 resources --llm-model llama3.1 ~15 seconds
50 - 200 resources --no-llm ~5 seconds
> 200 resources --no-llm ~10 seconds

Advanced CI/CD Pipeline Integration

You can seamlessly hook this visualizer straight into your automated deployment pipelines. Here is an example step configuration for GitHub Actions:

# .github/workflows/tf-visuals.yml
- name: Generate Visual Report
  run: |
    terraform plan -out=plan.tfplan
    python3 terraform_viz.py --path . --output report.html

- name: Publish Artifact
  uses: actions/upload-artifact@v3
  with:
    name: tf-report
    path: report.html

Conclusion

You now possess a completely free, private, and localized visual reporting workflow for your IaC modifications. Running this step before applying changes reduces manual review errors, makes code approvals straightforward, and gives your engineering teams clear insight into your changes.

If you found this guide helpful, feel free to bookmark and share it with your DevOps engineering team!

Comments

Post a Comment

Popular posts from this blog

Image
AWS Infrastructure Inventory Discovery Blog Streamline Your AWS Inventory with Automated Discovery and Reporting Managing resources across multiple AWS accounts and regions can be a daunting task, especially as your cloud infrastructure grows. To simplify this process, I have developed an AWS Inventory Discovery tool that scans all your AWS accounts across all regions and compiles a comprehensive, searchable HTML report. In this blog, I'll walk you through the features, benefits, and the technical details of this solution. Introduction As organizations scale their use of AWS, keeping track of resources scattered across various accounts and regions becomes increasingly challenging. Manual inventory management is not only time-consuming but also prone to errors. This is where the AWS Inventory Discovery tool comes in. Features Comprehensive Scanning : The tool scans all your AWS accounts across all regions, ensu...
Read more

AWS CLI Get Security Group ID with Name.[ wild card support] Bash Script

  Hi guys, If you are wondering How can I get the ID of an AWS security group if I know the name? Here is the solution. Get the Security ID with the wild card Name. #!/bin/bash #Author Praveen SearchString=<*YourSearchString*> # Note : wild cards supported for VPCS in `aws ec2 --output text --query 'Vpcs[*].{VpcId:VpcId}' describe-vpcs` ; do aws ec2 describe-security-groups --filter Name=vpc-id,Values=$VPCS Name=group-name,Values=$searchstring --query 'SecurityGroups[*].[GroupId]' --output text done 2. With the above solution we can automate the other tasks. eg: add tags to security groups. for VPCS in `aws ec2 --output text --query 'Vpcs[*].{VpcId:VpcId}' describe-vpcs` ; do echo " Tagging Search String Created Security Groups" aws ec2 describe-security-groups --filter Name=vpc-id,Values=$VPCS Name=group- name,Values=$searchstring --query 'SecurityGroups[*].[GroupId]' --output text | xargs - I {} aws ...
Read more

AWS CLI Get Security Group ID with Name. Python Boto3 [ wild card support] Python Boto3

 """ Author Praveen This Simple Boto Script will list the AWS  security group with name provide [ Wildcard supported] """ import boto3 AWS_REGION = "us-west-2" fullauth = boto3.session.Session(profile_name='<YourProfile>') ec2 = fullauth.client('ec2' , region_name=AWS_REGION) group_name = '*<YourSearchString>' response = ec2.describe_security_groups(     Filters=[         dict(Name='group-name', Values=[group_name])     ] ) for securityGroup in response['SecurityGroups']:    print("SG ID: {}, Name: {}".format(securityGroup['GroupId'], securityGroup['GroupName'])) #This will list Security Group Name along with Security Group ID     print("SG ID: {}".format(securityGroup['GroupId'])) # This will List Only Security Group IDS
Read more