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

Merge pull request #21016 from hashicorp/apr19_null_resource 

website: null_resource isn't a type of provisioner
This commit is contained in:
Nick Fagerlund 2019-04-15 15:43:05 -07:00 committed by GitHub
parent dfcd2fb00c b4042947d1
commit 5b90f66166
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 20 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

30
website/docs/provisioners/null_resource.html.markdown
View File

@ -1,24 +1,25 @@
---
layout: "docs"
page_title: "Provisioners: null_resource"
page_title: "Provisioners Without a Resource"
sidebar_current: "docs-provisioners-null-resource"
description: |-
The `null_resource` is a resource allows you to configure provisioners that
are not directly associated with a single existing resource.
---
# null\_resource
# Provisioners Without a Resource
The `null_resource` is a resource that allows you to configure provisioners
that are not directly associated with a single existing resource.
[null]: /docs/providers/null/resource.html
A `null_resource` behaves exactly like any other resource, so you configure
[provisioners](/docs/provisioners/index.html), [connection
details](/docs/provisioners/connection.html), and other meta-parameters in the
same way you would on any other resource.
If you need to run provisioners that aren't directly associated with a specific
resource, you can associate them with a `null_resource`.
This allows fine-grained control over when provisioners run in the dependency
graph.
Instances of [`null_resource`][null] are treated like normal resources, but they
don't do anything. Like with any other resource, you can configure
[provisioners](/docs/provisioners/index.html) and [connection
details](/docs/provisioners/connection.html) on a `null_resource`. You can also
use its `triggers` argument and any meta-arguments to control exactly where in
the dependency graph its provisioners will run.
## Example usage
@ -31,7 +32,7 @@ resource "aws_instance" "cluster" {
resource "null_resource" "cluster" {
# Changes to any instance of the cluster requires re-provisioning
triggers {
triggers = {
cluster_instance_ids = "${join(",", aws_instance.cluster.*.id)}"
}
@ -52,8 +53,9 @@ resource "null_resource" "cluster" {
## Argument Reference
In addition to all the resource configuration available, `null_resource` supports the following specific configuration options:
In addition to meta-arguments supported by all resources, `null_resource`
supports the following specific arguments:
* `triggers` - A mapping of values which should trigger a rerun of this set of
provisioners. Values are meant to be interpolated references to variables or
* `triggers` - A map of values which should cause this set of provisioners to
re-run. Values are meant to be interpolated references to variables or
attributes of other resources.

8
website/layouts/docs.erb
View File

@ -327,6 +327,10 @@
<a href="/docs/provisioners/connection.html">Provisioner Connections</a>
</li>
<li<%= sidebar_current("docs-provisioners-null-resource") %>>
<a href="/docs/provisioners/null_resource.html">Provisioners Without a Resource</a>
</li>
<li<%= sidebar_current("docs-provisioners-chef") %>>
<a href="/docs/provisioners/chef.html">chef Provisioner</a>
</li>
@ -343,10 +347,6 @@
<a href="/docs/provisioners/local-exec.html">local-exec Provisioner</a>
</li>
<li<%= sidebar_current("docs-provisioners-null-resource") %>>
<a href="/docs/provisioners/null_resource.html">null_resource Provisioner</a>
</li>
<li<%= sidebar_current("docs-provisioners-remote") %>>
<a href="/docs/provisioners/remote-exec.html">remote-exec Provisioner</a>
</li>