How terraform-linters/tflint-ruleset-aws works
This is a TFLint plugin ruleset for detecting AWS-provider-specific Terraform errors and best-practice violations before apply. The principal workflow is TFLint invoking the plugin’s registered rules, which inspect Terraform resources and report issues; selected deep checks use AWS APIs. The repository also includes rule families for provider-model constraints, tags, ephemeral resources, and deprecated Lambda runtimes. AWS runtime wiring is only partly visible in the supplied excerpts and index, so uncertain links are omitted or marked unverified.
Main entry points: rules Static checks · main.go Plugin entry · api AWS API checks · provider.go Rule registry
Components 18
Plugin runtime
- Plugin entry
main.go - AWS ruleset
aws/ruleset.go
Validation rules
- Rule registry
rules/provider.go - Static checks
rules - Provider model checks
rules/models - AWS API checks
rules/api - Tag checks
rules/tags - Ephemeral checks
rules/ephemeral - Lambda lifecycle
rules/lambda_deprecated_runtime/aws_lambda_function_deprecated_runtime.go
AWS lookups
- AWS runner
aws/runner.go - AWS client
aws/client.go
Rule data
- RDS type data
rules/db_instance_types/db_instance_types.go - Cache type data
rules/elasticache_node_types/elasticache_node_types.go - Rule generators
rules/models/generator/main.go - Cache type generator
rules/elasticache_node_types/generator/main.go
Other components
- TFLint
- AWS services
- Reported issues
Connections 17
- TFLint → Plugin entry: starts plugin
README.md - Plugin entry → AWS ruleset: serves ruleset
main.go - Plugin entry → Rule registry: registers rules
main.go - Rule registry → Static checks: provides checks
- Static checks → Reported issues: emits findings
rules/aws_db_instance_invalid_engine.go - Provider model checks → Reported issues: validates models
- AWS API checks → AWS runner: requests AWS client
rules/api/aws_instance_invalid_ami.go - AWS runner → AWS client: provides client
- AWS client → AWS services: queries APIs
- AWS API checks → Reported issues: emits findings
rules/api/aws_instance_invalid_ami.go - Tag checks → Reported issues: checks tagging
- Ephemeral checks → Reported issues: checks arguments
- Lambda lifecycle → Reported issues: reports lifecycle
rules/lambda_deprecated_runtime/aws_lambda_function_deprecated_runtime.go - Rule generators → Provider model checks: generates checks
- Cache type generator → Cache type data: generates type data
- RDS type data → Static checks: supplies type data
rules/db_instance_types/db_instance_types.go - Cache type data → Static checks: supplies type data
rules/elasticache_node_types/elasticache_node_types.go