Terraform Provider Redis Cloud

The Redis Enterprise Cloud Terraform provider is a plugin for Terraform that allows Redis Enterprise Cloud Flexible customers to manage the full lifecyle of their subscriptions and related Redis databases.

Requirements

• Terraform >= 0.12.x
• Go >= 1.15

Quick Starts

• Using the provider

To use the Redis Enterprise Cloud Terraform provider you will need to set the following environment variables, and these are created through the Redis Enterprise Cloud console under the settings menu.

• REDISCLOUD_ACCESS_KEY - Account Cloud API Access Key
• REDISCLOUD_SECRET_KEY - Individual user Cloud API Secret Key

Developing the Provider

If you wish to work on the provider, you'll first need Go installed on your machine (see Requirements above). You will also need to create or have access to a Redis Cloud Enterprise account.

Building the Provider

1. Clone the repository
2. Enter the repository directory
3. Build the provider using the make build command:

$ make build

The make build command will build a local provider binary into a bin directory at the root of the repository.

Installing the Provider

After the provider has been built locally it must be placed in the user plugins directory so it can be discovered by the Terraform CLI. The default user plugins directory root is ~/.terraform.d/plugins.

Use the following make command to install the provider locally.

$ make install_local

The provider will now be installed in the following location ready to be used by Terraform

~/.terraform.d/plugins
└── registry.terraform.io
    └── RedisLabs
        └── rediscloud
            └── 99.99.99
                └── <OS>_<ARCH>
                    └── terraform-provider-rediscloud_v99.99.99

The provider binary is built using a version number of 99.99.99 and this will allow terraform to use the locally built provider over a released version.

The terraform provider is installed and can now be discovered by Terraform through the following HCL block.

terraform {
  required_providers {
    rediscloud = {
      source = "RedisLabs/rediscloud"
    }
  }
  required_version = ">= 0.13"
}

The following is an example of using the rediscloud_regions data-source to discover a list of supported regions. It can be used to verify that the provider is setup and installed correctly without incurring the cost of subscriptions and databases.

data "rediscloud_regions" "example" {
}

output "all_regions" {
  value = data.rediscloud_regions.example.regions
}

Testing the Provider

In order to run the full suite of Acceptance tests, run make testacc.

Note: Acceptance tests create real resources, and often cost money to run.

$ make testacc

In order to run an individual acceptance test, the '-run' flag can be used together with a regular expression. The following example uses a regular expression matching single test called 'TestAccResourceRedisCloudSubscription_createWithDatabase'.

$ make testacc TESTARGS='-run=TestAccResourceRedisCloudSubscription_createWithDatabase'

In order to run the tests with extra debugging context, prefix the make command with TF_LOG (see the terraform documentation for details).

$ TF_LOG=trace make testacc

By default, the tests run with a parallelism of 3. This can be reduced if some tests are failing due to network-related issues, or increased if possible, to reduce the running time of the tests. Prefix the make command with TEST_PARALLELISM, as in the following example, to configure this.

$ TEST_PARALLELISM=2 make testacc

A core set of Acceptance tests are executed through the build pipeline, (considered short tests).
Functionality that requires additional setup or environment variables can be executed using the following flags.

Adding Dependencies

This provider uses Go modules. Please see the Go documentation for the most up to date information about using Go modules.

To add a new dependency github.com/author/dependency to your Terraform provider:

go get github.com/author/dependency
go mod tidy

Then commit the changes to go.mod and go.sum.