Test file structure in Terraform - Mini Project: Build & Apply

Terraform Test File Structure

📖 Scenario: You are working on a Terraform project to manage cloud infrastructure. To ensure your Terraform code is organized and testable, you want to create a proper test file structure.

🎯 Goal: Create a Terraform test file structure with a main configuration file and a test file that references it.

📋 What You'll Learn

Create a Terraform configuration file named main.tf with a simple resource

Create a test file named main_test.tf that references the resource from main.tf

Use valid Terraform syntax and best practices for file naming and structure

💡 Why This Matters

🌍 Real World

Organizing Terraform files properly helps teams manage infrastructure code clearly and test resources effectively.

💼 Career

Understanding Terraform file structure and testing is essential for cloud engineers and DevOps professionals managing infrastructure as code.

1

Create main.tf with a simple resource

Create a Terraform configuration file named main.tf that defines an AWS S3 bucket resource called example_bucket with the bucket name my-example-bucket.

Terraform

# Your code here to create main.tf with an AWS S3 bucket resource

Need a hint?

Use the resource block with type aws_s3_bucket and name example_bucket. Set the bucket attribute to "my-example-bucket".

2

Create main_test.tf with a test reference

Create a Terraform test file named main_test.tf that references the example_bucket resource from main.tf using a data block of type aws_s3_bucket and name test_bucket. Set the bucket attribute to aws_s3_bucket.example_bucket.bucket.

Terraform

resource "aws_s3_bucket" "example_bucket" {
  bucket = "my-example-bucket"
}

# Your code here to create main_test.tf with a data block referencing example_bucket

Need a hint?

Use a data block to reference the existing bucket resource by its bucket name.

3

Add a terraform block with required provider

Add a terraform block to main.tf specifying the required provider aws with version constraint "~> 4.0".

Terraform

resource "aws_s3_bucket" "example_bucket" {
  bucket = "my-example-bucket"
}

terraform {
  # Your code here to add required_providers
}

data "aws_s3_bucket" "test_bucket" {
  bucket = aws_s3_bucket.example_bucket.bucket
}

Need a hint?

The terraform block should include required_providers with aws provider and version constraint.

4

Add provider configuration for AWS

Add a provider block for aws in main.tf with the region set to us-east-1.

Terraform

terraform {
  required_providers {
    aws = {
      source  = "hashicorp/aws"
      version = "~> 4.0"
    }
  }
}

# Your code here to add provider configuration

resource "aws_s3_bucket" "example_bucket" {
  bucket = "my-example-bucket"
}

data "aws_s3_bucket" "test_bucket" {
  bucket = aws_s3_bucket.example_bucket.bucket
}

Need a hint?

Add a provider block for AWS with the region attribute set.