Skip to content
Terraform provider for oVirt
Go Shell HTML Makefile
Branch: master
Clone or download
Pull request Compare This branch is 18 commits ahead, 66 commits behind oVirt:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github
examples
ovirt
scripts
vendor
website
.gitignore
.gitlab-ci.yml
.terraform-version
.travis.yml
CHANGELOG.md
GNUmakefile
Gopkg.lock
Gopkg.toml
LICENSE
README.md
main.go

README.md

Terraform oVirt Provider plugin

Build Status Go Report Card

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 git@github.com: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_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.

You can’t perform that action at this time.