github.com/danp/terraform@v0.9.5-0.20170426144147-39d740081351/website/source/docs/providers/arukas/index.html.markdown (about)

     1  ---
     2  layout: "arukas"
     3  page_title: "Provider: Arukas"
     4  sidebar_current: "docs-arukas-index"
     5  description: |-
     6    The Arukas provider is used to interact with the resources supported by Arukas.
     7  ---
     8  
     9  # Arukas Provider
    10  
    11  The Arukas provider is used to manage [Arukas](https://arukas.io/en/) resources.
    12  
    13  Use the navigation to the left to read about the available resources.
    14  
    15  For additional details please refer to [Arukas documentation](https://arukas.io/en/category/documents-en/).
    16  
    17  ## Example Usage
    18  
    19  Here is an example that will setup the following:
    20  
    21  + A container resource using the "NGINX" image
    22  + Instance count is 1
    23  + Memory size is 256Mbyte
    24  + Expose tcp 80 port to the EndPoint
    25  + Set environments variable with like "key1=value1"
    26  
    27  Add the below to a file called `arukas.tf` and run the `terraform` command from the same directory:
    28  
    29  ```hcl
    30  provider "arukas" {
    31    token  = ""
    32    secret = ""
    33  }
    34  
    35  resource "arukas_container" "foobar" {
    36    name      = "terraform_for_arukas_test_foobar"
    37    image     = "nginx:latest"
    38    instances = 1
    39    memory    = 256
    40  
    41    ports = {
    42      protocol = "tcp"
    43      number   = "80"
    44    }
    45  
    46    environments {
    47      key   = "key1"
    48      value = "value1"
    49    }
    50  }
    51  ```
    52  
    53  You'll need to provide your Arukas API token and secret,
    54  so that Terraform can connect. If you don't want to put
    55  credentials in your configuration file, you can leave them
    56  out:
    57  
    58  ```hcl
    59  provider "arukas" {}
    60  ```
    61  
    62  ...and instead set these environment variables:
    63  
    64  - `ARUKAS_JSON_API_TOKEN` : Your Arukas API token
    65  - `ARUKAS_JSON_API_SECRET`: Your Arukas API secret
    66  
    67  ## Argument Reference
    68  
    69  The following arguments are supported:
    70  
    71  * `token` - (Required) This is the Arukas API token. It must be provided, but
    72    it can also be sourced from the `ARUKAS_JSON_API_TOKEN` environment variable.
    73  
    74  * `secret` - (Required) This is the Arukas API secret. It must be provided, but
    75    it can also be sourced from the `ARUKAS_JSON_API_SECRET` environment variable.
    76  
    77  * `api_url` - (Optional) Override Arukas API Root URL. Also taken from the `ARUKAS_JSON_API_URL`
    78    environment variable if provided.
    79  
    80  * `trace` - (Optional) The flag of Arukas API trace log. Also taken from the `ARUKAS_DEBUG`
    81    environment variable if provided.
    82  
    83  * `timeout` - (Optional) Override Arukas API timeout seconds. Also taken from the `ARUKAS_TIMEOUT`
    84    environment variable if provided.