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

40 lines
1.5 KiB
Markdown
Raw Normal View History

2016-10-24 08:18:04 +02:00
---
layout: "nomad"
page_title: "Provider: Nomad"
sidebar_current: "docs-nomad-index"
description: |-
Nomad is a cluster scheduler. The Nomad provider exposes resources to interact with a Nomad cluster.
---
# Nomad Provider
[Nomad](https://www.nomadproject.io) is a cluster scheduler. The Nomad
provider exposes resources to interact with a Nomad cluster.
Use the navigation to the left to read about the available resources.
## Example Usage
2017-04-10 18:28:09 +02:00
```hcl
2016-10-24 08:18:04 +02:00
# Configure the Nomad provider
provider "nomad" {
address = "nomad.mycompany.com"
region = "us-east-2"
2016-10-24 08:18:04 +02:00
}
# Register a job
resource "nomad_job" "monitoring" {
jobspec = "${file("${path.module}/jobspec.hcl")}"
2016-10-24 08:18:04 +02:00
}
```
## Argument Reference
The following arguments are supported:
* `address` - (Optional) The HTTP(S) API address of the Nomad agent to use. Defaults to `http://127.0.0.1:4646`. The `NOMAD_ADDR` environment variable can also be used.
2016-10-24 08:18:04 +02:00
* `region` - (Optional) The Nomad region to target. The `NOMAD_REGION` environment variable can also be used.
2017-04-26 00:17:32 +02:00
* `ca_file` - (Optional) A path to a PEM-encoded certificate authority used to verify the remote agent's certificate. The `NOMAD_CACERT` environment variable can also be used.
* `cert_file` - (Optional) A path to a PEM-encoded certificate provided to the remote agent; requires use of `key_file`. The `NOMAD_CLIENT_CERT` environment variable can also be used.
* `key_file`- (Optional) A path to a PEM-encoded private key, required if `cert_file` is specified. The `NOMAD_CLIENT_KEY` environment variable can also be used.