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

Merge pull request #8566 from MiLk/docs/interpolation-template-data 

Template are now data sources
This commit is contained in:
Paul Stack 2016-09-04 00:30:11 +03:00 committed by GitHub
parent 7be6310a12 95a86cc617
commit b49fbb5383
1 changed files with 8 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
website/source/docs/configuration/interpolation.html.md
View File

@ -246,12 +246,12 @@ The supported built-in functions are:
## Templates ## Templates
Long strings can be managed using templates. [Templates](/docs/providers/template/index.html) are [resources](/docs/configuration/resources.html) defined by a filename and some variables to use during interpolation. They have a computed `rendered` attribute containing the result. Long strings can be managed using templates. [Templates](/docs/providers/template/index.html) are [data-sources](/docs/configuration/data-sources.html) defined by a filename and some variables to use during interpolation. They have a computed `rendered` attribute containing the result.
A template resource looks like: A template data source looks like:
``` ```
resource "template_file" "example" { data "template_file" "example" {
template = "${hello} ${world}!" template = "${hello} ${world}!"
vars { vars {
hello = "goodnight" hello = "goodnight"
@ -260,7 +260,7 @@ resource "template_file" "example" {
} }
output "rendered" { output "rendered" {
value = "${template_file.example.rendered}" value = "${data.template_file.example.rendered}"
} }
``` ```
@ -271,7 +271,7 @@ You may use any of the built-in functions in your template.
### Using Templates with Count ### Using Templates with Count
Here is an example that combines the capabilities of templates with the interpolation Here is an example that combines the capabilities of templates with the interpolation
from `count` to give us a parametized template, unique to each resource instance: from `count` to give us a parameterized template, unique to each resource instance:
``` ```
variable "count" { variable "count" {
@ -285,7 +285,7 @@ variable "hostnames" {
} }
} }
resource "template_file" "web_init" { data "template_file" "web_init" {
// here we expand multiple template_files - the same number as we have instances // here we expand multiple template_files - the same number as we have instances
count = "${var.count}" count = "${var.count}"
template = "${file("templates/web_init.tpl")}" template = "${file("templates/web_init.tpl")}"
@ -299,11 +299,11 @@ resource "aws_instance" "web" {
// ... // ...
count = "${var.count}" count = "${var.count}"
// here we link each web instance to the proper template_file // here we link each web instance to the proper template_file
user_data = "${element(template_file.web_init.*.rendered, count.index)}" user_data = "${element(data.template_file.web_init.*.rendered, count.index)}"
} }
``` ```
With this, we will build a list of `template_file.web_init` resources which we can With this, we will build a list of `template_file.web_init` data sources which we can
use in combination with our list of `aws_instance.web` resources. use in combination with our list of `aws_instance.web` resources.
## Math ## Math