Terraform local values

locals Terraform block (tf.io)

A local value can only be accessed in expressions within the module where it was declared.

Examples

locals {
  environment  = "prod"
  service_name = "forum"
  owner        = "Community Team"
}

locals {
 # Ids for multiple sets of EC2 instances, merged together
 instance_ids = concat(aws_instance.blue.*.id, aws_instance.green.*.id)
}

locals {
  # Common tags to be assigned to all resources
  common_tags = {
    Service = local.service_name
    Owner   = local.owner
  }
}

locals {
  name   = "example-${replace(basename(path.cwd), "_", "-")}"
  region = "eu-west-1"
  tags = {
    Owner       = "user"
    Environment = "dev"
 }
}

Grok:

locals {
 alerts = jsondecode(file("${path.module}/alerts.json"))
}

Errors

• Error: Reference to undeclared local value

Related

• var.
• local.
• module.
• path.
• Terraform resource: random_password
• Terraform: Meta-Arguments
• Terragrunt: locals
• count = local.create_node_sg ? 1 : 0
• Terraform sensitive function
• ephemeral
• generate_hcl

See also

• Terraform local values, local., locals.tf
• Terraform blocks: terraform, cloud, moved, dynamic, Terraform import block, required_providers
• Terraform variables, types, env variables, variables.tf, .tfvars, nullable, validation, terraform.tfvars