github.com/vtorhonen/terraform@v0.9.0-beta2.0.20170307220345-5d894e4ffda7/website/source/docs/providers/rabbitmq/index.html.markdown (about)

     1  ---
     2  layout: "rabbitmq"
     3  page_title: "Provider: RabbitMQ"
     4  sidebar_current: "docs-rabbitmq-index"
     5  description: |-
     6    A provider for a RabbitMQ Server.
     7  ---
     8  
     9  # RabbitMQ Provider
    10  
    11  [RabbitMQ](http://www.rabbitmq.com) is an AMQP message broker server. The
    12  RabbitMQ provider exposes resources used to manage the configuration of
    13  resources in a RabbitMQ server.
    14  
    15  Use the navigation to the left to read about the available resources.
    16  
    17  ## Example Usage
    18  
    19  The following is a minimal example:
    20  
    21  ```
    22  # Configure the RabbitMQ provider
    23  provider "rabbitmq" {
    24    endpoint = "http://127.0.0.1"
    25    username = "guest"
    26    password = "guest"
    27  }
    28  
    29  # Create a virtual host
    30  resource "rabbitmq_vhost" "vhost_1" {
    31    name = "vhost_1"
    32  }
    33  ```
    34  
    35  ## Requirements
    36  
    37  The RabbitMQ management plugin must be enabled to use this provider. You can
    38  enable the plugin by doing something similar to:
    39  
    40  ```
    41  $ sudo rabbitmq-plugins enable rabbitmq_management
    42  ```
    43  
    44  ## Argument Reference
    45  
    46  The following arguments are supported:
    47  
    48  * `endpoint` - (Required) The HTTP URL of the management plugin on the
    49    RabbitMQ server. The RabbitMQ management plugin *must* be enabled in order
    50    to use this provder. _Note_: This is not the IP address or hostname of the
    51    RabbitMQ server that you would use to access RabbitMQ directly.
    52  * `username` - (Required) Username to use to authenticate with the server.
    53  * `password` - (Optional) Password for the given user.
    54  * `insecure` - (Optional) Trust self-signed certificates.
    55  * `cacert_file` - (Optional) The path to a custom CA / intermediate certificate.