Skip to content

Terraform TiDB Cloud Provider: Manage TiDB Cloud configurations as code through HashiCorp Terraform

License

Notifications You must be signed in to change notification settings

tidbcloud/terraform-provider-tidbcloud

Repository files navigation

TiDB logo Terraform logo

Terraform TiDB Cloud Provider

License Release

This is the repository for the terraform-provider-tidbcloud, which allows one to use Terraform with TiDB Cloud. Learn more about TiDB Cloud

For general information about Terraform, visit the official website and the GitHub project page.

TOC

Requirements

  • Terraform >= 1.0
  • Go >= 1.18 (if you want to build the provider plugin)

Support

Resources

DataSource

Quick Start

Install terraform

Install terraform in Mac. See official doc for other OS.

brew tap hashicorp/tap
brew install hashicorp/tap/terraform

Run the serverless example

  1. In a terminal clone the terraform-provider-tidbcloud repository.
git clone [email protected]:tidbcloud/terraform-provider-tidbcloud.git
  1. Go to the examples/workflows/tidbcloud_serverless_cluster directory.
cd examples/workflows/tidbcloud_serverless_cluster
  1. The provider requires an API key set in an environment variable. Copy the API key from the TiDB Cloud console and create the environment variables.
export TIDBCLOUD_PUBLIC_KEY=fake_public_key
export TIDBCLOUD_PRIVATE_KEY=fake_private_key
  1. Rename the terraform.tfvars.templates to terraform.tfvars and change the variables as you wish. You can also pass them by environment variables.
export TF_VAR_password=fake_password
export TF_VAR_cluster_name=fake_cluster_name
  1. Execute the following commands to create a serverless tier
terraform init
terraform apply --auto-approve
  1. The example will output the connection_strings for you.
connection_strings = {
  "default_user" = "3ybfFe46ZdoSR3b.root"
  "standard" = {
    "host" = "gateway01.us-west-2.prod.aws.tidbcloud.com"
    "port" = 4000
  }
  "vpc_peering" = {
    "host" = ""
    "port" = 0
  }
}

The connection_strings will be generated after the cluster is available. If you find the output is empty, you can execute the terraform refersh to refresh the state of cluster.

User Guide

See TiDB Cloud Terraform Integration Overview for more details.

Developing the Provider

Environment

If you wish to work on the provider, you'll first need Go installed on your machine (see Requirements above).

Building the provider from source

  1. Clone the repository
git clone [email protected]:tidbcloud/terraform-provider-tidbcloud
  1. Enter the repository directory
cd terraform-provider-tidbcloud
  1. Build the provider using the Go install command. This will build the provider and put the provider binary in the $GOPATH/bin directory.
go install

Generate or update documentation in docs file

run go generate

Running the acceptance test

see here for more detail.

Debug the provider

I will introduce how to debug with Terraform CLI development overrides. About other ways to debug the provider, see terraform official doc for more detail

Development overrides is a method of using a specified local filesystem Terraform provider binary with Terraform CLI, such as one locally built with updated code, rather than a released binary.

  1. create .terraformrc in your operating system user directory
provider_installation {

  dev_overrides {
      "tidbcloud/tidbcloud" = "<put your $GOPATH/bin here>"
  }

  # For all other providers, install them directly from their origin provider
  # registries as normal. If you omit this, Terraform will _only_ use
  # the dev_overrides block, and so no other providers will be available.
  direct {}
}
  1. run go install in the terraform-provider-tidbcloud, you will find the terraform-provider-tidbcloud will be installed under the $GOPATH/bin
go install
  1. Terraform CLI commands, such as terraform apply, will now use the specified provider binary if you follow the below config:
terraform {
  required_providers {
    tidbcloud = {
      source = "tidbcloud/tidbcloud"
    }
  }
}

Follow us

Twitter @PingCAP

License

terraform-provider-tidbcloud is under the Apache 2.0 license. See the LICENSE file for details.