github.com/turtlemonvh/terraform@v0.6.9-0.20151204001754-8e40b6b855e8/website/source/docs/providers/rundeck/index.html.markdown (about)

     1  ---
     2  layout: "rundeck"
     3  page_title: "Provider: Rundeck"
     4  sidebar_current: "docs-rundeck-index"
     5  description: |-
     6    The Rundeck provider configures projects, jobs and keys in Rundeck.
     7  ---
     8  
     9  # Rundeck Provider
    10  
    11  The Rundeck provider allows Terraform to create and configure Projects,
    12  Jobs and Keys in [Rundeck](http://rundeck.org/). Rundeck is a tool
    13  for runbook automation and execution of arbitrary management tasks,
    14  allowing operators to avoid logging in to individual machines directly
    15  via SSH.
    16  
    17  The provider configuration block accepts the following arguments:
    18  
    19  * ``url`` - (Required) The root URL of a Rundeck server. May alternatively be set via the
    20    ``RUNDECK_URL`` environment variable.
    21  
    22  * ``auth_token`` - (Required) The API auth token to use when making requests. May alternatively
    23    be set via the ``RUNDECK_AUTH_TOKEN`` environment variable.
    24  
    25  * ``allow_unverified_ssl`` - (Optional) Boolean that can be set to ``true`` to disable SSL
    26    certificate verification. This should be used with care as it could allow an attacker to
    27    intercept your auth token.
    28  
    29  Use the navigation to the left to read about the available resources.
    30  
    31  ## Example Usage
    32  
    33  ```
    34  provider "rundeck" {
    35      url = "http://rundeck.example.com/"
    36      auth_token = "abcd1234"
    37  }
    38  
    39  resource "rundeck_project" "anvils" {
    40      name = "anvils"
    41      description = "Application for managing Anvils"
    42  
    43      ssh_key_storage_path = "${rundeck_private_key.anvils.path}"
    44  
    45      resource_model_source {
    46          type = "file"
    47          config = {
    48              format = "resourcexml"
    49              # This path is interpreted on the Rundeck server.
    50              file = "/var/rundeck/projects/anvils/resources.xml"
    51          }
    52      }
    53  }
    54  
    55  resource "rundeck_job" "bounceweb" {
    56      name = "Bounce Web Servers"
    57      project_name = "${rundeck_project.anvils.name}"
    58      node_filter_query = "tags: web"
    59      description = "Restart the service daemons on all the web servers"
    60  
    61      command {
    62          shell_command = "sudo service anvils restart"
    63      }
    64  }
    65  
    66  resource "rundeck_public_key" "anvils" {
    67      path = "anvils/id_rsa.pub"
    68      key_material = "ssh-rsa yada-yada-yada"
    69  }
    70  
    71  resource "rundeck_private_key" "anvils" {
    72      path = "anvils/id_rsa"
    73      key_material = "${file(\"id_rsa.pub\")}"
    74  }
    75  ```