add Terraform ADB module

Author: 吕戈

.gitignore

@@ -27,3 +27,4 @@ override.tf.json
 
 # Include tfplan files to ignore the plan output of command: terraform plan -out=tfplan
 # example: *tfplan*
+.idea

CHANGELOG.md

@@ -0,0 +1,2 @@
+- **NEW:** `adb` [GH-1]( https://github.com/terraform-alicloud-modules/terraform-alicloud-analyticdb-mysql/pull/1)
+

README-CN.md

@@ -0,0 +1,70 @@
+Terraform module which creates ADB cluster resources on Alibaba Cloud  
+terraform-alicloud-analyticdb-mysql
+=====================================================================
+
+
+本 Module 用于在阿里云的 VPC 下创建一个[ADB 云数据库](https://help.aliyun.com/product/92664.html)。
+
+本 Module 支持创建以下资源:
+
+* [ADB 数据库实例 (adb cluster)](https://www.terraform.io/docs/providers/alicloud/r/adb_cluster.html)
+
+## Terraform 版本
+
+本模版要求使用 Terraform 0.12 和阿里云 Provider 1.71.0+。
+
+## 用法
+-----
+### 你可以通过以下步骤增加terraform模板。
+
+增加module资源到你的模板文件，例如main.tf
+
+```hcl
+module "adb" {
+  source               = "terraform-alicloud-modules/adb/alicloud"
+  profile              = "Your-Profile-Name"
+  region               = "cn-shenzhen"
+  #################
+  # ADB Cluster
+  #################
+  db_cluster_version     = "3.0"
+  db_cluster_category    = "Cluster"
+  db_node_class          = "C8"
+  db_node_count          = 2
+  db_node_storage        = 200
+  pay_type               = "PostPaid"
+  vswitch_id             = "vsw-wz9dtqayzctoqh*******"
+  description            = "tf-module-adb"
+  availability_zone      = "cn-shenzhen-e"
+}
+```
+
+## 示例
+
+* [ADB实例创建示例](https://github.com/terraform-alicloud-modules/terraform-alicloud-analyticdb-mysql/tree/master/examples/complete)
+
+## 注意事项
+
+* 本 Module 使用的 AccessKey 和 SecretKey 可以直接从 `profile` 和 `shared_credentials_file` 中获取。如果未设置，可通过下载安装 [aliyun-cli](https://github.com/aliyun/aliyun-cli#installation) 后进行配置。
+
+提交问题
+-------
+如果在使用该 Terraform Module 的过程中有任何问题，可以直接创建一个 [Provider Issue](https://github.com/terraform-providers/terraform-provider-alicloud/issues/new)，我们将根据问题描述提供解决方案。
+
+**注意:** 不建议在该 Module 仓库中直接提交 Issue。
+
+作者
+-------
+Created and maintained by quanyun.
+
+许可
+----
+Apache 2 Licensed. See LICENSE for full details.
+
+参考
+---------
+* [Terraform-Provider-Alicloud Github](https://github.com/terraform-providers/terraform-provider-alicloud)
+* [Terraform-Provider-Alicloud Release](https://releases.hashicorp.com/terraform-provider-alicloud/)
+* [Terraform-Provider-Alicloud Docs](https://www.terraform.io/docs/providers/alicloud/index.html)
+
+

README.md

@@ -1,2 +1,72 @@
-# terraform-alicloud-analyticdb-mysql
-Terraform module for creating Analyticdb MySQL on Alibaba Cloud.
+Terraform module which creates a ADB cluster on Alibaba Cloud.  
+terraform-alicloud-analyticdb-mysql
+=====================================================================
+
+English | [简体中文](https://github.com/terraform-alicloud-modules/terraform-alicloud-analyticdb-mysql/blob/master/README-CN.md)
+
+Terraform module which creates ADB cluster resources on Alibaba Cloud
+
+These types of resources are supported:
+
+* [Alicloud adb cluster](https://www.terraform.io/docs/providers/alicloud/r/adb_cluster.html)
+
+----------------------
+
+## Terraform versions
+
+This module requires Terraform 0.12 and Terraform Provider AliCloud 1.71.0+.
+
+## Usage
+-----
+### You can use this in your terraform template with the following steps.
+
+Adding a module resource to your template, e.g. main.tf
+
+```hcl
+module "adb" {
+  source               = "terraform-alicloud-modules/adb/alicloud"
+  profile              = "Your-Profile-Name"
+  region               = "cn-shenzhen"
+  #################
+  # ADB Cluster
+  #################
+  db_cluster_version     = "3.0"
+  db_cluster_category    = "Cluster"
+  db_node_class          = "C8"
+  db_node_count          = 2
+  db_node_storage        = 200
+  pay_type               = "PostPaid"
+  vswitch_id             = "vsw-wz9dtqayzctoqh*******"
+  description            = "tf-module-adb"
+  availability_zone      = "cn-shenzhen-e"
+}
+```
+
+## Examples
+
+* [example](https://github.com/terraform-alicloud-modules/terraform-alicloud-analyticdb-mysql/tree/master/examples/complete)
+
+## Notes
+
+* This module using AccessKey and SecretKey are from `profile` and `shared_credentials_file`.
+If you have not set them yet, please install [aliyun-cli](https://github.com/aliyun/aliyun-cli#installation) and configure it.
+
+Submit Issues
+-------------
+If you have any problems when using this module, please opening a [provider issue](https://github.com/terraform-providers/terraform-provider-alicloud/issues/new) and let us know.
+
+**Note:** There does not recommend to open an issue on this repo.
+
+Authors
+---------
+Created and maintained by quanyun.
+
+License
+----
+Apache 2 Licensed. See LICENSE for full details.
+
+Reference
+---------
+* [Terraform-Provider-Alicloud Github](https://github.com/terraform-providers/terraform-provider-alicloud)
+* [Terraform-Provider-Alicloud Release](https://releases.hashicorp.com/terraform-provider-alicloud/)
+* [Terraform-Provider-Alicloud Docs](https://www.terraform.io/docs/providers/alicloud/index.html)

examples/complete/README.md

@@ -0,0 +1,16 @@
+# Complete ADB example
+
+Configuration in this directory creates set of ADB resources including ADB cluster
+
+## Usage
+
+To run this example you need to execute:
+
+```bash
+$ terraform init
+$ terraform plan
+$ terraform apply
+```
+
+Note that this example may create resources which cost money. Run `terraform destroy` when you don't need these resources.
+

examples/complete/main.tf

@@ -0,0 +1,40 @@
+variable "region" {
+  default = "cn-shenzhen"
+}
+
+variable "profile" {
+  default = "default"
+}
+
+provider "alicloud" {
+  region  = var.region
+  profile = var.profile
+}
+
+data "alicloud_zones" "default" {
+  available_resource_creation = "ADB"
+  enable_details              = true
+}
+
+data "alicloud_vpcs" "default" {
+  is_default = true
+}
+
+data "alicloud_vswitches" "default" {
+  vpc_id  = data.alicloud_vpcs.default.ids.0
+  zone_id = data.alicloud_zones.default.zones.0.id
+}
+
+module "adb_example" {
+  source                 = "../.."
+  region                 = var.region
+  description            = "tf-module-adb-cluster-example"
+  db_cluster_version     = "3.0"
+  db_cluster_category    = "Cluster"
+  db_node_class          = "C8"
+  db_node_count          = 2
+  db_node_storage        = 200
+  pay_type               = "PostPaid"
+  vswitch_id             = data.alicloud_vswitches.default.ids.0
+  availability_zone      = data.alicloud_zones.default.zones.0.id
+}

examples/complete/output.tf

@@ -0,0 +1,52 @@
+#################
+# ADB Cluster
+#################
+output "this_adb_cluster_id" {
+  description = "The ID of the ADB cluster."
+  value       = module.adb_example.this_adb_cluster_id
+}
+
+output "this_adb_description" {
+  description = "The description of ADB cluster."
+  value       = module.adb_example.this_adb_description
+}
+
+output "this_adb_cluster_zone_id" {
+  description = "The Zone to launch the ADB cluster."
+  value       = module.adb_example.this_adb_cluster_zone_id
+}
+
+output "this_adb_cluster_vswitch_id" {
+  description = "The virtual switch ID to launch ADB cluster in one VPC. "
+  value       = module.adb_example.this_adb_cluster_vswitch_id
+}
+
+output "this_adb_cluster_db_cluster_version" {
+  description = "The version of the ADB cluster."
+  value       = module.adb_example.this_adb_cluster_db_cluster_version
+}
+
+output "this_adb_cluster_db_cluster_category" {
+  description = "The catrgory type of the ADB cluster. "
+  value       = module.adb_example.this_adb_cluster_db_cluster_category
+}
+
+output "this_adb_cluster_db_node_count" {
+  description = "The node count of the ADB cluster."
+  value       = module.adb_example.this_adb_cluster_db_node_count
+}
+
+output "this_adb_cluster_db_node_class" {
+  description = "The node class of the ADB cluster. "
+  value       = module.adb_example.this_adb_cluster_db_node_class
+}
+
+output "this_adb_cluster_db_node_storage" {
+  description = "The node storage of the ADB cluster."
+  value       = module.adb_example.this_adb_cluster_db_node_storage
+}
+
+output "this_adb_cluster_pay_type" {
+  description = "The pay type"
+  value       = module.adb_example.this_adb_cluster_pay_type
+}

examples/complete/versions.tf

@@ -0,0 +1,4 @@
+
+terraform {
+  required_version = ">= 0.12"
+}

locals.tf

@@ -0,0 +1,4 @@
+locals {
+  # Get ID of ADB cluster
+  this_cluster_id = var.existing_cluster_id != "" ? var.existing_cluster_id : concat(alicloud_adb_cluster.this.*.id, [""])[0]
+}

main.tf

@@ -0,0 +1,21 @@
+provider "alicloud" {
+  profile                 = var.profile != "" ? var.profile : null
+  shared_credentials_file = var.shared_credentials_file != "" ? var.shared_credentials_file : null
+  region                  = var.region != "" ? var.region : null
+  skip_region_validation  = var.skip_region_validation
+  configuration_source    = "terraform-alicloud-modules/adb"
+}
+
+resource "alicloud_adb_cluster" "this" {
+  count                  = var.existing_cluster_id != "" ? 0 : var.create_cluster ? 1 : 0
+  description            = var.description
+  zone_id                = var.availability_zone
+  db_cluster_version     = var.db_cluster_version
+  db_cluster_category    = var.db_cluster_category
+  db_node_class          = var.db_node_class
+  db_node_count          = var.db_node_count
+  db_node_storage        = var.db_node_storage
+  pay_type               = var.pay_type
+  vswitch_id             = var.vswitch_id
+}
+