terraform-provider-linode

A plugin for adding a Linode provider.

Description

This is a custom plugin providing a Linode provider for Terraform. This is still a work in progress. It currently only supports managing Linodes currently. In the future dns and nodebalancers will be added. It only supports a subset of the various options that Linode offers. In particular none of the alerting options are supported. They should be easy to add but will likely be tedious.

Requirements

• terraform

Installation

1. Download the plugin from the releases tab
2. Put it somewhere were it can permanently live, it doesn't need to be in your path.
3. Create or modify your ~/.terraformrc file. You'll need at least this:

providers {
    linode = "terraform-provider-linode"
}

If you didn't add terraform-provider-linode to your path, you'll need to put the full path to the location of the plugin.

Usage

Provider Configuration

linode

provider "linode" {
  key = "$LINODE_API_KEY"
}

The provider options are:

• key - (Required) This is your linode api key. It will be read out of the environment variable LINODE_API_KEY.

Resource Configuration

linode_linode

resource "linode_linode" "foobar" {
	image = "Ubuntu 14.04 LTS"
	kernel = "Latest 64 bit"
	name = "foobaz"
	group = "integration"
	region = "Dallas, TX, USA"
	size = 2048
	status = "on"
	swap_size = 256
	ip_address = "8.8.8.8"
	plan_storage = 24576
	plan_storage_utilized = 24576
	private_networking = true
	private_ip_address = "192.168.10.50"
	ssh_key = "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAACAQCxtdizvJzTT38y2oXuoLUXbLUf9V0Jy9KsM0bgIvjUCSEbuLWCXKnWqgBmkv7iTKGZg3fx6JA10hiufdGHD7at5YaRUitGP2mvC2I68AYNZmLCGXh0hYMrrUB01OEXHaYhpSmXIBc9zUdTreL5CvYe3PAYzuBA0/lGFTnNsHosSd+suA4xfJWMr/Fr4/uxrpcy8N8BE16pm4kci5tcMh6rGUGtDEj6aE9k8OI4SRmSZJsNElsu/Z/K4zqCpkW/U06vOnRrE98j3NE07nxVOTqdAMZqopFiMP0MXWvd6XyS2/uKU+COLLc0+hVsgj+dVMTWfy8wZ58OJDsIKk/cI/7yF+GZz89Js+qYx7u9mNhpEgD4UrcRHpitlRgVhA8p6R4oBqb0m/rpKBd2BAFdcty3GIP9CWsARtsCbN6YDLJ1JN3xI34jSGC1ROktVHg27bEEiT5A75w3WJl96BlSo5zJsIZDTWlaqnr26YxNHba4ILdVLKigQtQpf8WFsnB9YzmDdb9K3w9szf5lAkb/SFXw+e+yPS9habkpOncL0oCsgag5wUGCEmZ7wpiY8QgARhuwsQUkxv1aUi/Nn7b7sAkKSkxtBI3LBXZ+vcUxZTH0ut4pe9rbrEed3ktAOF5FafjA1VtarPqqZ+g46xVO9llgpXcl3rVglFtXzTcUy09hGw== btobolaski@Brendans-MacBook-Pro.local"
	root_password = "terraform-test"
}

value	Type	Forces New	Value Type	Description
image	Required	yes	string	The image to use when creating the linode. This can also be an ImageID 1
kernel	Required	no	string	The kernel to start the linode with. If you can specify "Latest 64-bit" or "Latest 32-bit" for the most recent version of either that linode provices
name	Optional	no	string	The name of the linode
group	Optional	no	string	The group of the linode
region	Required	yes	string	The region that the linode will be created in
size	Required	no	int	The amount of ram in the linode plan. i.e. 2048, 4096, or 8192
ip_address	Computed	n/a	string	The public ip address
private_networking	Optional	sort of	bool	Whether or not to enable private networking. It can be enabled on an existing linode but it can't be disabled.
private_ip_address	Computed	n/a	string	If private networking is enabled, it will be populated with the linode's private ip address
ssh_key	Required	yes	string	The full text of the public key to add to the root user
root_password	Required	yes	string	Unfortunately this is required by the linode api. You'll likely want to modify this on the server during provisioning (which won't force a new linode) and then disable password logins for ssh.
helper_distro	Optional	no	bool	Enable the Distro filesystem helper. Corrects fstab and inittab/upstart entries depending on the kernel you're booting. You want this unless you're providing your own kernel.
manage_private_ip_automatically	Optional	no	bool	Automatically creates network configuration files for your distro and places them into your filesystem. Will reboot your linode when enabled.
disk_expansion	Optional	no	bool	Setting this to true to true will automatically expand the root volume if the size of the linode plan is increased. Setting this value will prevent downsizing without manually shrinking the volume prior to decreasing the size.
plan_storage	Computed	n/a	int	The size of the Linode plans storage capacity in MB
plan_storage_utilized	Computed	n/a	int	The sum of the size of all the Linode's disks
swap_size	Optional	no	int	Sets the size of the swap partition on a Linode in MB. At this time, this cannot be modified by Terraform after initial provisioning. If manually modified via the Web GUI, this value will reflect such modification. This value can be set to 0 to create a Linode without a swap partition. Defaults to 256.

Contributing

1. Fork the repo
2. Use godep to get the correct versions of the dependencies
3. Make your changes
4. Apply go fmt to all of the files
5. Verify that the tests still pass (cd ${PROJECT_ROOT} and go test -v --timeout 20m)
6. Submit a pull request

Footnotes

1. While these technically could be modified, it requires destroying the root volume and creating a new volume which is practically the same as creating a new instance. ↩