terraform-provider-quantum

README

terraform-provider-quantum

A custom provider for terraform.

Installation

1. Download the latest release for your platform
2. rename the file to terraform-provider-quantum
3. Copy the file to the same directory as terraform dirname $(which terraform) is installed

Usage

quantum_list_files

Example Usage

Returns a list of files from a directory

data "quantum_list_files" "data_files" {
  folders   = ["./data"]
  patterns  = ["*.txt", "*.doc*"]
  recursive = true
}

The output will look like this:

data.quantum_list_files.data_files.files = ["./data/file1.txt", "./data/file2.docx"]

Argument Reference

• folders - (Optional) - The source list for folders
• patterns - (Optional) - The patterns to match files, uses golang's filepath.Match
• recursive - (Optional) - Default false, walk directory recursively

Attributes Reference

• files - The list of matched files

quantum_password

This resource will generate a password with lowercase, uppercase, numbers and special characters mathing the specified length. It will also rotate the password every 'n' days based on the rotation attribute.

Example Usage

Generates a random password to be used by other resources

resource "quantum_password" "rds_backup_db_password" {
    length   = 10
    rotation = 90
}

Argument Reference

• length - (Optional) - Password length [default 20]
• rotation - (Optional) - Number of days before a new password gets generated. [default 0 = no rotation]

A rotation set to negative number means the password expires on each run

Attributes Reference

• password - Attribute to use in your other resources to set the password
• last_update - Last generation date of the password

Note that on quantum_password attribute change, you need to run apply twice to get the new password propagated to dependant resources. (Comment on this behavior)

Develop

go get github.com/coveo/terraform-provider-quantum
cd $GOPATH/src/github.com/coveo/terraform-provider-quantum
go get ./...
$EDITOR .