terraform/website/source/docs/providers/ignition/index.html.markdown

layout	page_title	sidebar_current	description
ignition	Provider: Ignition	docs-ignition-index	The Ignition provider is used to generate Ignition configuration files used by CoreOS Linux.

Ignition Provider

The Ignition provider is used to generate Ignition configuration files. Ignition is the provisioning utility used by CoreOS Linux.

The ignition provider is what we call a logical provider and doesn't manage any physical resources. It generates configurations files to be used by other resources.

Use the navigation to the left to read about the available resources.

Example Usage

This config will write a single service unit (shown below) with the contents of an example service. This unit will be enabled as a dependency of multi-user.target and therefore start on boot

# Systemd unit resource containing the unit definition
resource "ignition_systemd_unit" "example" {
  name    = "example.service"
  content = "[Service]\nType=oneshot\nExecStart=/usr/bin/echo Hello World\n\n[Install]\nWantedBy=multi-user.target"
}

# Ingnition config include the previous defined systemd unit resource
resource "ignition_config" "example" {
  systemd = [
    "${ignition_systemd_unit.example.id}",
  ]
}

# Create a CoreOS server using the Igntion config.
resource "aws_instance" "web" {
  # ...

  user_data = "${ignition_config.example.rendered}"
}