terraform/website/docs/language/configuration-0-11/override.mdx

59 lines
1.8 KiB
Plaintext
Raw Normal View History

---
2021-12-15 03:41:17 +01:00
page_title: Override Files - 0.11 Configuration Language
description: >-
Terraform loads all configuration files within a directory and appends them
together. Terraform also has a concept of overrides, a way to create files
that are loaded last and merged into your configuration, rather than appended.
---
# Override Files
-> **Note:** This page is about Terraform 0.11 and earlier. For Terraform 0.12
and later, see
2021-12-15 03:41:17 +01:00
[Configuration Language: Override Files](/language/files/override).
Terraform loads all configuration files within a directory and
appends them together. Terraform also has a concept of _overrides_,
a way to create files that are loaded last and _merged_ into your
configuration, rather than appended.
Overrides have a few use cases:
2021-12-15 03:41:17 +01:00
- Machines (tools) can create overrides to modify Terraform
behavior without having to edit the Terraform configuration
tailored to human readability.
2021-12-15 03:41:17 +01:00
- Temporary modifications can be made to Terraform configurations
without having to modify the configuration itself.
Overrides names must be `override` or end in `_override`, excluding
the extension. Examples of valid override files are `override.tf`,
`override.tf.json`, `temp_override.tf`.
Override files are loaded last in alphabetical order.
Override files can be in Terraform syntax or JSON, just like non-override
Terraform configurations.
## Example
If you have a Terraform configuration `example.tf` with the contents:
```hcl
resource "aws_instance" "web" {
ami = "ami-408c7f28"
}
```
And you created a file `override.tf` with the contents:
```hcl
resource "aws_instance" "web" {
ami = "foo"
}
```
Then the AMI for the one resource will be replaced with "foo". Note
that the override syntax can be Terraform syntax or JSON. You can
mix and match syntaxes without issue.