Skip to content

Terraform Linter

Run Terraform formatting and validation checks via Argus SDK

uses: huntridge-labs/argus/.github/actions/linter-terraform@1.12.2

Run Terraform formatting and validation checks.

Overview

This action validates Terraform files using terraform fmt, terraform validate, and optional TFLint. It uploads results as artifacts that can be aggregated by the linting summary action.

Usage

- name: Checkout code
  uses: actions/checkout@v6

- name: Run Terraform linting
  uses: huntridge-labs/argus/.github/actions/linter-terraform@1.12.2
  with:
    fail_on_issues: false
    terraform_version: 'latest'

Inputs

Input Description Required Default
fail_on_issues Fail the job if issues are found No false
fail_on_tool_error Fail the job when the linter tool itself errors (a crash — argus exit code 2), independent of fail_on_issues. Tool errors are always surfaced in the job log, status table, and PR comment; this only makes them block. No false
paths Paths to search for Terraform files (space-separated) No .
terraform_version Terraform version to use No latest
run_tflint Run TFLint in addition to fmt/validate No true

Outputs

Output Description
issues_count Total number of linting issues found
tool_status Whether the linter tool ran cleanly: ok, or error when the tool itself crashed (argus exit code 2).
fmt_issues Number of formatting issues
validate_issues Number of validation issues
tflint_issues Number of TFLint issues

Artifacts

  • linter-summary-terraform: summary for linting-summary
  • terraform-lint-results: raw lint output

Requirements

  • Repository must be checked out before running this action

Support