Mastering archive_file in Terraform Like a Pro

What is archive_file in Terraform?#

Think of archive_file as the glam squad for your code—it takes your files and bundles them into neat little ZIP or TAR packages. Super useful for:

✨ Deploying AWS Lambda functions (which require zipped code!) ✨ Packaging Kubernetes manifests or Helm charts ✨ Bundling files before uploading to S3, Azure Storage, or Google Cloud Storage

Here’s how you set it up:

1
data "archive_file" "example" {
2
  type        = "zip"              # Options: zip, tar, tgz
3
  source_dir  = "path/to/source"   # Directory to compress
4
  output_path = "path/to/output.zip" # Destination of the archive
5
}

Or, if you’re working with just one file:

1
data "archive_file" "example_file" {
2
  type        = "zip"
3
  source_file = "path/to/file.txt"
4
  output_path = "path/to/output.zip"
5
}

💡 Pro Tip: Use source_dir for entire folders and source_file for single files—but NOT both in the same block. Terraform’s picky like that. 😉

Creating an Archive from a Single File#

Let’s say you need to ZIP up a single file (hello, AWS Lambda deployments!). It’s super simple:

1
data "archive_file" "example" {
2
  type        = "zip"
3
  source_file = "example.txt"
4
  output_path = "example.zip"
5
}
6

7
output "archive_checksum" {
8
  value = data.archive_file.example.output_base64sha256
9
}

This output_base64sha256 is a SHA-256 checksum to make sure your file stays intact. You don’t need it, but it’s a nice way to keep things in check. ✅

1
data "archive_file" "lambda_zip" {
2
  type        = "zip"
3
  source_file = "lambda_function.py"
4
  output_path = "lambda_function.zip"
5
}

1
resource "aws_lambda_function" "my_lambda" {
2
  function_name    = "my_lambda_function"
3
  role             = aws_iam_role.lambda_role.arn
4
  runtime          = "python3.8"
5
  handler          = "lambda_function.lambda_handler"
6

7
  filename         = data.archive_file.lambda_zip.output_path
8
  source_code_hash = data.archive_file.lambda_zip.output_base64sha256
9
}

Creating Archives from Multiple Files#

Ugh, I wish Terraform let us specify multiple files directly, but no, it’s a diva. 👀 The workaround? Gather files in a temp folder first:

1
resource "terraform_data" "prepare_files" {
2
  provisioner "local-exec" {
3
    command = <<EOT
4
mkdir -p temp_folder
5
cp ${path.module}/file1.txt temp_folder/
6
cp ${path.module}/file2.txt temp_folder/
7
cp ${path.module}/file3.txt temp_folder/
8
EOT
9
  }
10
}
11

12
data "archive_file" "multiple_files" {
13
  type        = "zip"
14
  source_dir  = "${path.module}/temp_folder"
15
  output_path = "${path.module}/multiple_files.zip"
16
  depends_on  = [terraform_data.prepare_files]
17
}

If you just want to archive an entire directory:

1
data "archive_file" "example" {
2
  type        = "zip"
3
  source_dir  = "${path.module}/my_folder"
4
  output_path = "${path.module}/example.zip"
5
}

Uploading an Archive to Azure Storage#

For my Azure girls 💙, here’s how to compress a folder and upload it to an Azure Storage Blob:

1
data "archive_file" "app_package" {
2
  type        = "zip"
3
  source_dir  = "${path.module}/my_app_folder"
4
  output_path = "${path.module}/app_package.zip"
5
}

Now, create a storage account and upload it:

1
resource "azurerm_storage_blob" "example" {
2
  name                   = "app_package.zip"
3
  storage_account_name   = azurerm_storage_account.example.name
4
  storage_container_name = azurerm_storage_container.example.name
5
  type                   = "Block"
6
  source                 = data.archive_file.app_package.output_path
7

8
  depends_on = [data.archive_file.app_package]
9
}

Troubleshooting archive_file Issues#

Terraform acting up? Here’s how to fix common archive_file headaches:

1️⃣ Incorrect Source Path → Check your file paths! Use ${path.module} to avoid mistakes.
2️⃣ Missing zip Utility → Terraform needs zip installed. Fix it with:

• Linux: sudo apt install zip
• macOS: brew install zip
• Windows: Ensure zip.exe is in your PATH.

3️⃣ Files Not Updating? → Terraform won’t detect changes inside source_dir. Use filemd5() like this:

1
output "archive_hash" {
2
  value = filemd5(data.archive_file.example.output_path)
3
}

4️⃣ Permission Issues → If AWS Lambda or Docker throws permission errors, chmod your files before zipping:

1
chmod +x my_script.sh

5️⃣ Wrong Paths in Modules → Always use ${path.module}, not ${path.root}!

Key Takeaways#

💖 archive_file is a Terraform essential for packaging files before deployment.
💖 Use source_file for one file and source_dir for entire folders.
💖 Troubleshoot common issues with paths, permissions, and missing utilities.

Terraform is fun (and powerful), so go forth and automate like the IT queen you are! 👩‍💻✨

VERDICT & AESTHETICS#

• Visual Doctrine: Traditional DevRel creates noise. I engineer clarity, proving that deep infrastructure and an unapologetically pink aesthetic belong in the same boardroom. Deploy like a queen. Study the architecture on YouTube.
• The Syndicate: Stop fighting your deployments alone. Gain access to zero-friction protocols, enterprise subsidies, and the DevOps Army. Enter the Discord Ecosystem.