terraform/website/docs/language/resources/provisioners/remote-exec.html.md

76 lines
2.5 KiB
Markdown
Raw Normal View History

2014-07-23 18:40:15 +02:00
---
layout: "language"
2014-07-23 18:40:15 +02:00
page_title: "Provisioner: remote-exec"
sidebar_current: "docs-provisioners-remote"
2014-10-22 05:21:56 +02:00
description: |-
The `remote-exec` provisioner invokes a script on a remote resource after it is created. This can be used to run a configuration management tool, bootstrap into a cluster, etc. To invoke a local process, see the `local-exec` provisioner instead. The `remote-exec` provisioner supports both `ssh` and `winrm` type connections.
2014-07-23 18:40:15 +02:00
---
# remote-exec Provisioner
The `remote-exec` provisioner invokes a script on a remote resource after it
is created. This can be used to run a configuration management tool, bootstrap
into a cluster, etc. To invoke a local process, see the `local-exec`
[provisioner](/docs/language/resources/provisioners/local-exec.html) instead. The `remote-exec`
provisioner supports both `ssh` and `winrm` type [connections](/docs/language/resources/provisioners/connection.html).
2014-07-23 18:40:15 +02:00
-> **Note:** Provisioners should only be used as a last resort. For most
common situations there are better alternatives. For more information, see
[the main Provisioners page](./).
2014-07-23 18:40:15 +02:00
## Example usage
```hcl
2014-07-23 18:40:15 +02:00
resource "aws_instance" "web" {
# ...
provisioner "remote-exec" {
inline = [
"puppet apply",
"consul join ${aws_instance.web.private_ip}",
]
}
2014-07-23 18:40:15 +02:00
}
```
## Argument Reference
2014-07-23 21:14:31 +02:00
The following arguments are supported:
2014-07-23 18:40:15 +02:00
* `inline` - This is a list of command strings. They are executed in the order
2014-07-23 18:40:15 +02:00
they are provided. This cannot be provided with `script` or `scripts`.
* `script` - This is a path (relative or absolute) to a local script that will
be copied to the remote resource and then executed. This cannot be provided
with `inline` or `scripts`.
* `scripts` - This is a list of paths (relative or absolute) to local scripts
2014-07-23 18:40:15 +02:00
that will be copied to the remote resource and then executed. They are executed
in the order they are provided. This cannot be provided with `inline` or `script`.
2015-04-22 09:03:38 +02:00
## Script Arguments
You cannot pass any arguments to scripts using the `script` or
`scripts` arguments to this provisioner. If you want to specify arguments,
2015-04-22 09:03:38 +02:00
upload the script with the
[file provisioner](/docs/language/resources/provisioners/file.html)
2015-04-22 09:03:38 +02:00
and then use `inline` to call it. Example:
```hcl
2015-04-22 09:03:38 +02:00
resource "aws_instance" "web" {
# ...
2015-04-22 09:03:38 +02:00
provisioner "file" {
source = "script.sh"
destination = "/tmp/script.sh"
}
2015-04-22 09:03:38 +02:00
provisioner "remote-exec" {
inline = [
"chmod +x /tmp/script.sh",
"/tmp/script.sh args",
]
}
2015-04-22 09:03:38 +02:00
}
```