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

---
layout: "rundeck"
page_title: "Provider: Rundeck"
sidebar_current: "docs-rundeck-index"
description: |-
  The Rundeck provider configures projects, jobs and keys in Rundeck.
---

# Rundeck Provider

The Rundeck provider allows Terraform to create and configure Projects,
Jobs and Keys in [Rundeck](http://rundeck.org/). Rundeck is a tool
for runbook automation and execution of arbitrary management tasks,
allowing operators to avoid logging in to individual machines directly
via SSH.

The provider configuration block accepts the following arguments:

* ``url`` - (Required) The root URL of a Rundeck server. May alternatively be set via the
  ``RUNDECK_URL`` environment variable.

* ``auth_token`` - (Required) The API auth token to use when making requests. May alternatively
  be set via the ``RUNDECK_AUTH_TOKEN`` environment variable.

* ``allow_unverified_ssl`` - (Optional) Boolean that can be set to ``true`` to disable SSL
  certificate verification. This should be used with care as it could allow an attacker to
  intercept your auth token.

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

## Example Usage

```
provider "rundeck" {
    url = "http://rundeck.example.com/"
    auth_token = "abcd1234"
}

resource "rundeck_project" "anvils" {
    name = "anvils"
    description = "Application for managing Anvils"

    ssh_key_storage_path = "${rundeck_private_key.anvils.path}"

    resource_model_source {
        type = "file"
        config = {
            format = "resourcexml"
            # This path is interpreted on the Rundeck server.
            file = "/var/rundeck/projects/anvils/resources.xml"
        }
    }
}

resource "rundeck_job" "bounceweb" {
    name = "Bounce Web Servers"
    project_name = "${rundeck_project.anvils.name}"
    node_filter_query = "tags: web"
    description = "Restart the service daemons on all the web servers"

    command {
        shell_command = "sudo service anvils restart"
    }
}

resource "rundeck_public_key" "anvils" {
    path = "anvils/id_rsa.pub"
    key_material = "ssh-rsa yada-yada-yada"
}

resource "rundeck_private_key" "anvils" {
    path = "anvils/id_rsa"
    key_material = "${file(\"id_rsa.pub\")}"
}
```