Merge pull request #15325 from hashicorp/jbardin/init-docs

update init docs
This commit is contained in:
James Bardin 2017-06-16 18:35:03 -04:00 committed by GitHub
commit 9777174be1
2 changed files with 32 additions and 26 deletions

View File

@ -9,6 +9,10 @@ BACKWARDS INCOMPATIBILITIES / NOTES:
was confusing due to collisions with other concepts of the same name. The commands still work the same as they did before, and
the `env` subcommand is still supported as an alias for backward compatibility. The `env` subcommand will be removed altogether in
a future release, so it's recommended to update any automation or wrapper scripts that use these commands.
* The `terraform init` subcommand no longer takes a SOURCE argument to copy to the current directory. The behavior has
been changed to match that of `plan` and `apply`, so that a configuration can be provided as an argument on the
commandline while initializing the current directory. If a module needs to be copied into the current directory before
initialization, it will have to be done manually.
IMPROVEMENTS:

View File

@ -15,7 +15,7 @@ from version control. It is safe to run this command multiple times.
## Usage
Usage: `terraform init [options] [SOURCE] [PATH]`
Usage: `terraform init [options] [DIR]`
Initialize a new or existing Terraform working directory by creating
initial files, loading any remote state, downloading modules, etc.
@ -26,45 +26,47 @@ necessary to run Terraform that is typically not committed to version
control.
This command is always safe to run multiple times. Though subsequent runs
may give errors, this command will never delete your configuration or state.
Even so, if you have important information, please back it up prior to
running this command just in case.
may give errors, this command will never delete your configuration or
state. Even so, if you have important information, please back it up prior
to running this command, just in case.
If no arguments are given, the configuration in the current working directory
If no arguments are given, the configuration in this working directory
is initialized.
If one or two arguments are given, the first is a SOURCE of a module to
download to the second argument PATH. After downloading the module to PATH,
the configuration will be initialized as if this command were called pointing
only to that PATH. PATH must be empty of any Terraform files. Any
conflicting non-Terraform files will be overwritten. The module download
is a copy. If you're downloading a module from Git, it will not preserve
Git history.
The command-line flags are all optional. The list of available flags are:
* `-backend=true` - Initialize the [backend](/docs/backends) for this configuration.
* `-backend-config=value` - Value can be a path to an HCL file or a string
in the format of 'key=value'. This specifies additional configuration to merge
for the backend. This can be specified multiple times. Flags specified
later in the line override those specified earlier if they conflict.
* `-backend-config=path` This can be either a path to an HCL file with key/value
assignments (same format as terraform.tfvars) or a 'key=value' format. This is
merged with what is in the configuration file. This can be specified multiple
times. The backend type must be in the configuration itself.
* `-force-copy` - Suppress prompts about copying state data. This is equivalent
to providing a "yes" to all confirmation prompts.
* `-force-copy` Suppress prompts about copying state data. This is
equivalent to providing a "yes" to all confirmation prompts.
* `-get=true` - Download any modules for this configuration.
* `-get=true` Download any modules for this configuration.
* `-input=true` - Ask for input interactively if necessary. If this is false
and input is required, `init` will error.
* `-get-plugins=true` Download any missing plugins for this configuration.
* `-lock=true` - Lock the state file when locking is supported.
* `-input=true` Ask for input if necessary. If false, will error if
input was required.
* `-lock-timeout=0s` - Duration to retry a state lock.
* `-lock=true` Lock the state file when locking is supported.
* `-no-color` - If specified, output won't contain any color.
* `-lock-timeout=0s` Duration to retry a state lock.
* `-reconfigure` - Reconfigure the backend, ignoring any saved configuration.
* `-no-color` If specified, output won't contain any color.
* `-plugin-dir` Directory containing plugin binaries. This overrides all
default search paths for plugins, and prevents the automatic installation of
plugins. This flag can be used multiple times.
* `-reconfigure` Reconfigure the backend, ignoring any saved configuration.
* `-upgrade=false` If installing modules (-get) or plugins (-get-plugins),
ignore previously-downloaded objects and install the latest version allowed
within configured constraints.
## Backend Config