/terraform-provider-libvirt

terraform provider for libvirt

Primary LanguageGoApache License 2.0Apache-2.0

Terraform provider for libvirt

alpha Build Status Coverage Status


This is a terraform provider that lets you provision servers on a libvirt host via Terraform.

Table of Content

Website Docs

Installing

Requirements
  • libvirt 1.2.14 or newer on the hypervisor
  • latest golang version
  • mkisofs is required to use the CloudInit feature.

Copied from the Terraform documentation:

To install a plugin, put the binary somewhere on your filesystem, then configure Terraform to be able to find it. The configuration where plugins are defined is ~/.terraformrc for Unix-like systems and %APPDATA%/terraform.rc for Windows.

If you are using opensuse/SUSE distro, add the repo and download the package (check the repo according your distro)

DISTRO=openSUSE_Leap_42.3
zypper addrepo http://download.opensuse.org/repositories/Virtualization:containers/$DISTRO/Virtualization:containers.repo
zypper refresh
zypper install terraform-provider-libvirt

On debian systems you can use alien for converting the rpms

Building from source

This project uses glide to vendor all its dependencies.

You do not have to interact with glide since the vendored packages are already included in the repo.

Ensure you have the latest version of Go installed on your system, terraform usually takes advantage of features available only inside of the latest stable release.

You need also need libvirt-dev(el) package installed.

Run go install to build the binary. You will now find the binary at $GOPATH/bin/terraform-provider-libvirt.

Using the provider

Here is an example that will setup the following:

  • A virtual server resource

(create this as libvirt.tf and run terraform commands from this directory):

provider "libvirt" {
    uri = "qemu:///system"
}

You can also set the URI in the LIBVIRT_DEFAULT_URI environment variable.

Now, define a libvirt domain:

resource "libvirt_domain" "terraform_test" {
  name = "terraform_test"
}

Now you can see the plan, apply it, and then destroy the infrastructure:

$ terraform init
$ terraform plan
$ terraform apply
$ terraform destroy

Look at more advanced examples here

Troubleshooting (aka you have a problem)

Have a look at TROUBLESHOOTING, and feel free to add a PR if you find out something is missing.

Authors

See also the list of contributors who participated in this project.

The structure and boilerplate is inspired from the Softlayer and Google Terraform provider sources.

License

  • Apache 2.0, See LICENSE file