Provider caching and mirrors in Terraform - Mini Project: Build & Apply

Provider caching and mirrors

📖 Scenario: You are setting up Terraform for a team project. To speed up Terraform provider downloads and avoid network issues, you want to configure Terraform to use a local cache and a mirror for providers.

🎯 Goal: Configure Terraform to use a local provider cache directory and a provider mirror to improve reliability and speed when downloading providers.

📋 What You'll Learn

Create a Terraform configuration file named terraform.rc

Set the plugin_cache_dir to ~/.terraform.d/plugin-cache

Configure a provider mirror at ~/.terraform.d/mirrors

Use the provider_installation block with direct and filesystem_mirror methods

💡 Why This Matters

🌍 Real World

Teams working with Terraform often face slow or unreliable provider downloads. Using provider caching and mirrors improves speed and reliability.

💼 Career

Cloud engineers and DevOps professionals configure Terraform environments for efficient infrastructure provisioning and management.

1

Create the initial Terraform CLI config file

Create a file named terraform.rc and add the provider_installation block with an empty configuration inside.

Terraform

# Create terraform.rc file with provider_installation block
provider_installation {
  
}

Need a hint?

Start by writing the provider_installation block with opening and closing braces.

2

Add the plugin cache directory configuration

Inside the provider_installation block, add the plugin_cache_dir setting and set it to "~/.terraform.d/plugin-cache".

Terraform

provider_installation {
  # Add plugin_cache_dir setting here
}

Need a hint?

Use the exact path "~/.terraform.d/plugin-cache" for the cache directory.

3

Configure the filesystem mirror for providers

Inside the provider_installation block, add a filesystem_mirror block with the path set to "~/.terraform.d/mirrors".

Terraform

provider_installation {
  plugin_cache_dir = "~/.terraform.d/plugin-cache"
  # Add filesystem_mirror block here
}

Need a hint?

Indent the path setting inside the filesystem_mirror block.

4

Add the direct installation method as fallback

Inside the provider_installation block, add the direct block after the filesystem_mirror block to allow direct downloads if the mirror is unavailable.

Terraform

provider_installation {
  plugin_cache_dir = "~/.terraform.d/plugin-cache"

  filesystem_mirror {
    path    = "~/.terraform.d/mirrors"
  }
  # Add direct block here
}

Need a hint?

The direct block should be empty and placed after the filesystem_mirror block.