diff options
author | Flavio Castelli <flavio@castelli.name> | 2017-05-26 12:23:43 +0200 |
---|---|---|
committer | GitHub <noreply@github.com> | 2017-05-26 12:23:43 +0200 |
commit | 686015805f14b93e7ef4d6d5a5655ab2b8154b79 (patch) | |
tree | de2acf4cfdbed6636a2c854bea452f6ff33a8aae /docs | |
parent | 72fefb6fc13e75d850a6c67d572191e829ae2143 (diff) | |
parent | f130f9848e61924bded600602a91822cf76e0959 (diff) | |
download | terraform-provider-libvirt-686015805f14b93e7ef4d6d5a5655ab2b8154b79.tar terraform-provider-libvirt-686015805f14b93e7ef4d6d5a5655ab2b8154b79.tar.gz |
Merge pull request #107 from eamonnotoole/remote-ignition-temp-file-upstream
Write Ignition file as a volume in a libvirt storage pool
Diffstat (limited to 'docs')
-rw-r--r-- | docs/providers/libvirt/r/coreos_ignition.html.markdown | 38 | ||||
-rw-r--r-- | docs/providers/libvirt/r/domain.html.markdown | 14 |
2 files changed, 47 insertions, 5 deletions
diff --git a/docs/providers/libvirt/r/coreos_ignition.html.markdown b/docs/providers/libvirt/r/coreos_ignition.html.markdown new file mode 100644 index 00000000..ae95e77b --- /dev/null +++ b/docs/providers/libvirt/r/coreos_ignition.html.markdown @@ -0,0 +1,38 @@ +--- +layout: "libvirt" +page_title: "Libvirt: libvirt_ignition" +sidebar_current: "docs-libvirt-ignition" +description: |- + Manages a CoreOS Ignition file to supply to a domain +--- + +# libvirt\_ignition + +Manages a [CoreOS Ignition](https://coreos.com/ignition/docs/latest/supported-platforms.html) +file written as a volume to a libvirt storage pool that can be used to customize a CoreOS Domain during 1st +boot. + +## Example Usage + +``` +resource "libvirt_ignition" "ignition" { + name = "example.ign" + content = <file-name or ignition object> +} + +``` + +## Argument Reference + +The following arguments are supported: + +* `name` - (Required) A unique name for the resource, required by libvirt. +* `pool` - (Optional) The pool where the resource will be created. + If not given, the `default` pool will be used. +* `content` - (Required) This points to the source of the Ignition configuration + information that will be used to create the Ignition file in the libvirt + storage pool. The `content` can be + * The name of file that contains Ignition configuration data, or its contents + * A rendered Terraform Ignition object + +Any change of the above fields will cause a new resource to be created. diff --git a/docs/providers/libvirt/r/domain.html.markdown b/docs/providers/libvirt/r/domain.html.markdown index af3d7247..a779a69b 100644 --- a/docs/providers/libvirt/r/domain.html.markdown +++ b/docs/providers/libvirt/r/domain.html.markdown @@ -41,10 +41,9 @@ The following arguments are supported: cloud-init won't cause the domain to be recreated, however the change will have effect on the next reboot. -The following extra argument is provided for CoreOS images: - -* `coreos_ignition` - (Optional) This can be set to the name of an existing ignition -file or alternatively can be set to the rendered value of a Terraform ignition provider object. +There is an optional `coreos_ignition` parameter: +* `coreos_ignition` (Optional) The `libvirt_ignition` resource that is to be used by + the CoreOS domain. An example where a Terraform ignition provider object is used: ``` @@ -61,8 +60,13 @@ resource "ignition_config" "example" { ] } +resource "libvirt_ignition" "ignition" { + name = "ignition" + content = "${ignition_config.example.rendered}" +} + resource "libvirt_domain" "my_machine" { - coreos_ignition = "${ignition_config.example.rendered}" + coreos_ignition = "${libvirt_ignition.ignition.id}" ... } ``` |