Skip to content
Terraform provider for oVirt 4.x
Go HTML Other
Branch: master
Clone or download
#184 Compare This branch is 232 commits ahead, 1 commit behind EMSL-MSC:master.
Latest commit cc9bb4c Dec 3, 2019

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.12 (to build the provider plugin)

Developing The Provider

If you wish to work on the provider, you'll first need Go installed on your machine (version 1.12+ is required). You'll also need to correctly setup a GOPATH, as well as adding $GOPATH/bin to your $PATH.

Note: This project uses Go Modules making it safe to work with it outside of your existing GOPATH. The instructions that follow assume a directory in your home directory outside of the standard GOPATH (i.e $HOME/development/terraform-providers/).

Clone repository to: $HOME/development/terraform-providers/

$ mkdir -p $HOME/development/terraform-providers/
$ cd $HOME/development/terraform-providers/
$ git clone git@github.com:ovirt/terraform-provider-ovirt
...

To compile the provider, run make build. This will build the provider and put the provider binary in the $GOPATH/bin directory.

$ make build
...
$ $GOPATH/bin/terraform-provider-ovirt
...

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_snapshot
    • 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_nics
    • ovirt_storagedomains
    • ovirt_template
    • ovirt_users
    • ovirt_vms
    • ovirt_vnic_profiles

Provider Documents

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

$ 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.