Terraform oVirt Provider plugin

This plugin allows Terraform to work with the oVirt Virtual Machine management platform. It requires oVirt 4.x.

Statements

Firstly, this project is inspired by EMSL-MSC, the author @Maigard surely done a outstanding work and great thanks to him.

While in the last five months, the upstream project was not actively maintained and the pull request I committed is still not reviewed. Since this project is a heavy work in progress, for intuitive and convenient usage, I replaced the references of EMSL-MSC with imjoey in main.go, README and some other CI configuration files.

If possible, I would surely be happy to contribute back to the upstream again. ^_^ .

Requirements

• Terraform 0.11.x
• Go 1.11 (to build the provider plugin)

Building The Provider

Clone repository to: $GOPATH/src/github.com/imjoey/terraform-provider-ovirt

$ mkdir -p $GOPATH/src/github.com/imjoey
$ cd $GOPATH/src/github.com/imjoey
$ git clone [email protected]:imjoey/terraform-provider-ovirt

Enter the provider directory and build the provider

$ cd $GOPATH/src/github.com/imjoey/terraform-provider-ovirt
$ make build

Using the provider

If you're building the provider, follow the instructions to install it as a plugin. After placing it into your plugins directory, run terraform init to initialize it.

Provider Usage

• Provider Configuration

provider "ovirt" {
  username = "username@profile"
  url = "https://ovirt/ovirt-engine/api"
  password = "Password"
}

• username - (Required) The username to access the oVirt api including the profile used
• url - (Required) The url to the api endpoint (usually the ovirt server with a path of /ovirt-engine/api)
• password - (Required) Password to access the server
• Resources
  • ovirt_cluster
  • ovirt_datacenter
  • ovirt_disk
  • ovirt_disk_attachment
  • ovirt_host
  • ovirt_mac_pool
  • ovirt_network
  • ovirt_storage_domain
  • ovirt_tag
  • ovirt_user
  • ovirt_vm
  • ovirt_vnic
  • ovirt_vnic_profile
• Data Sources
  • ovirt_authzs
  • ovirt_clusters
  • ovirt_datacenters
  • ovirt_disks
  • ovirt_hosts
  • ovirt_mac_pools
  • ovirt_networks
  • ovirt_storagedomains
  • ovirt_users
  • ovirt_vms
  • ovirt_vnic_profiles

Provider Documents

Currently the documents for this provider is not hosted by the offcial site Terraform Providers. Please enter the provider directory and build the website locallly.

$ cd $GOPATH/src/github.com/imjoey/terraform-provider-ovirt
$ make website

The commands above will start a docker-based web server powered by Middleman, which hosts the documents in website directory. Simply open http://localhost:4567/docs/providers/ovirt and enjoy them.