iSharkFly-Docs
/
packer-cn
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Merge pull request #3267 from aaronharnly/patch-1 

"environmental variable" -> "environment variable"
This commit is contained in:
Chris Bednarski 2016-02-25 15:32:55 -08:00
parent 25fe234f9f f47d58f92e
commit 39f7eec3e1
1 changed files with 9 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
website/source/docs/templates/user-variables.html.markdown vendored
View File

@ -1,7 +1,7 @@
--- ---
description: | description: |
User variables allow your templates to be further configured with variables from User variables allow your templates to be further configured with variables from
the command-line, environmental variables, or files. This lets you parameterize the command-line, environment variables, or files. This lets you parameterize
your templates so that you can keep secret tokens, environment-specific data, your templates so that you can keep secret tokens, environment-specific data,
and other types of information out of your templates. This maximizes the and other types of information out of your templates. This maximizes the
portability and shareability of the template. portability and shareability of the template.
@ -12,7 +12,7 @@ page_title: User Variables in Templates
# User Variables # User Variables
User variables allow your templates to be further configured with variables from User variables allow your templates to be further configured with variables from
the command-line, environmental variables, or files. This lets you parameterize the command-line, environment variables, or files. This lets you parameterize
your templates so that you can keep secret tokens, environment-specific data, your templates so that you can keep secret tokens, environment-specific data,
and other types of information out of your templates. This maximizes the and other types of information out of your templates. This maximizes the
portability and shareability of the template. portability and shareability of the template.
@ -62,11 +62,11 @@ function in the form of <code>{{user \`variable\`}}</code>. This function can be
used in *any value* within the template, in builders, provisioners, *anything*. used in *any value* within the template, in builders, provisioners, *anything*.
The user variable is available globally within the template. The user variable is available globally within the template.
## Environmental Variables ## Environment Variables
Environmental variables can be used within your template using user variables. Environment variables can be used within your template using user variables.
The `env` function is available *only* within the default value of a user The `env` function is available *only* within the default value of a user
variable, allowing you to default a user variable to an environmental variable. variable, allowing you to default a user variable to an environment variable.
An example is shown below: An example is shown below:
``` {.javascript} ``` {.javascript}
@ -79,13 +79,13 @@ An example is shown below:
} }
``` ```
This will default "my\_secret" to be the value of the "MY\_SECRET" environmental This will default "my\_secret" to be the value of the "MY\_SECRET" environment
variable (or the empty string if it does not exist). variable (or the empty string if it does not exist).
-&gt; **Why can't I use environmental variables elsewhere?** User variables are -&gt; **Why can't I use environment variables elsewhere?** User variables are
the single source of configurable input to a template. We felt that having the single source of configurable input to a template. We felt that having
environmental variables used *anywhere* in a template would confuse the user environment variables used *anywhere* in a template would confuse the user
about the possible inputs to a template. By allowing environmental variables about the possible inputs to a template. By allowing environment variables
only within default values for user variables, user variables remain as the only within default values for user variables, user variables remain as the
single source of input to a template that a user can easily discover using single source of input to a template that a user can easily discover using
`packer inspect`. `packer inspect`.