Skip to main content

atmos terraform test

Use this command to run Terraform tests for an Atmos component, validating the component's configuration and behavior.

atmos terraform test --help

Usage​

Execute the terraform test command like this:

atmos terraform test <component> -s <stack> [options]

This command runs tests for Terraform modules. Tests are written in .tftest.hcl or .tftest.json files and can validate that your infrastructure code works as expected.

Atmos Behavior

Atmos provides standard setup for this command including automatic terraform init and workspace selection. The test execution is handled by native Terraform.

Examples​

Run Tests​

# Run all tests
atmos terraform test vpc -s dev

Run Specific Test Files​

# Run specific test file
atmos terraform test vpc -s dev -filter=tests/vpc_test.tftest.hcl

Verbose Output​

# Run with verbose output
atmos terraform test vpc -s dev -verbose

Arguments​

component (required)

Atmos component name.

Flags​

--stack / -s (required)

Atmos stack name where the component is defined.

--skip-init (optional)

Skip running terraform init before executing the command.

atmos terraform test vpc -s dev --skip-init
--dry-run (optional)

Show what would be executed without actually running the command.

atmos terraform test vpc -s dev --dry-run

Native Terraform Flags​

This command supports native terraform test flags such as -filter to run specific test files, -verbose for detailed output, -json for JSON output.