Terraform Module for Apache ShardingSphere-Proxy Cluster

A terraform module to create an Apache ShardingSphere Proxy Cluster on AWS.

Terraform will create a cluster with the following architecture:

Prerequisites

• Terraform CLI
• AWS Resource
  • AK/SK for accessing AWS API
  • A internal domain name, default is shardingsphere.org
  • A list of Subnet IDs to launch the instance(s)
  • A SecurityGroup which allow ports 2888, 3888, and 2181 of the zookeeper server to pass through.
  • A ssh keypair

Usage

Step1: Edit main.tf

terraform {
  required_providers {
    aws = {
      source  = "hashicorp/aws"
      version = "4.37.0"
    }
  }
}

provider "aws" {
  region     = "ap-southeast-1"
}

module "zk" {
  source              = "./modules/zk"
  cluster_size        = 3
  key_name            = "test-tf"
  instance_type       = "t2.nano"
  vpc_id              = "vpc-0ef2b7440d3ade8d5"
  subnet_ids          = ["subnet-0f388a6f23063b8c9", "subnet-0bc2cd85facb5ca06", "subnet-009077567350ef1b7"]
  security_groups     = ["sg-008e74936b3f9de19"]
}

module "shardingsphere" {
  depends_on             = [module.zk]
  source                 = "./modules/shardingsphere"
  cluster_size           = 3
  shardingsphere_version = "5.2.1"
  key_name               = "test-tf"
  image_id               = "ami-094bbd9e922dc515d"
  instance_type          = "t3.medium"
  lb_listener_port       = 3307
  vpc_id                 = "vpc-0ef2b7440d3ade8d5"
  subnet_ids             = ["subnet-0f388a6f23063b8c9", "subnet-0bc2cd85facb5ca06", "subnet-009077567350ef1b7"]
  security_groups     = ["sg-008e74936b3f9de19"]
  zk_servers             = module.zk.zk_node_domain
}

Step2: Set environments for AK/SK

export AWS_ACCESS_KEY_ID="accesskey"
export AWS_SECRET_ACCESS_KEY="secretkey"

Step3: Initial Terraform working directory

terrafrom init

Step4: Run the command terraform plan to generates a execution plan. Step5: Run the command terraform apply to crates your defined infrastructure.

By default, Terraform will create a domain proxy.[ZONE NAME] is used by other services.

If you want to delete, you can run the command terraform destroy, Terraform will destroy your defined infrastructure.

Modules

Requirements

Modules

Outputs

ZK

Resources

Inputs

Outputs

shardingsphere

Resources

Inputs

Outputs