1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
|
# Terraform provider for libvirt
 [](https://travis-ci.org/dmacvicar/terraform-provider-libvirt) [](https://coveralls.io/github/dmacvicar/terraform-provider-libvirt?branch=master)
This provider is still being actively developed. To see what is left or planned, see the [issues list](https://github.com/dmacvicar/terraform-provider-libvirt/issues).
This is a terraform provider that lets you provision
servers on a [libvirt](https://libvirt.org/) host via [Terraform](https://terraform.io/).
## Requirements
* libvirt 1.2.14 or newer on the hypervisor
The provider uses `virDomainInterfaceAddresses` which was added in 1.2.14. If you need a stable server distribution with a recent libvirt version, try [openSUSE Leap](https://www.opensuse.org/) or [Ubuntu](http://www.ubuntu.com/server) (from version 15.10 Wily Werewolf on).
In the future, I may try to support older libvirt versions if I find a way to elegantely conditional compile the code and get the IP addresses with alternative methods.
## Installing
[Copied from the Terraform documentation](https://www.terraform.io/docs/plugins/basics.html):
> 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)
```console
DISTRO=openSUSE_Leap_42.1
zypper addrepo http://download.opensuse.org/repositories/Virtualization:containers/$DISTRO/Virtualization:containers.repo
zypper refresh
zypper install terraform-provider-libvirt
```
The binary should be renamed to terraform-provider-libvirt
You should update your .terraformrc and refer to the binary:
```hcl
providers {
libvirt = "/path/to/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):
```hcl
provider "libvirt" {
uri = "qemu:///system"
}
```
You can also set the URI in the LIBVIRT_DEFAULT_URI environment variable.
Now, define a libvirt domain:
```hcl
resource "libvirt_domain" "terraform_test" {
name = "terraform_test"
}
```
Now you can see the plan, apply it, and then destroy the infrastructure:
```console
$ terraform plan
$ terraform apply
$ terraform destroy
```
## Building from source
1. [Install Go](https://golang.org/doc/install) on your machine
2. [Set up Gopath](https://golang.org/doc/code.html)
3. `git clone` this repository into `$GOPATH/src/github.com/dmacvicar/terraform-provider-libvirt`
4. Get the dependencies, either with `go get`
1. Run `go get`
2. Switch the terraform project back to the stable version, otherwise you will get a `Incompatible API version with plugin. Plugin version: 1, Ours: 2` error at runtime:
```
cd $GOPATH/src/github.com/hashicorp/terraform
git checkout v0.6.16
cd $GOPATH/src/github.com/dmacvicar/terraform-provider-libvirt
```
5. .. or alternatively install [govend](https://github.com/govend/govend) and:
1. Run `govend`, which will scan dependencies and download them into vendor
2. problematic dependencies, like terraform, will be automatically in the right version thanks to the `vendor.yml` file.
6. Run `go install` to build the binary. You will now find the
binary at `$GOPATH/bin/terraform-provider-libvirt`.
## Running
1. create the example file libvirt.tf in your working directory
2. terraform plan
3. terraform apply
## Running acceptance tests
You need to define the LIBVIRT_DEFAULT_URI and TF_ACC variables:
```console
export LIBVIRT_DEFAULT_URI=qemu:///system
export TF_ACC=1
go test ./...
```
## Known Problems
* There is a [bug in libvirt](https://bugzilla.redhat.com/show_bug.cgi?id=1293804) that seems to be causing
problems to unlink volumes. Tracked [here](https://github.com/dmacvicar/terraform-provider-libvirt/issues/6).
If you see something like:
```console
cannot unlink file '/var/lib/libvirt/images/XXXXXXXXXXXX': Permission denied
```
It is probably related and fixed in libvirt 1.3.3 (already available in openSUSE Tumbleweed).
* On Ubuntu distros SELinux is enforced by qemu even if it is disabled globally, this might cause unexpected `Could not open '/var/lib/libvirt/images/<FILE_NAME>': Permission denied` errors. Double check that `security_driver = "none"` is uncommented in `/etc/libvirt/qemu.conf` and issue `sudo systemctl restart libvirt-bin` to restart the daemon.
## Author
* Duncan Mac-Vicar P. <dmacvicar@suse.de>
The structure and boilerplate is inspired from the [Softlayer](https://github.com/finn-no/terraform-provider-softlayer) and [Google](https://github.com/hashicorp/terraform/tree/master/builtin/providers/google) Terraform provider sources.
## License
* Apache 2.0, See LICENSE file
|