ResiLien
/
terraform
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Merge pull request #23949 from hashicorp/docs/dynamic-blocks 

Update dynamic block docs to use a better example
This commit is contained in:
Pam Selle 2020-01-24 14:42:27 -05:00 committed by GitHub
parent b1313eaf7d 213189c3d0
commit 2672ddba02
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 17 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
website/docs/configuration/expressions.html.md
View File

@ -664,29 +664,31 @@ form. This covers many uses, but some resource types include repeatable _nested
blocks_ in their arguments, which do not accept expressions: blocks_ in their arguments, which do not accept expressions:
```hcl ```hcl
resource "aws_security_group" "example" { resource "aws_elastic_beanstalk_environment" "tfenvtest" {
name = "example" # can use expressions here name = "tf-test-name" # can use expressions here
ingress { setting {
# but the "ingress" block is always a literal block # but the "setting" block is always a literal block
} }
} }
``` ```
You can dynamically construct repeatable nested blocks like `ingress` using a You can dynamically construct repeatable nested blocks like `setting` using a
special `dynamic` block type, which is supported inside `resource`, `data`, special `dynamic` block type, which is supported inside `resource`, `data`,
`provider`, and `provisioner` blocks: `provider`, and `provisioner` blocks:
```hcl ```hcl
resource "aws_security_group" "example" { resource "aws_elastic_beanstalk_environment" "tfenvtest" {
name = "example" # can use expressions here name = "tf-test-name"
application = "${aws_elastic_beanstalk_application.tftest.name}"
solution_stack_name = "64bit Amazon Linux 2018.03 v2.11.4 running Go 1.12.6"
dynamic "ingress" { dynamic "setting" {
for_each = var.service_ports for_each = var.settings
content { content {
from_port = ingress.value namespace = setting.value["namespace"]
to_port = ingress.value name = setting.value["name"]
protocol = "tcp" value = setting.value["value"]
} }
} }
} }
@ -696,12 +698,12 @@ A `dynamic` block acts much like a `for` expression, but produces nested blocks
instead of a complex typed value. It iterates over a given complex value, and instead of a complex typed value. It iterates over a given complex value, and
generates a nested block for each element of that complex value. generates a nested block for each element of that complex value.
- The label of the dynamic block (`"ingress"` in the example above) specifies - The label of the dynamic block (`"setting"` in the example above) specifies
what kind of nested block to generate. what kind of nested block to generate.
- The `for_each` argument provides the complex value to iterate over. - The `for_each` argument provides the complex value to iterate over.
- The `iterator` argument (optional) sets the name of a temporary variable - The `iterator` argument (optional) sets the name of a temporary variable
that represents the current element of the complex value. If omitted, the name that represents the current element of the complex value. If omitted, the name
of the variable defaults to the label of the `dynamic` block (`"ingress"` in of the variable defaults to the label of the `dynamic` block (`"setting"` in
the example above). the example above).
- The `labels` argument (optional) is a list of strings that specifies the block - The `labels` argument (optional) is a list of strings that specifies the block
labels, in order, to use for each generated block. You can use the temporary labels, in order, to use for each generated block. You can use the temporary
@ -713,7 +715,7 @@ Since the `for_each` argument accepts any collection or structural value,
you can use a `for` expression or splat expression to transform an existing you can use a `for` expression or splat expression to transform an existing
collection. collection.
The iterator object (`ingress` in the example above) has two attributes: The iterator object (`setting` in the example above) has two attributes:
* `key` is the map key or list element index for the current element. If the * `key` is the map key or list element index for the current element. If the
`for_each` expression produces a _set_ value then `key` is identical to `for_each` expression produces a _set_ value then `key` is identical to