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

46 lines
1.2 KiB
Markdown

---
layout: "cobbler"
page_title: "Provider: Cobbler"
sidebar_current: "docs-cobbler-index"
description: |-
The Cobbler provider is used to interact with a locally installed,
Cobbler service.
---
# Cobbler Provider
The Cobbler provider is used to interact with a locally installed
[Cobbler](http://cobbler.github.io) service. The provider needs
to be configured with the proper credentials before it can be used.
Use the navigation to the left to read about the available resources.
## Example Usage
```hcl
# Configure the Cobbler provider
provider "cobbler" {
username = "${var.cobbler_username}"
password = "${var.cobbler_password}"
url = "${var.cobbler_url}"
}
# Create a Cobbler Distro
resource "cobbler_distro" "ubuntu-1404-x86_64" {
# ...
}
```
## Argument Reference
The following arguments are supported:
* `username` - (Required) The username to the Cobbler service. This can
also be specified with the `COBBLER_USERNAME` shell environment variable.
* `password` - (Required) The password to the Cobbler service. This can
also be specified with the `COBBLER_PASSWORD` shell environment variable.
* `url` - (Required) The url to the Cobbler service. This can
also be specified with the `COBBLER_URL` shell environment variable.