LXD Resource provider for Terraform
Clone or download
jtopjian Merge pull request #144 from pmalhaire/patch-1
update the terraform pluging path
Latest commit b8ea62c Oct 15, 2018

README.md

terraform-provider-lxd

LXD Resource provider for Terraform

Build Status

Prerequisites

Installation

Using pre-built binary

  1. Download the binary from the project releases page
  2. Extract provider binary from tar file.
  3. Copy to $PATH or the ~/.terraform.d/plugins directory so Terraform can find it.

Example

# List latest binaries:
curl -s https://api.github.com/repos/sl1pm4t/terraform-provider-lxd/releases/latest | jq '.assets | .[] | .browser_download_url'
  "https://github.com/sl1pm4t/terraform-provider-lxd/releases/download/v1.1.0/terraform-provider-lxd_v1.1.0_darwin_amd64.zip"
  "https://github.com/sl1pm4t/terraform-provider-lxd/releases/download/v1.1.0/terraform-provider-lxd_v1.1.0_linux_amd64.zip"
  "https://github.com/sl1pm4t/terraform-provider-lxd/releases/download/v1.1.0/terraform-provider-lxd_v1.1.0_windows_amd64.zip"

# Retrieve zip
wget https://github.com/sl1pm4t/terraform-provider-lxd/releases/download/v1.1.0/terraform-provider-lxd_v1.1.0_linux_amd64.zip

# Unzip
unzip terraform-provider-lxd_*.zip

# Copy binary to a location where Terraform will find it
mkdir -p ~/.terraform.d/plugins
mv terraform-provider-lxd ~/.terraform.d/plugins

Building from source

  1. Follow these instructions to setup a Golang development environment.
  2. Use go get to pull down this repository and compile the binary:
go get -v -u github.com/sl1pm4t/terraform-provider-lxd

Documentation

Full documentation can be found in the docs directory.

Known Limitations

Many of the base LXD images don't include an SSH server, therefore terraform will be unable to execute any provisioners. Either use the base ubuntu images from the ubuntu or ubuntu-daily or manually prepare a base image that includes SSH.

Contributors

Some recognition for great contributors to this project: